astro-sites

Orchestrate multiple Astro sites in a monorepo behind a shared nginx container.

Updated Aug 27, 2026
One-click install
npx skills add https://github.com/brentwpeterson/claude-commands --skill astro-sites
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: astro-sites
Source: https://github.com/brentwpeterson/claude-commands/tree/main/skills/astro-sites
Command: npx skills add https://github.com/brentwpeterson/claude-commands --skill astro-sites

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This Skill consolidates management and deployment of multiple Astro sites from a single monorepo, routing them through one shared nginx container to simplify hosting, updates, and operations.

Core Features & Use Cases

  • Multi-site Astro monorepo hosted on AWS ECS with a single nginx container.
  • Per-site local development ports and hostname-based routing via ALB and Route53.
  • HubSpot embedded forms per site and optional SES email verification per domain.
  • Simple onboarding for new sites by adding a folder, configuring site settings, and updating deployment scripts.
  • Production deployment workflow: push to master, tag per-site versions, and build all sites into the shared container.

Quick Start

Start a specific site in development by navigating to its folder and running the dev server.

  • cd astro-sites/brent-run

  • npm run dev This opens at http://localhost:3010

  • cd astro-sites/requestdesk-ai

  • npm run dev This opens at http://localhost:3003

Frequently Asked Questions about astro-sites

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I host multiple Astro sites in a monorepo behind a single nginx container?

You can host multiple Astro sites in a monorepo by configuring a shared nginx container with per-site domain routing, port mappings, and hostname-based routing via AWS ALB and Route53. This consolidates management and deployment into a single container.

Can I run local development servers for multiple Astro sites on different ports?

Yes, you can run local development servers for multiple Astro sites on different ports. Each site in the monorepo is assigned a specific local development port, such as 3010 for one site and 3003 for another, allowing simultaneous local development.

What is the best way to deploy a multi-site Astro monorepo to AWS ECS?

The best way to deploy a multi-site Astro monorepo to AWS ECS is to push to master, tag per-site versions, and build all sites into the shared nginx container. This workflow uses ALB, Route53, and ACM for scalable AWS-backed hosting.

Does this multi-site Astro deployment approach support per-site custom domains and SSL?

Yes, this multi-site Astro deployment supports per-site custom domains and SSL by using AWS Route53 for DNS routing and ACM for certificate management. Hostname-based routing via ALB directs traffic to the correct site within the shared nginx container.

How do I onboard a new Astro site into an existing multi-site monorepo deployment?

To onboard a new Astro site into the monorepo deployment, add a new folder for the site, configure its specific site settings including local development ports and domain routing, and update the deployment scripts to include it in the shared nginx container build.

Can I integrate HubSpot forms and SES email verification across multiple Astro sites?

Yes, you can integrate HubSpot embedded forms per site and optionally configure SES email verification per domain. This allows each site in the multi-site Astro monorepo to handle form submissions and domain-specific email verification independently.