# IC Blocks

React site components, composition primitives, and editable site recipes.

- [Start a site](docs/AGENT-SCAFFOLDING.md): CLI usage, three recipes, local installation, content and theme ownership.
- [Framework integration](docs/FRAMEWORKS.md): Next.js, Astro, Gatsby, Vite/React Router and browser-island boundaries.
- [Page planning](docs/PAGE-PLANNING.md): published definitions, business profiles, readiness and missing capabilities; generators remain separate.
- [Composition](docs/COMPOSITION.md): layout primitives and slot contracts.
- [Theming](docs/THEMING.md): scoped tokens and packaged CSS.

Build the package with `npm run build:library`. Discover exact exports with `npm run agent -- search "your query" --limit 5 --json`, then fetch props with `npm run agent -- describe Name --json`. Do not invent component names or infer props from names. Keep callback functions inside React client boundaries. Start with an editable recipe and replace its sample assets/content before launch.
