velto 0.1.0

Velto: expressive, modern, and grounded Rust framework
Documentation
# πŸš€ 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!