🚀 Velto

A minimal async web framework for Rust, built for clarity, speed, and joy.

✨ Features

• 🧭 Intuitive routing with route!(...) macro
• 🧵 Templating with built-in render! macro
• ⚡ Fully async, powered by async_tiny
• 🔄 LiveReload support in development mode
• 📁 Static file serving with zero config
• 🧠 Minimal boilerplate via velto::prelude

📦 Installation

Add Velto to your Cargo.toml:

[dependencies]
velto = "1.0.0"

🚀 Quick Start

use velto::prelude::*;

fn homepage(_req: &Request) -> Response {
    render!("index.html", {
        "title" => "Welcome to Velto",
        "message" => "Fast. Clean. Rusty."
    })
}

#[tokio::main]
async fn main() -> std::io::Result<()> {
    let mut app = App::new();
    app.enable_dev_mode(); // Enables LiveReload
    route!(app, "/" => homepage);
    app.serve_static("static");
    app.run("127.0.0.1:8080").await
}

🔄 LiveReload

Velto automatically watches your static/ and templates/ directories in dev mode.
When a file changes, connected browsers reload instantly via WebSocket.

No setup required. Just call:

app.enable_dev_mode();

🧰 Project Structure

Velto is organized into modular components:

velto/
├── src/
│   ├── app.rs          # Core application logic
│   ├── router.rs       # Routing and handler dispatch
│   ├── reload.rs       # LiveReload WebSocket + file watcher
│   ├── dev.rs          # Dev mode toggles and helpers
│   ├── template.rs     # Templating engine
│   ├── macros.rs       # Macros for render! and route!
│   ├── prelude.rs      # Public API surface
│   └── lib.rs          # Entry point

❓ Why Velto

Velto is for developers who want:

• A fast, async-native web framework without the complexity of full-stack giants
• Clean routing and templating without ceremony
• Instant LiveReload for a smooth development loop
• A modular codebase that grows with your project
• A framework that feels like Rust — not like a port of something else

Whether you're building a personal site, a microservice, or a dev tool, Velto gives you just enough structure to stay productive — and just enough freedom to stay creative.

🔁 Migration from 0.x

Velto 1.0.0 introduces async support and LiveReload, but keeps the public API familiar. Here's what changed:

Most route handlers and macros (route!, render!) remain unchanged.
Just update your main() function and remove Cursor<Vec<u8>> from response types.

📄 License

MIT — free to use, modify, and distribute.

💬 Contributing

Velto is evolving rapidly. If you have ideas, feedback, or want to help shape its future, open an issue or submit a PR.
We welcome clean code, thoughtful design, and good vibes.