developing

zlliang's avatarfrom zlliang

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.

⭐3stars🔀0forks📁View on GitHub🕐Updated Jan 11, 2026

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.
namedeveloping
descriptionGuides 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

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 @/* for src/* imports within each site
  • Components: Use PascalCase for .astro files
  • 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-es and date-fns for utilities
  • Custom rehype plugins go in src/utils/rehype.ts on each site
  • Always verify production builds