Resuma

Instantly-interactive Rust web apps — without hydration.

Ship HTML from the server. The browser resumes serialized state and lazy handler chunks — it never re-runs your components. Static pages ship zero client JS.

Get started · Benchmark · Docs · API

cargo install resuma
resuma new my-app --template todo
cd my-app && resuma dev --open

Measured: smallest interactive runtime in class

Same UX everywhere — SSR counter (heading + increment button). Production builds, gzip transfer sizes. Full methodology →

Regenerate locally: node benchmark/run.mjs · Independent sources in benchmark/README.md

If you like Qwik's resumability and a Rust-first stack, Resuma is that model with native SSR, server actions, and no WASM bundle by default.

Why Resuma?

Mental model: components run once on the server. SSR embeds signals and handler refs in HTML; a tiny client runtime resumes on first click or when an island enters the viewport.

Quick start

Requires: Rust 1.91+ (rustup)

cargo install resuma
resuma new                          # interactive — name + template menu
resuma new my-app --template todo   # full showcase (signals, server, islands)
cd my-app
resuma dev --open

Templates: basic · todo · flow · flow-fullstack

use resuma::prelude::*;

#[component]
fn Counter() -> View {
    let count = use_signal(0);
    view! {
        <main>
            <h1>"Count: " {count}</h1>
            <button onClick={ move |_| count.update(|c| *c += 1) }>"+"</button>
        </main>
    }
}

Handlers compile to JavaScript automatically — lazy-loaded on first interaction, wired to resumed signal state.

Library only:

[dependencies]
resuma = "0.3"
tokio  = { version = "1", features = ["full"] }

Server actions

#[server]
async fn search(q: String) -> Vec<String> {
    db::search(&q).await
}

#[server] registers POST /_resuma/action/search. Call from the client with js! or Flow forms — no custom wiring.

Resuma Flow

Full-stack layer inside the same crate — file-based pages, loaders, submits (like Qwik City or SolidStart):

resuma new my-app --template flow
resuma add sqlx    # optional DB scaffolding

Guide: resuma-docs.fly.dev/docs/flow

Product map

Details: docs/NAMING.md

CLI

Architecture

┌──────────────────────────────────────────────────────────┐
│                   resuma crate                           │
│   core → ssr → server (axum) → flow + router             │
│   resuma-macros (view!, #[component], rs2js → JS)       │
└───────────────────────────┬──────────────────────────────┘
                            │ HTTP
                            ▼
┌──────────────────────────────────────────────────────────┐
│              Browser (901 B loader, lazy core)           │
│   parse resuma/state · delegate events · lazy handlers   │
└──────────────────────────────────────────────────────────┘

Deep dive: docs/ARCHITECTURE.md · Security: docs/SECURITY.md · Backend patterns: docs/BACKEND.md

Resources

Project layout

resuma/
├── assets/               # logo + GitHub social preview
├── crates/
│   ├── resuma/           # runtime, SSR, server, flow, CLI
│   └── resuma-macros/    # view!, #[component], rs2js
├── runtime/              # TypeScript client (~901 B loader)
├── benchmark/            # measured comparisons vs Qwik, Next, etc.
├── examples/             # runnable demos
└── docs/                 # markdown reference

Docs site (separate repo): resuma-docs.fly.dev

From source:

git clone https://github.com/GolfredoPerezFernandez/resuma
cd resuma
cargo install --path crates/resuma --features cli --force
cargo run -p example-counter
cargo run -p example-todo

What ships in v0.3

• view!{} — JSX-like templates
• #[component] — resumable by default
• #[server] / #[submit] / #[load] — server RPC and Flow data
• #[island] — optional lazy client bundles
• rs2js — Rust handlers → lazy JS chunks
• axum server with /_resuma/* routes
• File-based routing · static export scaffold
• CLI: new, add, dev, build, routes, update, doctor
• Production security defaults (CSRF, CSP, rate limits)

Community

• Issues & ideas: GitHub Issues
• Security: see SECURITY.md — please do not file public issues for exploitable bugs

Contributions welcome — read CONTRIBUTING.md first.

Why "Resuma"?

Spanish for both resumes (continues) and summary — the framework resumes execution from a serialized summary of the server-side render.

License

Dual-licensed under MIT OR Apache-2.0.