# BOB-Astro

> Universal Agent-Native Web Substrate with 100% Static Cloudflare Pages Edge (Zero Workers, Unlimited Bandwidth).

BOB-Astro (Break Ordinary Boundaries of Astro) is an enterprise-grade agency web framework built with Astro 7.4, Tailwind CSS v4, Lenis 1.3 kinetic scrolling, and mathematical design systems. It is engineered specifically for autonomous AI coding agents (Claude Code, Cursor, Devin, Codex, Antigravity) to fork and deploy pixel-perfect digital experiences in under 5 minutes with zero hardcoding.

## Core Documentation & Manuals

- [Getting Started Guide](https://bob-astro.abcsteps.com/docs/getting-started): Initialize, configure, and rebrand in under 60 seconds.
- [Sovereign Edge Architecture](https://bob-astro.abcsteps.com/docs/architecture): 100% static compilation, zero runtime Workers overhead, and Cloudflare Pages free tier topology.
- [34 Craft Primitives & Motion Spine](https://bob-astro.abcsteps.com/docs/craft-primitives): Exhaustive catalog of production-ready motion, tactile UI, and visual primitives.
- [OKLCH Color Science & Dual Registers](https://bob-astro.abcsteps.com/docs/palette-engineering): Perceptual uniformity, obsidian neutrals, and zero-FOUC theme switching.
- [Autonomous Agent Forking Protocol](https://bob-astro.abcsteps.com/docs/agent-forking): One-shot CLI scaffolding (`npm run fork`) and git detachment for AI agents.
- [The Sovereign Cull & Prune Decision Matrix](https://bob-astro.abcsteps.com/docs/cull-and-prune-matrix): Deterministic keep-vs-delete rules for building minimal sites.
- [Token Economics & Developer Time ROI](https://bob-astro.abcsteps.com/docs/token-and-time-economics): Quantitative analysis of 99% time compression and 98.8% token savings.

## Pre-Rendered Static JSON API Endpoints

- [/api/health](https://bob-astro.abcsteps.com/api/health): Static system telemetry, framework version, page quota, and edge status.
- [/api/catalog](https://bob-astro.abcsteps.com/api/catalog): Complete programmatic registry of all 34 craft primitives with prop interfaces.
- [/api/manifest](https://bob-astro.abcsteps.com/api/manifest): Architectural manifest, mathematical OKLCH palettes, and audit metrics.

## Autonomous Agent Quickstart Command

```bash
# Clone and scaffold in one command
git clone https://github.com/div197/BOB-Astro.git my-agency
cd my-agency
npm install
npm run fork -- --name "My Agency" --tagline "Next-Gen Web" --palette emerald --detach-git
npm run build
npm run test:static
```

## Complete Single-File Context

For the exhaustive, all-inclusive documentation and component specification in a single document, see:
- [Full LLM Context](https://bob-astro.abcsteps.com/llms-full.txt)