Skip to content

Getting Started

Rod Christiansen edited this page Oct 8, 2026 · 3 revisions

Getting Started

The shortest path from a clone to the site running on your machine.

Prerequisites

Node.js 20 and npm. That is the version the deploy workflow pins, so it is the version to develop against. There is no other toolchain — no Python, no Docker, no database.

Run it

Clone and install:

git clone https://github.com/reportmate/reportmate-website.git
npm install

Start the dev server:

npm run dev

Astro prints the local URL it is serving on. Edits to anything under src/ hot-reload in the browser.

Scripts

Every script defined in package.json:

Script What it does
npm run dev Astro dev server with hot reload
npm start Alias for dev
npm run build Static build into dist/
npm run preview Serve the built dist/ locally
npm run astro Pass arbitrary arguments to the Astro CLI

Check a production build

The dev server renders pages on request; the deploy publishes the static output of npm run build. Before opening a pull request that touches layout, metadata or links, build and preview the static output:

npm run build
npm run preview

Where to go next

Clone this wiki locally