By the end of this guide you will have the full Borrissol site running locally atDocumentation Index
Fetch the complete documentation index at: https://mintlify.com/constanza101/borrissol/llms.txt
Use this file to discover all available pages before exploring further.
http://localhost:4321, all four language variants accessible in your browser, and the Keystatic CMS panel open at /keystatic — no authentication needed in development mode.
Prerequisites
- Node ≥ 22.12.0 — required by Astro 6. Check with
node -v. Install via nvm or the official Node.js installer. - npm — bundled with Node.js; no separate install needed.
Setup steps
Install dependencies
The repo ships an
.npmrc file containing legacy-peer-deps=true. This flag is required because @keystatic/astro@5.0.6 declares a peer dependency of astro@2-5, but this project runs Astro 6. Without it, npm install will exit with an unresolvable peer-dependency error. Do not delete .npmrc until Keystatic publishes official Astro 6 support — see the note at the bottom of this page for details.Start the dev server
Browse all four language variants
Open your browser and visit each locale:
All four variants are served from the same
| URL | Language |
|---|---|
http://localhost:4321/ | Catalan (default — no URL prefix) |
http://localhost:4321/es | Spanish |
http://localhost:4321/en | English |
http://localhost:4321/fr | French |
[lang]/index.astro dynamic route via getStaticPaths. Only the Catalan home page lives at the root — it has no /ca/ prefix.Access the CMS panel
Navigate to
http://localhost:4321/keystatic.In local development, Keystatic runs without authentication. You can create and edit blog posts directly; changes are written as MDX files to src/content/blog/ in the repository. In production, access is restricted via Keystatic Cloud credentials.Commands reference
| Command | Description |
|---|---|
npm run dev | Start the dev server on http://localhost:4321 |
npm run build | Build the production site to ./dist |
npm run preview | Serve the production build locally for inspection |
npm run test | Run Vitest unit tests (run-once mode) |
npm run test:watch | Run Vitest in watch mode |
npm run test:e2e | Build the site, then run Playwright E2E tests |
npm run test:e2e:ui | Build the site, then open the Playwright UI runner |
npm run test:e2e:report | Open the last Playwright HTML report |
Notes
About .npmrc and legacy-peer-deps
The .npmrc file at the repo root contains a single line:
@keystatic/astro@5.0.6 declares astro@2-5 as its peer dependency, but Borrissol runs on Astro 6. The legacy-peer-deps flag tells npm to fall back to the pre-npm-7 peer-resolution algorithm, which treats the peer dependency as advisory rather than blocking. Do not delete this file until Keystatic publishes a release that explicitly supports Astro 6 — removing it will break npm install for everyone working on the project.