rustio-admin

Django Admin, but for Rust. A small, focused admin framework for Postgres-backed Rust apps. From a struct to a working CRUD admin in under 50 lines of project code.

What you get

#[derive(RustioAdmin)] on a plain struct → list / create / edit / delete pages.
impl ModelAdmin for Django-style customisation (list_display, list_filter, search_fields, ordering, list_per_page).
DB-backed sessions, Argon2 passwords, 5-tier role hierarchy, per-model RBAC.
Hyper + sqlx + minijinja under the hood. Postgres only. No Tailwind, no PostCSS, no build step — one hand-written stylesheet.
Single binary deploy. Project templates and CSS are baked in via include_str!; project overrides drop into templates/admin/.

Install

While the crate is path-only (pre-publish), use a path dependency from a local checkout:

[dependencies]
rustio-admin = { path = "../rustio-admin/crates/rustio-admin" }
tokio  = { version = "1", features = ["macros", "rt-multi-thread"] }
chrono = { version = "0.4", features = ["serde"] }

A crates.io publish lands when the rustio-admin-macros crate goes up alongside.

The 3-line idea

#[derive(RustioAdmin)]
pub struct Post { pub id: i64, pub title: String, /* … */ }

impl Model     for Post { /* TABLE, COLUMNS, from_row, insert_values */ }
impl ModelAdmin for Post {}                            // accept every default

// In your `main`:
let admin = Admin::new().model::<Post>();
let router = register_admin_routes(Router::new(), admin, db, templates);
Server::new(router, addr).run().await?;

A model that wants more control fills in the ModelAdmin body:

impl ModelAdmin for Post {
    fn list_display()  -> &'static [&'static str] { &["title", "published", "created_at"] }
    fn list_filter()   -> &'static [&'static str] { &["published"] }
    fn search_fields() -> &'static [&'static str] { &["title", "body"] }
    fn ordering()      -> &'static [&'static str] { &["-created_at"] }
}

For a complete project skeleton see examples/minimal/ and the docs/getting-started.md walkthrough.

Documentation


Getting started	`cargo new` to a running admin in 10 minutes.
`ModelAdmin` reference	Every hook, every default, when to override.
Architecture	Module map, runtime, public API surface.
Strategic reset plan	Why the framework exists, what's in/out of scope.
Changelog	Per-release summary.

Workspace layout

Crate	Purpose
`rustio-admin`	The library. Re-exports the macros.
`rustio-admin-macros`	Proc-macros (re-exported from `rustio-admin`).
`rustio-admin-cli`	The `rustio` binary — `startproject`, `startapp`, `migrate`, `user`, `group`, `perm`, `doctor`.

cargo build --workspace
cargo test  --workspace

Status

Pre-alpha. The reset roadmap is still landing in phases. The runtime is feature-complete for the examples/minimal walkthrough and the classrooms consumer; the CLI scaffolding is a stub; a browser-walk on a real Postgres deploy is the next acceptance step. See the strategic reset plan for the full ladder.

Non-goals

rustio-admin is the admin layer and the auth/permissions/templates that surround it — nothing more. Not a full web framework. Not an ORM (the Model trait is a thin sqlx shim). Not a content management system. Not AI-augmented. Not multi-database (Postgres only, on purpose). Not schema-contract-driven (the schema-contract / drift-validator / AI-planner work belongs in a future Tier-2 crate, kept entirely out of this repo).

License

MIT — see LICENSE.

rustio-admin-macros 0.1.0