This is an Astro 6.x SSG-first agency/small-business theme. It provides a component system, design token architecture, content collections, and a validation pipeline suitable for building production informational and marketing websites.
Supported Site Archetypes
The theme is designed to support the following site types (REQ-00001 through REQ-00004):
- Small business informational — brochure-style sites presenting services, team, contact, and about content for a single business location.
- Multi-service businesses — companies with multiple distinct offerings or service lines, each needing their own landing or detail pages.
- Multi-location / multi-site businesses — businesses operating across multiple offices or geographic locations. Each location may have its own pages or sub-sections.
- Content-driven marketing and editorial — sites centered on articles, blog posts, or editorial content alongside marketing pages. The content collections system supports this pattern natively.
Scope Boundaries
Authentication (REQ-00005)
Simple authenticated or member-only sections (e.g., a gated resource page) may be supported on a case-by-case basis using hybrid rendering. Highly app-like authenticated product experiences — dashboards, user account management, real-time collaboration — are out of scope for the v1 baseline and should not be built on this theme.
Internationalization (REQ-00006)
Internationalization (i18n) is not required for the initial release. However, the architecture must not structurally preclude it: avoid hardcoded locale-specific strings in CORE-OWNED components, use CSS logical properties, and do not assume left-to-right text direction in layout logic. Astro’s built-in i18n routing can be layered on in a future release.
Technology Choices
- Framework: Astro 6.x, SSG-first with hybrid rendering for forms and API routes
- Interactivity: Vanilla TypeScript for interactive islands — zero-JS by default
- Styling: Tailwind CSS v4 with a three-layer design token system (
--pt-*→--st-*→ Tailwind@theme) - Ownership model:
CORE-OWNED(theme framework) vsSITE-OWNED(per-site customization)