Prerequisites
Node.js 18+
Download from nodejs.org. Version 18 or higher is required.
npm
Included with Node.js. Used to install dependencies and run scripts.
Git
Download from git-scm.com. Used to clone the repository.
Get started
Install dependencies
Start the development server
Astro’s default dev server port is 4321. If that port is in use, Astro will pick the next available port and print the actual URL to the terminal.
Other commands
Build for production
Run a full TypeScript type check and then build optimized static output:Preview the production build
After building, serve the output locally to verify it looks correct before deploying:Run tests
Project layout
| Directory | Purpose |
|---|---|
src/components/ | React (.jsx) and Astro (.astro) UI components |
src/layouts/ | Shared page wrapper layouts |
src/pages/ | File-based routes — each .astro file becomes a URL |
src/styles/ | Global CSS loaded site-wide |
src/test/ | Vitest setup and helpers |
src/Icons/ | SVG icon assets |