# π Velto
Velto is a lightweight, modular web framework for Rust, designed for clarity, speed, and developer happiness. Whether you're building a personal site or a microservice, Velto gives you the tools to stay productive without the clutter.
---
## β¨ Features
- π§ Simple routing with intuitive handler syntax
- π¦ Modular architecture for clean separation of concerns
- π§΅ Template rendering with built-in macros
- π§ Minimal boilerplate with `velto::prelude`
- π Designed for stability and testability
---
## π¦ Installation
Add Velto to your `Cargo.toml`:
```toml
[dependencies]
velto = "0.1.0"
```
---
## π§ͺ Quick Start
```rust
use velto::prelude::*;
fn homepage(_req: &Request) -> Response<Cursor<Vec<u8>>> {
render!("index.html", {
"title" => "Welcome to Velto",
"message" => "Fast. Clean. Rusty."
})
}
fn main() {
let mut app = App::new();
app.route("/", homepage);
app.run("127.0.0.1:8080");
}
```
---
## π§° Project Structure
Velto is organized into clean modules:
```
velto/
βββ src/
β βββ app.rs # Core application logic
β βββ router.rs # Routing and request handling
β βββ template.rs # Template rendering
β βββ macros.rs # Macros for ergonomic syntax
β βββ prelude.rs # Common imports for users
β βββ lib.rs # Public API surface
```
---
## π§ Philosophy
Velto is built on the idea that **organization is key to sustainability**. Instead of packing everything into one file, Velto encourages modularity, clarity, and simplicity. Itβs designed to grow with your projectβnot get in the way.
---
## π License
Velto is open source under the MIT [License](LICENSE).
---
## π¬ Contributing
Velto is still evolving. If you have ideas, feedback, or want to help shape its future, feel free to open an issue or submit a PR!