simple_module_pythonModular-monolith for Python

FastAPI + SQLModel + Inertia.js + React — plugin modules that compose at boot. No microservice tax, no API-client glue.

One app, many modules

Each module ships its own SQLModel tables, API endpoints, and React pages — but everything runs in one FastAPI process. Installed as Python packages, discovered via entry points.

SQLModel end-to-end

A single type system for tables and DTOs. Per-module Base class gives you a Postgres schema (or table-name prefix on SQLite) with zero boilerplate.

Inertia.js, not a split SPA

Server renders React pages with shared props (auth, menus, i18n) — no REST glue. Auto-discovered .tsx pages under modules/, hot-reloaded by Vite.

Diagnostics that fail boot

Orphan pages, phantom renders, coupling violations, migration drift, locale inconsistencies — caught at dev time, enforced at production boot.

Batteries-included

Permissions, roles, audit/soft-delete/multi-tenant mixins, event bus, i18n with CLDR plurals, feature flags, health checks — standard plumbing you don't have to rebuild.

Scaffold in one command

make new-module name=orders generates the full package — ModuleMeta, models, service, endpoints, pages, tests — already wired into the app.

What you'll find here

This documentation is structured around what you're trying to do:

Guide — install, bootstrap, and build your first module.
Framework — the module system: discovery, lifecycle hooks, middleware, permissions, events, i18n.
Database — SQLModel conventions, per-module Base, mixins, session lifecycle, Alembic migrations.
Frontend — Inertia page keys, shared props, page discovery, client dependencies.
Testing — the fixtures in conftest.py, how to write unit tests against a real DB, and how to run E2E.
Reference — make targets, environment variables, diagnostic codes, deployment.

The authoritative single-page docs (framework-conventions.md, module-authoring.md, e2e-testing.md, release.md) are also linked from each section's sidebar — they are the source of truth when conventions are ambiguous.