Guides and references for the .crepus DSL, tooling, and browser extensions.
| Guide | Description |
|---|---|
| DSL reference | Syntax, control flow, attributes, animations, SwiftUI semantic tags |
| Components | include, slots, defaults, multi-component files |
| CLI | crepus commands for apps, web, and extensions |
| Production readiness | build gates, security boundaries, and performance checks |
| Observability | timing, tracing, and flamegraph workflow |
| Timing profile | SSR request breakdown, flamegraph recipes |
| Runtime and reactivity | state model, update lifecycle, hydration, and Metal setup |
| Browser extensions | Manifest V3 apps with crepus webext |
| Extension policy (MV3) | CSP safety, store submission, permissions checklist |
| GPUI integration | Desktop apps with GPUI |
| Lite shell | GPUI + V8 desktop shell and Rust plugin bridge |
| Native shells | iOS/Android apps via native UI frameworks |
| Tauri native compatibility | Tauri replacement contract and audit matrix |
| React Native adaptation | Source-level React Native migration boundary |
| Polyglot plugins | Overview: View IR JSON, CLI, optional ABI |
| View IR contract | Stable JSON boundary, schema, CLI envelopes, hot reload |
| Plugin surface | Required capabilities for language packages |
| Aurorality | SwiftUI engine and semantic native tag workflow |
| IDE extensions | Editor integration sketch (CLI tasks, aurorality dev, diagnostics) |
| TUI mode | Terminal user interfaces |
| Embedded / framebuffer | UNSTABLE — RGB565 Ui; in development, largely untested on hardware |
| LVGL | LVGL Pro XML generator for panels and embedded UI workflows |
Implementation details for compilers and agents live in-repo at CREPUS_WEB_IMPLEMENTATION_SPEC.md (not published on the docs site).
Published HTML
When you run crepus web build --manifest docs-site/crepus.toml, the docs-site target runs its local docs-renderer hook to turn Markdown in this directory into styled pages under docs-site/dist/docs/ (for example dsl.html). The project’s GitHub Pages workflow uses that output for the public documentation site.