Skip to content
@Rullst

Rullst

πŸ“œπŸ¦€πŸŒ Super Full-Stack Framework for Rust language πŸŒπŸ¦€πŸ“œ- πŸ€– The AI-Native Paradigm (Designed for Humans & AI)

All glory and honor to God Χ™Χ”Χ•Χ” in the name of Yeshua the Messiah (Jesus Christ).

Rullst Logo

πŸŒπŸ¦€πŸ“œ Rullst πŸ“œπŸ¦€πŸŒ

Intelligent, Security-Conscious, and Designed for Effortless Productivity β€” Because With Rullst, We Rule!

An open-source, Axum-based framework suite.
Build beyond the endpointβ€”with code you can inspect and boundaries you control.

Crates.io Crates.io Downloads Docs.rs Main Rust CI License: MIT

Whole-repository coverage OpenSSF Scorecard MSRV 1.96.0

Start building Β· Try live examples Β· Documentation Β· Contribute

v12.0.0 is published. Install the stable package below. main receives v12 maintenance; next-major work lives on v13. The legacy v5 line is no longer maintained. Release record Β· Compatibility policy.

πŸš€ Start building

Generate a project, choose a blueprint and database, then start the development loop:

cargo install cargo-rullst --version 12.0.0 --locked
cargo rullst new my_app
cd my_app
cargo rullst dev

Choose Blank / API, Blog, SaaS, LMS, Portfolio or ERP. Generated projects contain ordinary Rust you can inspect and change.

Installation and prerequisites Β· Zero-to-Hero tutorial Β· Build a JSON REST API Β· CLI reference

πŸ§ͺ Try the live examples

Explore applications hosted on Azure Container Apps, with their code and deployment recipes in Rullst/examples:

Application Explore
🌐 Showcase β€” blog, SSR and selected integration demonstrations Open Showcase β†—
πŸŽ“ LMS β€” course catalog and learning-platform example Open LMS β†—
πŸ’Ό Portfolio β€” projects, skills and experience presentation Open Portfolio β†—

These are independently maintained demo snapshots and may lag the stable release. Showcase payment fixtures are not live checkout. Deployment availability, native downloads and provider approval are separate from framework test evidence; use test data, not sensitive information, in public demos.

✨ What you can build on

Rullst coordinates application foundations in one versioned Rust workspace:

  • Product-shaped starting points: six blueprints, inspectable generators, supervised rebuild/restart, a terminal dashboard and assisted upgrades.
  • Data and background work: Active Record, transactions and an outbox for supported relational databases, plus explicitly scoped specialized stores and durable local messaging.
  • Identity and security: sessions, Argon2id, passkey and OAuth2/OIDC helpers, ownership checks, CSRF, secure headers and bounded request defenses.
  • AI and service integrations: local/cloud AI clients, tenant-aware RAG, transactional email and provider-specific payment/webhook adapters.
  • Developer visibility: Studio for local runtime telemetry and Nexus for explicitly authorized registered-model administration.
  • A web-first foundation: SSR with HTMX, JSON APIs and generated Omni/Tauri shells. Native toolchains, signing and device validation remain separate steps.

Explicit boundaries are part of the design. Database capabilities are not interchangeable; security middleware does not replace application authorization; live fiscal authorization and remote message-broker adapters remain roadmap work. Choose the features you need and review their documented capabilities.

Rullst builds on Axum, Tokio, Tower and SQLx, with standard routers and pools available at documented integration points. You can adopt it incrementally. Why Rullst? Β· Axum & SQLx escape hatches Β· Omni's web-first contract

See the CLI and blueprint gallery

Recorded repository previews, not live release evidence. The current CLI can differ in menu options, labels and layout.

CLI Β· From idea to inspectable Rust

Rullst CLI Initiating LMS Blueprint

Click to Watch: How to build a SaaS Blueprint with Rullst

How to build a SaaS with Rullst

SaaS Blueprint

LMS Blueprint

SaaS Blueprint LMS Blueprint
Open the development dashboard preview

Recorded Rullst terminal dashboard with project information, logs and controls

Repository screenshot, not live telemetry. Layout and available controls can differ by version. Development workflow.

πŸ”„ Upgrade with a preview

From an existing application's root:

cargo rullst upgrade --dry-run
cargo rullst upgrade

The CLI coordinates dependency updates, backs up controlled files and runs compiler checks. Review the plan and application behavior; it does not migrate production data or guarantee compatibility with an unreleased major version.

Assisted upgrade tutorial Β· v5 β†’ v12 migration guide

πŸ›οΈ Explore the ecosystem

Sixteen publishable crates share one release train. Select what your application needs; detailed feature and provider boundaries live in the specification.

Browse the crate directory
Crate Focus
rullst Public framework facade and feature selection
rullst-core HTTP runtime, routing, lifecycle and telemetry
rullst-orm Relational models, transactions and capability-specific persistence
rullst-auth Passwords, sessions, passkeys and authorization helpers
rullst-security Defense-in-depth middleware, guards and audit helpers
rullst-connect OAuth2/OIDC identity integrations
rullst-ai Guarded local/cloud clients and tenant-aware retrieval
rullst-capital Payment/payout adapters, webhooks and bounded billing helpers
rullst-mail Transactional email and delivery controls
rullst-messaging Broker-neutral contracts and durable local messaging
rullst-studio Local developer control room
rullst-nexus Registered-model admin with explicit access policy
rullst-iot Bounded no_std helpers and signed OTA verification, not device integration
rullst-macros Compile-time HTML and application macros
rullst-orm-macros Typed ORM code generation
cargo-rullst Project scaffolding, development and upgrade CLI

⚑ Performance you can inspect

The benchmark hub publishes eight Criterion groups backed by nine benchmark binaries. They measure specific workloads and regressionsβ€”not universal speed, application throughput or a ranking of frameworks. Read the methodology alongside the results.

πŸ›‘οΈ Verification, with visible scope

Explore the stable release audit, current capability status and quality scorecard. Badges and test results are evidence for their stated scope, not a security certification of every application built with the framework.

πŸ›‘οΈ Open the full v12 verification dashboard (37 workflows)

πŸ›‘οΈ v12 Main Verification Dashboard

Rullst applies layered compile, test, architecture, portability, and security checks.
Badges are pinned to the main branch; they report the latest matching run, not a certification or deployment guarantee.

Continuous or change-aware gate v12 main status Actual scope
Rust CI Rust CI Format, all-target/all-feature Clippy, tests on Linux/macOS/Windows, Cargo-aware doctests sourced from all 52 public tutorials, strict DB boundaries, feature boundaries, generated-code checks, and MSRV 1.96.0.
Declared MSRV MSRV 1.96.0 Every publishable v12 manifest declares Rust 1.96.0 and CI runs an explicit workspace all-feature check with that toolchain.
GitHub Actions lint Workflow Lint Validates workflow syntax, expressions, embedded shell, and full-SHA third-party Action pins.
Documentation Documentation Builds the mdBook and rejects broken local links and anchors; scheduled/manual runs also preserve an informational external-link report.
End-to-end smoke E2E Boots the release blog example and verifies HTTP, security headers, form flow, and SQLite persistence.
Codecov β€” whole repository Whole-repository coverage The badge reports the current branch aggregate. The stable-source LLVM run at eb11f892 measured 90.3220% (79,813/88,365 lines) before Codecov upload. The enforced repository floor is β‰₯90% with zero tolerance.
Codecov β€” framework libraries Framework library coverage Runtime libraries are enforced separately at β‰₯90%. CLI and proc-macro components stay separately visible; Coverage CI uploads their real LCOV evidence with OIDC.
Cargo Audit Cargo Audit RustSec advisory scan with only governed, expiring exceptions.
Security exception governance Security Governance Cross-checks scanner allowlists against the owner/expiry ledger, then independently reruns Cargo Audit.
Cargo Deny Cargo Deny Advisory, license, ban, and source policy.
CodeQL SAST CodeQL Rust semantic analysis after an all-target/all-feature build.
OpenSSF Scorecard OpenSSF Scorecard The badge renders the score from the official public Scorecard JSON report; the pinned Scorecard workflow publishes OIDC-authenticated results on each main push and weekly. A score is evidence, not a security certification.
Cargo Machete Machete Unused direct dependency detection.
SemVer checks SemVer Supported library APIs are compared with exact latest non-yanked registry baselines; never-published packages and unsupported proc-macro/binary surfaces are reported explicitly.
Zero-panics policy Zero Panics Denies panic-family operations in published production targets and generated runtime templates.
Unsafe boundary Unsafe Policy Denies new production unsafe code outside the reviewed OS/FFI allowlist.
Secret scanning TruffleHog Verified-secret scan across the configured Git history range.
Spellcheck Spellcheck Repository-wide typo detection.
Crate architecture policy Architecture Compares the real publishable-crate dependency graph with a versioned, reviewed repository policy.
WebAssembly matrix Wasm Compiles Core, the public facade and macros for browser Wasm and WASI Preview 1.
Bare-metal no_std matrix no_std Builds IoT helpers for Cortex-M and RISC-V targets; this is compile evidence, not hardware testing.
IoT integration IoT Host tests, signed OTA invariants, and a Cortex-M build.
IoT crypto containment IoT Crypto Path-aware signed OTA, Vault, advisory, and simulator-boundary checks; no PQC/HSM certification claim.
Omni desktop matrix Omni Desktop Generates fresh web shells and checks their Tauri crates on Linux, macOS and Windows; no installer, signing or store claim.
Omni Android compile Omni Android Generates a fresh shell and compiles an unsigned Android debug APK; no physical-device, Play testing/signing or store claim.
Omni iOS simulator Omni iOS Path-aware fresh scaffold generation and compilation on a macOS iOS simulator target; no device, signing or App Store claim.
PR security evidence PR-only evidence Pull-request-only bounded IDOR/RBAC heuristics and CycloneDX SBOM artifact. It intentionally has no continuous main status.

Deep or irreversible workflows are intentionally not presented as continuously green main gates:

Deep evidence Trigger and enforcement
Benchmark regression Weekly, main push, or manual; eight published groups backed by nine Criterion benchmark binaries emit non-blocking alerts at a 20% regression.
Property testing Weekly/manual release-mode invariant testing with 10,000 configured cases.
TSan and ASan Daily/manual package matrices on a pinned verifier-only nightly.
Fuzzing / corpus minimization Forty manual libFuzzer jobs; weekly/manual corpus maintenance is informational.
OWASP ZAP Manual baseline over three release surfaces: generated REST API and complete LMS are blocking with no ignored alerts; the deliberately CDN-backed blog showcase remains an explicitly informational boundary.
Kani, Miri, mutation testing, cargo-udeps Manual or scheduled research signals: selected Kani/Miri scopes are strict, while mutation and unused-dependency findings remain explicitly informational.
GitHub Pages Deploys the v12 documentation from main; it is not a code-quality gate.
Release and provenance Exact version tags only: full verification, package-all, evidence bundle, checksums, GitHub build-provenance attestation, changelog-derived release notes, and ordered crates.io publication. This does not claim a project-wide SLSA level or independent certification.

Scheduled events use the repository's default branch, so scheduled and continuous v12 evidence now refer to main. The recommended required-check profile and the exact scope of all 37 workflow definitions are documented in WORKFLOWS.md.

πŸ“– Read the detailed breakdown of all CI/CD and security workflows.

🧭 Capability Status & Vision Decisions preserves ambitious features that are partial or not implemented, with an explicit recommendation and rationale for each one.

πŸ“‹ Simple Capability Status and the per-commit quality scorecard keep feature progress separate from SHA-bound engineering evidence.

🀝 Build Rullst with us

Try a blueprint, report a reproducible bug, improve a tutorial or contribute a focused change with tests. Documentation, accessibility and integration feedback matter as much as new features.

Contributing Β· Issues Β· Discord Β· Community links Β· Our story and philosophy

What's next? v12 receives compatible maintenance. The v13 roadmap guides next-major development; planned capabilities are not shipped features.

MIT license Β· Report a vulnerability privately Β· Website privacy notice

All glory and honor to God Χ™Χ”Χ•Χ” in the name of Yeshua the Messiah (Jesus Christ).

Pinned Loading

  1. Rullst Rullst Public

    πŸ“œπŸ¦€πŸŒ Intelligent, Secure and Effortless Super Full-Stack Framework πŸŒπŸ¦€πŸ“œ"Rust for those who want to build securely and easily, but not suffer"πŸ€– The Next-Gen Paradigm: Designed for Humans & AI. Rullst …

    Rust 17 5

  2. Benchmarks Benchmarks Public

    Benchmarks

    C 4 1

  3. Rullst.github.io Rullst.github.io Public

    CSS 1

Repositories

Showing 8 of 8 repositories

Top languages

Loading…

Most used topics

Loading…