Built with Astro, Tailwind CSS, and React. Editorial pages use a hand-coded component system; documentation lives under src/content/docs/ and is powered by Starlight.

Commands

Command	Action
`npm install`	Install dependencies
`npm run dev`	Start local dev server at `localhost:4321`
`npm run build`	Build production site to `./dist/`
`npm run preview`	Preview production build locally
`npm run check`	Auto-fix formatting with Biome
`npm run ci`	Biome lint check (CI — no auto-fix)

Pre-commit Hooks

The project uses Lefthook to run pre-commit hooks. The hooks are defined in the .lefthook.yml file.

To install the hooks, use the following command (npm install is required):

npx lefthook install

To run the hooks manually, use the following command:

npx lefthook run pre-commit

Project Structure

/
├── public/                   Static assets (fonts, favicons)
├── src/
│   ├── assets/               SVGs, images, gem PNGs
│   ├── components/           Astro & React components
│   ├── content/docs/         Starlight documentation (Markdown/MDX)
│   ├── data/                 JSON data files — edit these to update content
│   ├── i18n/                 Translation keys for the home page
│   ├── layouts/              Page-level layout wrappers
│   ├── pages/                URL routes (en = root, es/, ja/)
│   └── styles/               Global CSS and Tailwind theme tokens
├── biome.jsonc               Linter/formatter config (Biome 2.4)
└── astro.config.mjs          Astro config (i18n, integrations)

Localization

The site supports three locales: English (root /), Spanish (/es/), and Japanese (/ja/). Each editorial page has a dedicated component per locale — e.g. XahauAbout.astro, XahauAboutEs.astro, XahauAboutJa.astro — with a thin .astro page wrapper in src/pages/ for each. To add a new language, follow the steps in ADDING-A-LOCALE.md.

Updating Content

Most editorial page content is stored in JSON files under src/data/. Edit the JSON to change what's rendered — no component code changes needed. See DEVELOPMENT.md for the full schema of each file.

File	Controls
`src/data/home.json`	Statistics tiles on the home page
`src/data/about.json`	All copy and section structure on the About page
`src/data/features.json`	Feature cards and body copy on the Features page
`src/data/connect.json`	Events list on the Connect page
`src/data/roadmap.json`	Roadmap items and quarter window
`src/data/ecosystem.json`	Ecosystem project list

README.md

Xahau Website

Commands

Pre-commit Hooks

Project Structure

Localization

Updating Content

Further Reading