Lariv application kernel — configuration, HTTP server wiring, and aggregated plugin registries.

lariv-rs is a compile-time plugin web application framework built on Axum, SeaORM, Maud, and HTMX 4.

Architecture

The app lifecycle has three phases:

Builder — App holds an HList of capability stores (hooks + items). Plugins call define_plugin_install! to register deferred hooks for routes, templates, migrations, CLI commands, etc.
Mount — App::mount resolves hooks, folds capabilities to Tagged outputs, and produces a MountedApp.
Runtime — Axum serves HTTP; handlers extract mounted state via Cap.

Quickstart

use lariv_rs::app::App;
use lariv_rs::plugins::{dashboard, users};

#[tokio::main]
async fn main() -> anyhow::Result<()> {
    let app = App::new_web_app();
    let app = users::install(app);
    let app = dashboard::install(app);
    let app = app.load_config("config.toml").await?;
    let mounted = app.mount();
    mounted.run_migrations().await?;
    mounted.run_seeds().await?;
    mounted.run().await
}

See [app] for lifecycle details and [plugins] for bundled plugins.

Beginner guides

Step-by-step tutorials for new plugin authors live in the [docs] module:

[docs::quickstart] — Hello World plugin tutorial
[docs] — project layout and guide index

Core modules

Module	Role
[`app`]	Builder and mounted app lifecycle
[`capability`]	Capability stores, hooks, mount folding
[`tag`]	Type-level tagging via [`tag::Tagged`]
[`traits`]	HList lookup, add, replace, remove
[`http`]	Route registry and Axum router
[`template`]	Maud page template registry
[`layers`]	Compile-time view middleware stacks
[`components`]	Maud UI builders (fields, tables, shells)
[`web`]	HTMX-aware page rendering helpers
[`html_form`]	Form macro and widget traits
[`rt`]	Large-stack process entry helpers ([`main`])
[`config`]	TOML configuration loading
[`db`]	SeaORM connection capability
[`migration`]	Composite SeaORM migrator
[`command`]	CLI command registration
[`hooks`]	State attachment and seed hooks
[`apps`]	Dashboard app tile catalog
[`export`]	XLSX export table catalog
[`llm_tools`]	Gemini function-calling tools
[`rune_env`]	Rune script native bindings
[`grapesjs`]	Website builder block/component registries
[`genai`]	Gemini HTTP client
[`views`]	Named view registry (PWA offline page)

Plugin authoring

Module	Role
[`plugin_install`]	[`define_plugin_install!`] macro
[`plugin_routes`]	[`define_plugin_routes!`] DSL reference
[`define_plugin_routes`]	Proc-macro re-export

Bundled plugins

Plugin	Module	Purpose
Users & auth	[`plugins::users`]	JWT/scrypt auth, roles, user CRUD
Dashboard	[`plugins::dashboard`]	Apps launchpad and home redirects
Blog	[`plugins::blog`]	Articles and hierarchical tags
Filesystem	[`plugins::filesystem`]	DB-backed virtual filesystem
Website	[`plugins::website`]	DB routes, Minijinja pages, GrapesJS builder
LLM assistant	[`plugins::llm_assistant`]	Gemini chat, skills, WebSocket
OTP recovery	[`plugins::otp`]	SMS/email one-time password recovery
PWA	[`plugins::pwa`]	Manifest, service worker, offline page
Export	[`plugins::export`]	XLSX data export UI
Signup	[`plugins::signup`]	Public self-service signup