Getting Started
Getting Started
Everything you need to know to get RaisFast up and running.
Installation
Install RaisFast from source or download the binary.
Quick Start
Create a project, seed data, and start the server in 5 minutes.
What is RaisFast?
RaisFast is a Rust-powered headless CMS and backend-as-a-service engine. It compiles to a single binary with zero runtime dependencies, providing blog, ecommerce, wallet, payment, and multi-tenant SaaS capabilities out of the box.
Key Features
- Single Binary — Zero deployment friction, no runtime dependencies
- Blazing Fast — Built with Rust, Axum, and SQLx for maximum performance
- Multi-Database — SQLite, PostgreSQL, or MySQL with zero code changes
- Plugin Engine — JavaScript (QuickJS), Rhai, Lua, and WASM runtimes
- Built-in Modules — Blog, pages, media, ecommerce, wallet, payment, workflow
- Dynamic Content Types — Define schemas in TOML, get CRUD API automatically
- Multi-Tenant — Header-based or domain-based tenant isolation for SaaS
- Admin SPA — Embedded React admin panel, no separate deployment needed
Tech Stack
| Layer | Technology |
|---|---|
| Language | Rust (edition 2024) |
| HTTP Framework | Axum 0.8 |
| Database | SQLx 0.8 (SQLite / PostgreSQL / MySQL) |
| Auth | JWT (HS256) + Argon2 |
| Search | Tantivy |
| Plugin Runtime | wasmtime / rquickjs / mlua / rhai |
| Admin UI | React 19 + shadcn/ui (embedded via rust-embed) |
| ID Generation | Snowflake (ferroid) + base62 encoding |
Architecture Overview
┌──────────────────────────────────┐
│ RaisFast Binary │
│ ┌────────┐ ┌────────────────┐ │
HTTP ─────────► │ │ Axum │ │ Admin SPA │ │
(9898) │ │ Router │ │ (rust-embed) │ │
│ └───┬────┘ └────────────────┘ │
│ │ │
│ ┌───▼────────────────────────┐ │
│ │ Handler → Service → Model │ │
│ └──┬──────┬──────┬──────┬────┘ │
│ │ │ │ │ │
│ ┌──▼──┐┌──▼──┐┌──▼──┐┌──▼───┐ │
│ │ DB ││Cache││Search││Storage│ │
│ └─────┘└─────┘└─────┘└──────┘ │
│ ┌──────┐ ┌─────────┐ ┌───────┐ │
│ │Plugin│ │ Worker │ │EventBus│ │
│ │Engine│ │Job+Queue │ │Pub/Sub │ │
│ └──────┘ └─────────┘ └───────┘ │
└──────────────────────────────────┘