# Murasaki

> Next.js-style developer experience for Rust-native desktop apps using React 19, Vite, and the operating system WebView.

Current framework version: 0.52.0 (pre-1.0).
Capability labels are normative: planned features are unavailable; partial and experimental features must be used with their documented limitations.
Canonical feature matrix: https://murasaki.ichi10.com/docs/core-concepts/platform-feature-status

## Documentation

- [Introduction](https://murasaki.ichi10.com/docs): Next.js DX for desktop apps — React 19 + Vite, Rust-native, without writing Rust.
- [Project structure](https://murasaki.ichi10.com/docs/getting-started/project-structure): What lives where in a Murasaki app.
- [Quick start](https://murasaki.ichi10.com/docs/getting-started/quick-start): Scaffold a Murasaki app, run it with HMR, and build a distributable.
- [Architecture](https://murasaki.ichi10.com/docs/core-concepts/architecture): How the Rust host, local Node runtime, and WebView renderer fit together.
- [Platform & Feature Status](https://murasaki.ichi10.com/docs/core-concepts/platform-feature-status): The canonical, evidence-backed status of Murasaki features on macOS, Windows, and Linux.
- [Process model](https://murasaki.ichi10.com/docs/core-concepts/process-model): Startup, development reloads, graceful shutdown, and app-owned resources.
- [AI tooling](https://murasaki.ichi10.com/docs/guides/ai-tools): Use llms.txt, page-level Markdown, and Murasaki's read-only MCP server with coding agents.
- [API Routes](https://murasaki.ichi10.com/docs/guides/api-routes): Next.js-style file-based HTTP endpoints under src/api.
- [App Menu](https://murasaki.ichi10.com/docs/guides/app-menu): Define the native application menu bar with useAppMenu — NSMenu on macOS, HMENU on Windows.
- [Auto-update](https://murasaki.ichi10.com/docs/guides/auto-update): Signed, self-verifying app updates from GitHub Releases or your own server — no IPC, no third-party update service.
- [Context Menu](https://murasaki.ichi10.com/docs/guides/context-menu): Declare a real OS context menu with useContextMenu — no HTML popup involved.
- [Deep links and file associations](https://murasaki.ichi10.com/docs/guides/deep-links): Register URL schemes and document types, then handle every open request in Node Main.
- [Metadata](https://murasaki.ichi10.com/docs/guides/metadata): Per-route document title, description, and Open Graph tags.
- [Middleware](https://murasaki.ichi10.com/docs/guides/middleware): A route guard that runs before every client-side navigation.
- [Native APIs](https://murasaki.ichi10.com/docs/guides/native-apis): What's exposed to your app from Murasaki's native surface today.
- [Node Main](https://murasaki.ichi10.com/docs/guides/node-main): Long-lived Node lifecycle and typed renderer-to-Node functions with 'use main'.
- [Routing](https://murasaki.ichi10.com/docs/guides/routing): File-based routing over src/app — pages, layouts, dynamic segments, and navigation.
- [Server Actions](https://murasaki.ichi10.com/docs/guides/server-actions): 'use server' functions that run in Node, called from React with useAction.
- [Styling](https://murasaki.ichi10.com/docs/guides/styling): Tailwind CSS + @murasakijs/ui, a shadcn-style component library.
- [Windows & permissions](https://murasaki.ichi10.com/docs/guides/windows): Declare multiple native windows and give each renderer only the commands it needs.
- [CLI reference](https://murasaki.ichi10.com/docs/building/cli): Every Murasaki command — dev, build, bundle, installer, and more.
- [Configuration](https://murasaki.ichi10.com/docs/building/configuration): Full reference for murasaki.config.ts.
- [Distribution](https://murasaki.ichi10.com/docs/building/distribution): Shipping real native installers — cross-arch builds, signing, notarization, and CI.
- [Security](https://murasaki.ichi10.com/docs/building/security): Murasaki's trust boundaries, built-in runtime protections, and application responsibilities.
- [Troubleshooting](https://murasaki.ichi10.com/docs/building/troubleshooting): Diagnose development, packaging, signing, startup, and update failures.

## Optional

- [UI component reference](https://murasaki.ichi10.com/docs/components): 24 component and UI-kit pages.
- [Japanese documentation](https://murasaki.ichi10.com/ja/docs): Japanese-language documentation.
- [Complete English and Japanese corpus](https://murasaki.ichi10.com/llms-full.txt): Full processed Markdown in navigation order.
- [API, configuration, and compatibility data](https://murasaki.ichi10.com/llms-api.txt): Machine-readable public symbols, maturity labels, limitations, and JSON Schema.
- [Per-page Markdown](https://murasaki.ichi10.com/llms.mdx/en/docs/content.md): Replace the page slug and keep the /content.md suffix.