Smeltery
Get started

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

Mold

templates

@-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

Sparks

live components

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)

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

Alloy

React and Vue

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

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

Bellows

AI-agent support

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

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

Assay

validation

#[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

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

Hallmark

API tokens

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

Prospect

full-text search

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

Quench

testing

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