Soffio

About Soffio

Soffio is a modern, Rust-powered publishing platform designed for technical writers, individual bloggers, and small teams who value performance, simplicity, and control over their content.

Why Soffio?

  • Blazing Fast — Built entirely in Rust with Axum, Askama, and SQLx, Soffio delivers exceptional performance with minimal resource usage.
  • Writer-Focused — A clean, distraction-free admin interface lets you focus on what matters most: your writing.
  • Headless Ready — Full RESTful API with fine-grained permission scopes. Integrate with your existing tools and workflows.
  • Zero Client-Side JavaScript — Interactive features powered by server-side rendering and Datastar + SSE. No JavaScript frameworks, no bloat.
  • Beautiful Rendering — First-class Markdown support with syntax highlighting, KaTeX math formulas, and Mermaid diagrams out of the box.

Architecture

Soffio follows a clean, layered architecture:

  • Public Site — Statically rendered pages with optional interactive widgets for readers.
  • Admin Console — A dedicated interface for writing, editing, organizing, and publishing content.
  • Headless API — RESTful endpoints for automation, integrations, and the command-line tool.

For Developers

Soffio is open source under the BSD-2-Clause license. The codebase enforces a strict Domain/Application/Infrastructure layering model, making it easy to understand, extend, and contribute.

Technology Stack:

  • Rust 2024 Edition
  • Axum 0.8 (HTTP framework)
  • PostgreSQL with SQLx (Database)
  • Askama (Templating)
  • Comrak, KaTeX, Syntect (Content rendering)
  • Apalis (Background jobs)

Try It Out

The demo database resets every hour, so feel free to experiment!

Author: xfyyzy