Platform Overview

Current Baseline

• Two Astro applications under a shared pnpm workspace (apps/site, apps/docs).
• Docker container provides Node, pnpm, and consistent environment parity.
• Diagrams render client-side using Mermaid and D2 libraries—no native binaries required.

Deployment Strategy

• Cloudflare Pages will host both applications as static sites.
• Cloudflare Access will protect the documentation surface before any public release.
• Workers remain deferred pending concrete backend requirements.

Responsibilities by Area

• Marketing Platform — Owns content, design system, and release cadence. See Marketing architecture.
• Documentation Platform — Maintains ADRs, security guidance, and operational policy.
• Operations — Manages Docker, pnpm, and Pages pipelines; refer to Ops hub.

Key References

• Repo Structure
• Version Policy
• Architecture Principles
• ADR Index

Guardrails

1. Zero Trust by default—no unauthenticated access to internal docs.
2. No secrets in git—use platform secrets stores when Workflows demand them.
3. Static-first mindset; dynamic features require ADRs and security review.