developing
Guides development of the Astro-based personal websites in this monorepo. Use when building features, fixing bugs, or running dev and build commands for `www`, `tech`, or `days` sites.
When & Why to Use This Skill
This Claude skill acts as a specialized AI development partner for managing Astro-based monorepos. It optimizes the web development lifecycle by providing instant access to project-specific tech stacks (Tailwind CSS, TypeScript, pnpm), directory structures, and deployment workflows. It solves the complexity of context-switching between multiple sites in a monorepo, ensuring consistent coding standards and efficient command execution.
Use Cases
- Feature Development: Streamline the creation of new components and pages across different sub-sites (www, tech, days) while adhering to Astro's best practices and project-specific path aliases.
- Monorepo Command Orchestration: Quickly trigger the correct pnpm scripts for development, building, or dependency management without manually referencing documentation.
- Bug Fixing & Debugging: Identify and resolve issues within the TypeScript and Tailwind CSS environment, ensuring custom rehype plugins and global styles function correctly.
- Content Authoring & Version Control: Maintain organized content structures and follow 'Conventional Commits' standards for documentation and blog updates automatically.
| name | developing |
|---|---|
| description | Guides development of the Astro-based personal websites in this monorepo. Use when building features, fixing bugs, or running dev and build commands for `www`, `tech`, or `days` sites. |
Developing
Tech stack
- Framework: Astro (Astro's llms.txt)
- Styling: Tailwind CSS
- Icons: Iconify
- Language: TypeScript
- Package manager: pnpm
- Deployment: Vercel
Monorepo structure
This repository contains three Astro websites:
websites/
├── www/ # zlliang.me – Personal landing page (English and Chinese, with [Astro's i18n support](https://docs.astro.build/guides/internationalization/))
├── tech/ # tech.zlliang.me – Tech learning and research (English)
└── days/ # days.zlliang.me – Daily life and reflections (Chinese)
Commands
From the repository root:
pnpm install # Install all dependencies
pnpm run www:dev # Start www dev server, on port 3001
pnpm run tech:dev # Start tech dev server, on port 3002
pnpm run days:dev # Start days dev server, on port 3003
pnpm run www:build # Build www for production
pnpm run tech:build # Build tech for production
pnpm run days:build # Build days for production
Conventions
- Path alias: Use
@/*forsrc/*imports within each site - Components: Use PascalCase for
.astrofiles - Content: Organized by
[year]/[month]/[day]/[slug].md - Styling: Tailwind utilities; global styles in
src/styles/main.css - Git commits: Follow Conventional Commits; for content authoring, use
docs:type with the relevant title in the message
Misc
- Use
lodash-esanddate-fnsfor utilities - Custom rehype plugins go in
src/utils/rehype.tson each site - Always verify production builds