Setup

Local setup

Follow these four steps once per computer. When you see the site at localhost:4321, you are ready to edit config files and content.

1. Prepare requirements

You need a recent Node.js and npm. Git is recommended to clone the repository; Wrangler CLI is only needed later when you deploy to Cloudflare.

  • Node.js version 22.12.0 or newer — check with: node -v
  • npm (comes with Node.js) — check with: npm -v
  • Git — optional for clone; download from git-scm.com if needed
  • Wrangler CLI — only for deploy later: npm install -g wrangler

2. Get the project on your machine

Clone the repository with Git, or download and unzip the project folder. Then open a terminal in that folder — all following commands run from the project root.


                git clone <your-repo-url>
cd fixrav-starter
              

3. Run install

Install dependencies once after cloning or after pulling big dependency changes. This may take a minute.


                npm install
              

4. Open the site locally

Start the development server. Leave this terminal window open while you work. Open the URL below in your browser.


                npm run dev
              
  • Site: http://localhost:4321
  • CMS (local): http://localhost:4321/keystatic — content is stored on your machine in dev mode
  • Stop the server: Ctrl+C in the terminal

If something fails

Wrong Node version: install Node 22.12+ from nodejs.org and run node -v again. Port 4321 in use: stop the other process or restart the terminal. Install errors: delete node_modules and package-lock.json, then run npm install again.