Astro Hello World Copier Template

A modern, minimal Astro 5 project template scaffolded with Copier. Perfect for developers new to Copier or looking for a well-configured Astro + TypeScript starter.

Features: Strict TypeScript, Vitest testing, Prettier formatting, CI/CD workflows, DevContainer support, and zero manual setup—everything runs automatically after generation.

Quick Start

Prerequisites

• Python 3.13+ (required for Copier template tooling)
• Node.js 22.12.0+ (required for generated Astro projects)

Generate Your Project

Option A: Using uvx (Recommended)

Install uv first, then:

uvx copier copy --trust https://github.com/your-org/templates /path/to/output
cd /path/to/output/my-astro-app  # or your chosen project name
npm run dev

Option B: Using pipx (Alternative)

If you prefer pipx:

pipx run copier copy --trust https://github.com/your-org/templates /path/to/output
cd /path/to/output/my-astro-app
npm run dev

Tip

The --trust flag is required because this template uses post-render tasks (automated setup). See Copier docs for details.

After Generation

Copier automatically:

• ✓ Initializes a git repository
• ✓ Installs npm dependencies
• ✓ Creates an initial commit

You're ready to start coding immediately:

npm run dev          # Start dev server (Astro)
npm run type-check   # Type checking with astro check
npm test             # Run tests (Vitest)
npm run format       # Auto-format code with Prettier
npm run build        # Production build
npm run pre-commit   # Run all checks before committing

Visit http://localhost:3000 to see your project.

Customization Tips

Add a New Page

Create a new .astro file in src/pages/:

---
// src/pages/about.astro
---

<h1>About Me</h1>
<p>Welcome to my Astro site.</p>

Astro automatically creates routes based on file names. See the Astro routing guide.

Deploy Your Project

Astro deploys seamlessly to Netlify, Vercel, GitHub Pages, and more. See the Astro deployment guide for detailed instructions.

Learn More

• Astro Documentation
• Copier Documentation
• TypeScript Handbook
• Vitest Guide