Skip to content

SpecStar

SpecStar is a spec-driven backend platform for FastAPI with built-in versioning, permissions, search, and API generation.

What makes it different: every resource is a versioned timeline by default — rollback, audit, and time-travel come built in. If you don't need history, the same routes still work as plain CRUD.

It helps you spend less time wiring repetitive infrastructure and more time on your domain logic.

What you get

With a Python model as the source of truth, SpecStar can generate and manage:

  • REST APIs
  • GraphQL APIs
  • OpenAPI documentation
  • revision history and rollback workflows
  • search and query support
  • permissions and event hooks
  • admin UI generation from your API schema

Choose your path

I am new to SpecStar

Start here in order:

  1. Installation
  2. Quickstart
  3. Core Concepts
  4. How-to Guides

I want to evaluate whether SpecStar fits my project

Read these pages first:

I already know which feature I need

Go directly to:

Quick example

Define a model:

from msgspec import Struct
from specstar import Schema

class User(Struct):
    name: str
    email: str

Create a FastAPI app:

from fastapi import FastAPI
from specstar import spec

app = FastAPI()

spec.configure()
spec.add_model(Schema(User, "v1"))
spec.apply(app)

SpecStar will generate the standard CRUD surface, OpenAPI documentation, validation handling, and revision tracking.

Documentation map

Learn the basics

Understand the system design

Build real features

If you want to build versioned APIs with FastAPI and avoid repetitive boilerplate, SpecStar gives you a strong starting point without locking you into a full-stack monolith.