# ferra-rs
> **This crate is a reserved placeholder.** The real implementation is coming.
Ferra is a Rust framework for building APIs with **model-driven design**.
Define your resource once:
```rust
#[model]
struct Film {
#[id]
id: Id,
title: String,
}
let app = Foundry::new().mount::<Film>(state).build();
```
And get โ from that single annotation:
- REST routes (GET, POST, PUT, DELETE)
- Parameterized SQL queries
- OpenAPI 3.1 spec at `/docs/openapi.json`
- Interactive API docs (Scalar)
- HAL hypermedia `_links` in every response
- Compile-time correctness
> Note: the `ferra` crate name on crates.io belongs to an unrelated project.
> This framework is published as `ferra-rs`.
**Links:** [ferra.rs](https://ferra.rs) ยท [GitHub](https://github.com/ferra-rs/ferra)