# Reef
An idiomatic full-stack Rust framework for edge-distributed apps.
Built on Dioxus, Turso, Tailscale, and NixOS — pure Rust from the browser to the edge.
> ⚠️ **Early development.** This is a name reservation. The framework is being extracted from a production codebase. Expect API churn.
## Goals
- **Pure Rust full-stack.** Dioxus on the client (WASM), the same crate compiles to native on the edge and server.
- **Edge-distributed by default.** Real-time sync between server and edges via Tailscale + typed WebSockets.
- **Local-first data.** Embedded Turso (Rust SQLite) with replication baked in.
- **Idiomatic over magical.** No DSLs, no proc-macro mazes — boring Rust that works.
## Status
| Framework crate (`reef`) | Reserved |
| CLI scaffolder (`cargo-reef`) | Not yet |
| Documentation site | Coming soon at [reef.rs](https://reef.rs) |
## Stack
- [Dioxus](https://dioxuslabs.com) — UI runtime, WASM frontend, fullstack RPC/WebSockets
- [Turso](https://turso.tech) — Rust-native SQLite + replication
- [Tailscale](https://tailscale.com) — transport / authz fabric
- [NixOS](https://nixos.org) — reproducible builds + edge deployment
- [LiteFS](https://github.com/superfly/litefs) (transitional) — server-side distributed SQLite
## License
MIT OR Apache-2.0