Struct Admin 

pub struct Admin { /* private fields */ }

Builder for the admin. Register models with .model::<M>(), then hand it to the router via register_admin_routes.

Implementations

impl Admin

pub fn new() -> Self

Constructs a new Admin with the framework’s core entries pre-seeded. As of Phase 2 the only core entry is User, which the schema exporter must always describe so external tooling can reason about authentication tables. Project models are added on top via Self::model / Self::model_with_search.

pub fn site_branding(self, branding: SiteBranding) -> Self

Override the default RustIO branding. Project-facing API; the builder pattern matches .model() / .model_with_search() so chains read naturally.

pub fn branding(&self) -> &SiteBranding

Read-only access to the active branding — handlers and context builders use this to thread brand strings into templates.

pub fn accent_color(self, color: impl Into<String>) -> Self

1.8.2 — set the admin chrome’s accent colour (one-line shortcut for theme(AdminTheme { accent: ..., ..Default::default() })). Hex form, with or without the leading # ("#1e6ba8" and "1e6ba8" both work).

Drives a runtime <style> block in admin/base.html that overrides every Tailwind utility baking the framework’s default teal as a literal RGB value (bg-brand-600, text-brand-700, link colour, selection colour, focus rings, the --ds-color-accent CSS variable). No Tailwind rebuild required.

Malformed input (wrong length, non-hex characters) is accepted silently — the renderer falls back to the framework default at hex-to-RGB conversion time. This avoids panicking the admin path over a config typo; future versions may add a Result-returning builder for stricter operators.

pub fn theme(self, theme: AdminTheme) -> Self

1.8.2 — set the entire admin chrome palette in one call. Re-skins the topbar, sidebar, body background, surface cards, body text, muted text, and hairlines by overriding the framework’s --rio-* design tokens at render time. See AdminTheme for the field-by-field contract.

pub fn accent(&self) -> &str

1.8.2 — read-only access to the configured accent colour (#rrggbb). Used by BaseContext to populate the render context; projects rarely need to call this directly.

pub fn active_theme(&self) -> &AdminTheme

1.8.2 — read-only access to the active full theme. Used by BaseContext to populate the override <style> block.

pub fn model<M>(self) -> Self

where M: AdminModel + Model,

pub fn model_with_search<M>(self, indexer: Indexer) -> Self

where M: AdminModel + Model + Searchable,

Register a model and wire it into an async search indexer. Every create/update/delete pushes the row into the indexer’s queue — the actual HTTP round-trip to Meilisearch happens in the background.

pub fn entries(&self) -> &[AdminEntry]

pub fn user_profile_extension<F, Fut>(self, ext: F) -> Self

where F: Fn(Db, UserProfile) -> Fut + Send + Sync + 'static, Fut: Future<Output = Result<Vec<UserProfileSection>>> + Send + 'static,

Phase 10/c — register a project-specific extension that contributes extra sections to the built-in user profile page. The closure is invoked on every render of GET /admin/users/:id (Overview tab); it receives the Db handle and the loaded crate::auth::UserProfile (no password_hash) and returns a Vec<UserProfileSection>. Sections render in the order returned, immediately after the core profile show-grid.

Zero-config baseline: don’t call this method, and the extension area stays empty. Projects that need richer layout than key-value rows override the {% block project_user_fields %} template block in templates/admin/user_view.html (extending admin/base.html).

let admin = Admin::new()
    .user_profile_extension(|_db, user| Box::pin(async move {
        Ok(vec![rustio_core::admin::UserProfileSection {
            label: "Account".into(),
            rows: vec![rustio_core::admin::UserProfileRow {
                label: "Display name".into(),
                value: user.full_name.unwrap_or(user.email),
            }],
        }])
    }));

pub fn find(&self, admin_name: &str) -> Option<&AdminEntry>

pub async fn seed_permissions(&self, db: &Db) -> Result<()>

Register the canonical (add/change/delete/view) permissions for every model. Call during startup after init_tables.

Trait Implementations

impl Default for Admin

fn default() -> Self

Returns the “default value” for a type.