Personal website built with Astro 5, featuring View Transitions and a robust component architecture.
🌐 Live Site: aaronqian.com
- 🚀 Astro 5 - Modern static site generation with View Transitions
- ⚡ Vanilla JavaScript - Zero React/framework overhead, just TypeScript
- ☁️ Cloudflare Workers - Automated CI/CD deployment pipeline
- 🎨 Tailwind CSS v4 - Utility-first styling with custom design tokens
- 🧩 Modular Architecture - CVA variants, layout primitives, type-safe components
- ✅ Type-Safe - Full TypeScript coverage with strict mode
- 🧪 Comprehensive Testing - Vitest + Testing Library with high coverage standards
Prerequisites: Node.js 22.20.0+
npm install
npm run devVisit http://localhost:4321 to see your site.
| Command | Action |
|---|---|
npm install |
Install dependencies |
npm run dev |
Start dev server at localhost:4321 |
npm run preview |
Preview production build locally |
npm run autofix |
Auto-fix formatting and linting |
npm run ci |
Run full CI pipeline |
Deployed to Cloudflare Workers via automated CI/CD pipeline on push to
main.
Architecture patterns and development guidelines:
- AGENTS.md - Core architectural rules and mandatory compliance
- docs/components.md - Component patterns and organization
- docs/styling.md - Styling philosophy and design tokens
- docs/hooks.md - Hook patterns and View Transitions
- docs/testing.md - Testing requirements and best practices
- docs/git-workflow.md - Git workflow and CI/CD pipeline
- docs/finding-examples.md - Guide to finding examples in codebase
- docs/troubleshooting.md - Common issues and solutions
MIT