# Tavo.js

> Tavo.js is a TypeScript-first framework ecosystem for CSR, SSR, routing, data, MVC components, stores, production tooling, and an optional accessible UI system.

Important agent guidance:
- Tavo.js is not React. Do not introduce React hooks, React context, or React rendering assumptions.
- Keep route concerns in page modules, reusable UI in components, behavior in TavoController classes, and reactive state in models or stores.
- Page modules may export `pending` for active client-route loading UI and `error` for a contextual page-loader failure; import `PagePendingProps` and `PageErrorProps` from `@tavojs/core/router`.
- Use `tavo agent-context --json` for bounded project context and `tavo verify --no-project-scripts --json` when verification must not invoke project scripts.
- Use @tavojs/mcp over local stdio for versioned Tavo.js knowledge and optional read-only project inspection; do not assume a public hosted endpoint is available.
- Use the generated Markdown and JSON exports for machine-readable documentation.
- Treat server/client boundaries, consent, accessibility, and SSR determinism as implementation requirements.

## Start

- [Getting Started](https://tavojs.dev/docs/getting-started.md): Build a representative application from setup through deployment.
- [Components, controllers, and stores](https://tavojs.dev/docs/getting-started/components-controllers-and-stores.md): Learn Tavo.js ownership and state conventions.
- [Server and client execution](https://tavojs.dev/docs/getting-started/server-and-client-execution.md): Keep browser and server work in the correct runtime.

## Framework

- [Pages and layouts](https://tavojs.dev/docs/core/pages-and-layouts.md): File routes, layouts, and typed page modules.
- [MVC components](https://tavojs.dev/docs/core/mvc.md): Components, models, controllers, and lifecycle.
- [Data loading and middleware](https://tavojs.dev/docs/core/data-and-middleware.md): Loaders, middleware, caching, and request data.
- [SSR and hydration](https://tavojs.dev/docs/core/ssr-and-hydration.md): SSR, hydration, and deterministic rendering.
- [Core API reference](https://tavojs.dev/docs/core/api.md): Search the published Framework API by responsibility and package boundary.

## UI

- [Tavo.js UI documentation](https://tavojs.dev/docs/ui.md): Tavo.js UI overview and installation path.
- [Accessibility](https://tavojs.dev/docs/ui/accessibility.md): Accessibility behavior and requirements.
- [Composition and imports](https://tavojs.dev/docs/ui/composition-and-imports.md): Supported composition and package imports.
- [Tavo.js UI component index](https://tavojs.dev/docs/ui/components/index.md): All public components with usage, props, examples, and accessibility guidance.

## Agent interfaces

- [Use Tavo.js with AI coding agents](https://tavojs.dev/docs/mcp.md): Connect MCP-compatible AI agents to Tavo.js documentation and optional read-only project inspection.
- [Complete LLM context](https://tavojs.dev/llms-full.txt): Combined authored documentation and component reference.
- [Versioned JSON manifest](https://tavojs.dev/.well-known/tavo-docs-v1.json): Structured documentation, APIs, components, tokens, CLI help, versions, and content hash.

## Optional

- [Automation and JSON protocol](https://tavojs.dev/docs/cli/automation.md): Bounded machine workflows, dry runs, receipts, and verification.
- [UI Core overview](https://tavojs.dev/docs/ui-core.md): Platform-neutral tokens and accessibility primitives.