Getting Started with Proa

Proa is a Rust SSR framework that compiles templates into optimized byte sequences at compile time.

Installation

Add Proa to your Cargo.toml:

[dependencies]
proa_core = "0.1"
proa_macros = "0.1"
proa_ui = "0.1"

Your First Component

Synchronous components implement the WebRenderSync trait:

use proa_core::{DataLoader, WebContext, WebRenderSync, WriteBuf, WriteError};
use proa_macros::html_sync;

struct Card<'a> {
    title: &'a str,
    body: &'a str,
}

impl<'a, B: WriteBuf, L: DataLoader> WebRenderSync<L, B> for Card<'a> {
    fn render(self, cx: &mut WebContext<L, B>) -> Result<(), WriteError> {
        html_sync! {
            <div class="card">
                <h3>{self.title}</h3>
                <p>{self.body}</p>
            </div>
        }
        .render(cx)
    }
}

Key Features

• Zero-allocation rendering — no heap in the hot path
• Compile-time validation — catch errors before runtime
• Dual output — same component renders HTML and Markdown
• 30+ components — buttons, cards, dialogs, tables, and more

Benchmarks

Proa achieves this by consolidating static HTML into byte literals at compile time. Only dynamic values are written at runtime.

See the component catalog for live examples.

This has bold, italic, strikethrough, inline code, and a link.

The best way to predict the future is to implement it.

— David Heinemeier Hansson

1. Add dependencies
2. Create a component
3. Render it

Or unordered:

• Fast
• Safe
• Ergonomic