Astro Starter

Personal starter for future Astro projects

Stack

Astro

Tailwind CSS

DaisyUI

TypeScript

Biome

pnpm

Configuration

All site-wide settings (name, description, nav links, footer groups, social links, business info, OG image) live in src/config/branding.config.ts. Edit that file to rebrand the starter.

Deploy

The site deploys to GitHub Pages via the CI workflow on every push to master. The live demo is at kystrel.github.io/astro-starter.

Project Structure

/
├── public/
│   ├── favicon.ico
│   └── favicon.svg
├── src/
│   ├── assets/
│   │   └── *.jpg
│   ├── components/
│   │   ├── BaseHead.astro
│   │   ├── Contact.astro
│   │   ├── Footer.astro
│   │   ├── Header.astro
│   │   ├── Hero.astro
│   │   ├── Offerings.astro
│   │   ├── Reviews.astro
│   │   └── Story.astro
│   ├── config/
│   │   └── branding.config.ts
│   ├── layouts/
│   │   └── Layout.astro
│   ├── pages/
│   │   ├── 404.astro
│   │   ├── index.astro
│   │   └── robots.txt.ts
│   └── styles/
│       └── global.css
└── package.json

Commands

All commands are run from the root of the project, from a terminal:

Command	Action
pnpm install	Installs dependencies
pnpm dev	Starts local dev server at localhost:4321
pnpm build	Build your production site to ./dist/
pnpm preview	Preview your build locally
pnpm check	Run TypeScript and Astro diagnostics
pnpm lint	Lint with Biome (read-only)
pnpm lint:fix	Lint and auto-fix with Biome
pnpm format	Auto-format entire repo with Biome