# aihu

> A zero-dependency Web Components meta-framework. .aihu SFCs compile to vanilla custom elements with sub-2 kB reactive primitives. Every component is agent-discoverable and callable as an MCP tool.

## Getting Started
- [Introduction](https://aihu.dev/#introduction): What aihu is and why it exists
- [Installation](https://aihu.dev/#installation): Install aihu into a new or existing project
- [Getting Started](https://aihu.dev/#getting-started): Your first .aihu component

## Core Concepts
- [Authoring Components](https://aihu.dev/#guides/authoring-components): SFC anatomy, @state, @template, @style blocks
- [Reactivity](https://aihu.dev/#guides/reactivity): Signals, computed values, and effects
- [Authoring Agents](https://aihu.dev/#guides/authoring-agents): @agent block — expose state and actions as MCP tools
- [Styling](https://aihu.dev/#guides/styling): @aihu/css-engine — scoped utilities, cn(), style packs
- [Theming](https://aihu.dev/#guides/theming): @aihu/css-engine design tokens — aihu-default / aihu-graphite packs, defineStylePack(), :root + .dark emission
- [Primitives](https://aihu.dev/#guides/primitives): @aihu/primitives — headless WAI-ARIA dialog, tooltip, button

## Advanced
- [Routing & Layouts](https://aihu.dev/#guides/routing-layouts): defineRoutes, layouts, and nested routes
- [Data Fetching](https://aihu.dev/#guides/data-fetching): defineLoader and DataSource for async data
- [SSR & Hydration](https://aihu.dev/#guides/ssr-hydration): Server-side rendering and client hydration
- [Agent Discovery](https://aihu.dev/#guides/agent-discovery): llms.txt, MCP server cards, and robots.txt
- [Authoring Plugins](https://aihu.dev/#guides/authoring-plugins): Extending aihu with custom compiler transforms

## Reference
- [Migration (v0 → v1)](https://aihu.dev/#migration): Upgrade pre-v1 SFCs — @props→$prop:, $computed prop reads, $html, $-bindings
- [API Reference](https://aihu.dev/#api-reference): Complete API surface for all @aihu/* packages
- [Deployment](https://aihu.dev/#guides/deployment): Cloudflare Workers, Vercel, and Node.js adapters

## Optional
- [Full docs (LLM-optimised)](https://aihu.dev/llms-full.txt)