# brust

> A native-first React framework on Bun + Rust: pages are server-rendered HTML by default, and interactivity is added back island by island.

## Overview

- [Overview](https://brust.assetsart.com/docs): What brust is and how these docs are organized.

## Getting Started

- [Introduction](https://brust.assetsart.com/docs/introduction): The philosophy behind brust — native-first rendering, islands, and when it fits.
- [Installation](https://brust.assetsart.com/docs/installation): Scaffold a brust project with bun create, or add brustjs to an existing app.
- [Your First Route](https://brust.assetsart.com/docs/first-route): A defineRoutes walkthrough — Component, loader, params, and the native variant.
- [Project Structure](https://brust.assetsart.com/docs/project-structure): The scaffold layout, brust.toml configuration, the .brust/ cache, and public/ assets.
- [Commands](https://brust.assetsart.com/docs/commands): The brust CLI — dev, build, and new.

## Concepts

- [Routing](https://brust.assetsart.com/docs/routing): The route tree — nesting, layouts, loaders, params, middleware, and native chains.
- [Rendering Modes](https://brust.assetsart.com/docs/rendering): Native templates, React streaming SSR, and islands — what each does and when to use it.
- [Native Interactivity](https://brust.assetsart.com/docs/native-interactivity): Behavior components and x-* directives — interactive native pages with no React on the client.
- [Store](https://brust.assetsart.com/docs/store): Signals, defineStore, effects — one isomorphic reactive core for islands, behaviors, and the server.
- [Navigation](https://brust.assetsart.com/docs/navigation): Client-side navigation — link interception, the reactive nav store, useNav, NavLink-style behaviors, and live active links. Works on the live server and on static exports.
- [Actions](https://brust.assetsart.com/docs/actions): defineActions endpoints, validation, typed errors, and the treaty client.
- [Caching](https://brust.assetsart.com/docs/caching): The two-layer page cache — declarative L1 served from Rust with zero worker dispatch, programmatic L2 keyed from your own logic, routed per request by bypass, with tag/path invalidation.
- [Styling](https://brust.assetsart.com/docs/styling): app.css and Tailwind v4, CSS Modules (native routes included), and self-hosted fonts.
- [Dynamic Templates](https://brust.assetsart.com/docs/dynamic-templates): Register, update, and remove minijinja templates at runtime — per-tenant sections and custom layouts keyed by arbitrary strings, rendered from any handler or loader.

## Guides

- [Markdown Pages](https://brust.assetsart.com/docs/markdown-pages): mdRoutes and mdNav — file-based markdown content with frontmatter, live embedded components, and a frozen manifest for dist.
- [Static Export (SSG)](https://brust.assetsart.com/docs/static-export): brust build --ssg — prerender to plain HTML, generate dynamic routes with ssg.params, and keep the long tail working on a static host with fallback client.
- [Deployment](https://brust.assetsart.com/docs/deployment): Shipping a brust app — the self-contained dist/, BRUST_* environment, worker sizing, and the static-export alternative.

## Reference

- [CLI](https://brust.assetsart.com/docs/cli): The complete brust command reference — every command, flag, and default, verbatim from brust help.
- [Agents](https://brust.assetsart.com/docs/agents): The built-in MCP server and window.Brust browser runtime — typed tools, route resources, and a framework-aware UI surface.