Getting Started
Requirements
- Node.js 22+ — check with
node -v. The exact version is pinned in the.node-versionfile included with every template. - npm (ships with Node).
- No database, no CMS, no
.envfile — content is files.
Install and run
npm install
npm run dev # → http://localhost:4321
npm run build # production build → dist/
npm run preview # preview the built site locally
That’s it. The dev server starts with hot reload — every file change is reflected instantly.
What you get
Every template ships as a complete Astro project:
- All pages, layouts and components
- Content collections with realistic demo content (not lorem ipsum)
- Design tokens and theme configuration
- Self-hosted fonts (no external requests)
- SEO setup: meta tags, Open Graph, schema.org structured data
- Deployment configs for Cloudflare Pages and Netlify
- Full documentation in
docs/README.md
Project structure
src/
├── lib/site.ts ← Business info, hours, contact
├── i18n/en.json ← All visible text
├── content/ ← Content collections (menu, FAQ, etc.)
├── styles/global.css ← Colors & fonts (:root block)
├── components/ ← Template components
├── layouts/ ← Page layouts
└── pages/ ← Routes
Troubleshooting first run
| Symptom | Fix |
|---|---|
EBADENGINE error |
Install Node 22+: nvm install 22 && nvm use 22 |
ERESOLVE peer conflict |
npm install --legacy-peer-deps |
| Port 4321 in use | npm run dev -- --port 3000 |
Cannot find @studio/core |
core/ folder missing — re-extract zip or re-clone |
Next step
Head to Make It Yours to customize the template in 15 minutes.