velto 1.8.0 - Docs.rs

🚀 Velto

✨ 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
🛠 First-class CLI support via velto-cli

📦 Installation

Add Velto to your Cargo.toml:

[dependencies]

velto = "1.6.0"

Or use velto-cli to scaffold a new project instantly:

cargo install velto-cli

velto new my-app

cd my-app

velto run

🚀 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 for clarity and maintainability:

velto/
├── src/
│   ├── app.rs          # Core application logic
│   ├── router.rs       # Routing and handler dispatch
│   ├── response.rs     # HTTP response utilities including redirect helpers
│   ├── http_method.rs  # HTTP method utilities
│   ├── form.rs         # Form data parsing
│   ├── util.rs         # Utility functions (e.g., MIME types)
│   ├── 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:

Old (0.x)	New (1.0.0)
`fn main()`	`#[tokio::main] async fn main()`
`Response<Cursor<Vec<u8>>>`	`Response` (no generics)
`app.run(...)`	`app.run(...).await`
No LiveReload	`app.enable_dev_mode()`

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.