🌊 Resuma

The first Rust web framework with SSR + Resumability + Islands + Server Actions + a friendly JS Bridge.

Zero hydration, true resumability, native islands, automatic Rust→JS handler compilation.

Install: cargo install resuma · Docs: docs.rs/resuma · Repo: GitHub

What is this?

Resuma is a from-scratch Rust framework for building modern web apps with resumability instead of hydration:

Resumability vs hydration

The mental model: components only run on the server. The browser never re-executes them. Instead, the SSR pass serialises every signal, handler reference and island into the HTML, and the tiny client runtime resumes execution lazily — exactly when the user clicks something.

Hello, Resuma

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>
    }
}

#[tokio::main]
async fn main() -> std::io::Result<()> {
    ResumaApp::new()
        .with_title("Counter")
        .page("/", || Counter::render(CounterProps::default()))
        .serve(ServeOptions::default())
        .await
}

That single click handler is automatically translated to JavaScript by resuma-macros (rs2js), lazy-loaded on first interaction, and runs against the resumed signal state. No hydration, no re-execution, no WASM bundle.

Server actions

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

#[component]
fn LiveSearch() -> View {
    let query   = use_signal(String::new());
    let results = use_signal::<Vec<String>>(vec![]);

    view! {
        <input
            onInput={ js! {
                state.query.set(event.target.value);
                const r = await __resuma.action('search', [event.target.value]);
                state.results.set(r);
            }}
        />
        <ul>{format!("{} results", results.peek().len())}</ul>
    }
}

#[server] registers an RPC endpoint at /_resuma/action/search. The handler is dispatched there transparently.

Islands

#[island]
fn LiveCounter() -> View {
    let count = use_signal(0);
    view! {
        <button onClick={ move |_| count.update(|c| *c += 1) }>{count}</button>
    }
}

Mark any component with #[island] and Resuma will package its handlers into an isolated chunk that ships only when the island scrolls into view (or immediately, configurable).

Resuma Flow (full-stack layer)

One crate — resuma includes core + Flow in a single dependency.

See docs/PACKAGE.md and docs/FLOW.md.

Live docs site: https://resuma-docs.fly.dev · or cargo run -p example-website → http://127.0.0.1:3000

resuma new my-app                    # static SSR (default)
resuma new my-app --template todo    # full Resuma showcase

Architecture

┌──────────────────────────────────────────────────────────┐
│                   resuma crate (v0.2)                    │
│                                                          │
│   core ──► ssr ──► server (axum)                         │
│     │              GET  /_resuma/runtime.js              │
│     │              POST /_resuma/action/:name            │
│     └──► flow + router (pages, loads, submits)           │
│                                                          │
│   resuma-macros (separate crate)                         │
│     view! / #[component] / rs2js → JS handlers           │
└──────────────────────────────────────────────────────────┘
                         │ HTTP
                         ▼
┌──────────────────────────────────────────────────────────┐
│                   Browser (~3KB)                         │
│   parse resuma/state · delegate events · lazy handlers   │
└──────────────────────────────────────────────────────────┘

See docs/ARCHITECTURE.md for a deep dive.

Security: docs/SECURITY.md — CSRF, headers, rate limits, production checklist.

Backend patterns: docs/BACKEND.md — live in examples/todo.

All docs: docs/README.md · cargo run -p example-website

Publishing: docs/PUBLISHING.md — crates.io release checklist

Project layout

Resuma/
├── crates/
│   ├── resuma/             # single runtime crate (core, ssr, server, flow, cli)
│   └── resuma-macros/      # proc-macros + rs2js (required separate crate)
├── runtime/                # TypeScript source for the ~3KB client runtime
└── examples/
    ├── counter/
    ├── todo/
    ├── flow-demo/
    ├── flow-pages/
    └── website/            # docs site

Docs: docs/README.md · live site: cargo run -p example-website

Getting started

Pre-requisites: Rust 1.91+ (rustup).

Install from crates.io (recommended)

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

• Crate: crates.io/crates/resuma
• API docs: docs.rs/resuma/0.2.2
• Proc-macros: docs.rs/resuma-macros/0.2.2

Library only (no CLI binary):

[dependencies]
resuma = { version = "0.2", default-features = false }
tokio = { version = "1", features = ["full"] }

From source (development)

git clone https://github.com/GolfredoPerezFernandez/resuma
cd resuma
cargo install --path crates/resuma --features cli

# Examples
cargo run -p example-counter   # http://127.0.0.1:3000
cargo run -p example-todo      # full-stack + security showcase
cargo run -p example-website   # docs site

What works in v0.2

✅ Signal<T>, use_signal, use_effect, use_computed ✅ view!{} macro with JSX-like syntax (no $ noise) ✅ #[component] with auto-generated props builder ✅ #[server] async actions with JSON-RPC endpoint ✅ #[island] interactive component boundary ✅ js!{} escape hatch for raw JS handlers ✅ Rust → JS compiler for common handler patterns ✅ SSR with resumability payload embedded in HTML ✅ ~3KB client runtime (lazy event delegation + signals + RPC) ✅ axum-based server with built-in /_resuma/* routes ✅ File-based routing scanner (src/routes/[id].rs → /users/:id) ✅ resuma CLI: new, dev, build, routes

Roadmap (v0.3+)

• Hot Module Reload via resuma CLI + websocket bridge
• Build-time pre-rendering for static sites
• Partial pre-rendering (PPR) — server shell + dynamic islands
• #[island(load = "visible")] lazy load policies
• Devtools extension for resumability payload inspection
• First-class TypeScript bindings for js!{} blocks
• WASM-backed islands for compute-heavy code (opt-in)

Already shipped in v0.2: single-crate layout, streaming SSR (Flow), layouts, file-based routing, security defaults, crates.io publish.

Why "Resuma"?

Spanish for both resumes (continues) and summary — fitting because the framework's superpower is resuming execution from a serialised summary of the server-side render.

License

MIT OR Apache-2.0