# Bolt-web
⚡ A high-performance, minimalist web framework for Rust, inspired by Express.js and Gin.
**Bolt** is a lightweight, modular, and fully asynchronous web framework built on top of [`hyper`](https://github.com/hyperium/hyper) and [`tokio`](https://tokio.rs/).
It focuses on **performance, simplicity**, and **full control** — ideal for REST APIs, WebSocket services, and microservice backends.
---
## 🚀 Features
- 🌐 **Supports HTTP/1.x and HTTP/2** - built in support for both http/1.x and http/2.
- 🔥 **Built in Router** - Fast and flexible routing system with path parameters, dynamic segments, and middleware chaining per route.
- ⚙️ **Grouping Routes** — Simple builder-style API for responses.
- 🧩 **Middleware System** — Add CORS, Helmet, Logging, Rate Limiting, Error handling easily.
- ⚙️ **Request & Response Abstraction** — Simple builder-style API for responses.
- 🌍 **Minimal HTTP Client** — Builtin client for inter-service communication (OAuth, APIs, etc).
---
## 🦀 Example Usage
```rust
use serde_json::json;
use bolt::{
Bolt,
request::RequestBody,
response::ResponseWriter,
middleware::{logger::Logger},
};
#[tokio::main]
async fn main() {
// Initialize server
let mut app = Bolt::new();
// Register global middleware
app.middleware("/", None, Logger);
// Define routes
app.get("/", handler);
// Start the server
app.run("127.0.0.1:8080", Mode::Http2).await.unwrap();
}
fn handler(_req: &mut RequestBody, res: &mut ResponseWriter) {
res.json(&json!({
"msg" : "hello"
}));
}
```
## ⚡ HTTP Client Example
Use the built-in Client to make external API calls.
```rust
use bolt::client::Client;
let client = Client::new();
let data = client.get("https://api.example.com/data").await?;
```
## 🔧 Middleware
Comes with helpful middleware by default.
`Logger` Prints method and route for every request.
`Helmet` Sets secure HTTP headers.
`Cors` Enables cross-origin requests.
`RateLimiter` Simple in-memory request limiter.
`ErrorHandler` Handles and serializes errors.
**🧠 License**
MIT © 2025 — Built with ❤️ in Rust.