The family
Every part, named after the forge.
Smeltery has its own named parts, all from the blacksmith's craft. In code the modules stay plain (smeltery::db, not smeltery::ingot); the names are for the brand. You depend on smeltery alone.
Smeltery the framework and the CLI
The framework and the smeltery command: one CLI creates the app and generates every piece of it.
cargo install smeltery, then smeltery new my-app make:* generators for models, controllers, Sparks, agents, jobs, mail and more Fully async on Tokio, Axum and SeaORM One release binary from smeltery build
Read the docs → crates.io docs.rs
@-directive *.mold.html templates: hot reload in development, compiled and type-checked in release.
Layouts, includes, components with slots Escaped output by default; json and url filters A typo in a template is a compile error in release builds Debug and release render the same bytes
Read the docs → crates.io docs.rs
Live components: Rust state and actions with a Mold view, and no JavaScript to write.
wire:click, wire:model, wire:poll, wire:loading Signed state, bound to the session and the user Server push from handlers, jobs and agents Uploads, and an Alpine.js bridge ($spark, $entangle)
Read the docs → crates.io docs.rs
Watchfire agents, jobs, scheduler
Supervised long-running agents, queued jobs and the scheduler on one runtime, with a live dashboard.
Restart policies, backoff with jitter, heartbeats Per-host rate limits, pools and group limits Checkpoints, run history, dead letters The /_watchfire dashboard, a JSON API and SSE
Read the docs → crates.io docs.rs
React and Vue frontends: the server side of the Inertia v3 protocol, with starter kits.
smeltery new my-app --frontend react or --frontend vue TypeScript, Vite and Tailwind through Vite Node.js builds the assets; the server needs no Node.js Partial reloads, deferred props, encrypted history
Read the docs → crates.io docs.rs
Anvil WebSockets and broadcasting
A WebSocket server inside the app that speaks the Pusher Channels protocol 7, on the app's own port.
Public, private and presence channels Events from handlers, jobs and Watchfire agents pusher-js and laravel-echo connect with a custom host Sparks listen without JavaScript
Read the docs → crates.io docs.rs
Makes an app ready for coding agents: its own MCP server, skills, guidelines, CLAUDE.md and AGENTS.md.
The app's own MCP server: smeltery bellows:mcp route_list, models, db_schema, run_generator, run_tests … Skills: crud-resource, spark, migration, agent … Add it later with smeltery bellows:install
Read the docs → crates.io docs.rs
Ingot models and migrations
Models, migrations, seeders and factories on SQLite, PostgreSQL and MySQL.
SeaORM entities with model methods on top A Laravel-style schema builder for migrations Seeders and factories with a Fake generator Pagination and model events
Read the docs →
#[derive(Validate)] rules on form structs, with clear, ready-to-show messages.
required, email, min, max, confirmed, between … Database rules: unique and exists Errors flow back to the form with old input The Valid<T> extractor
Read the docs →
Temper authentication routes
The authentication routes as a package: log-in, registration, password reset, e-mail verification and two-factor authentication.
Each feature switched on in one builder The app keeps its own pages and small actions Two-factor codes from any authenticator app Throttles on log-in and every other form
Read the docs → crates.io docs.rs
Personal access tokens with abilities for mobile apps, desktop apps and other clients; the auth:hallmark bearer guard.
Tokens for API clients and other backends Abilities per token Stored hashed, revocable smeltery hallmark:install for an existing app
Read the docs → crates.io docs.rs
Full-text search for models, on the database's own full-text search.
SQLite FTS5, PostgreSQL tsvector, MySQL FULLTEXT Ranked, paginated hits that hold real models Every write is searchable at once No extra server runs
Read the docs → crates.io docs.rs
Testing helpers: a test app with a migrated database, harnesses for agents and Sparks, fakes.
TestApp with a cookie jar and acting_as TestSpark for live components Harness and JobHarness for Watchfire Fakes for HTTP and mail
Read the docs →