Examples
Every example follows the same shape: install the SDK, configure the handler, register a factory for each model, and expose a single POST endpoint. Each factory carries an input schema (Pydantic in Python, Zod in TypeScript, and so on) so the SDK can describe the model to the dashboard and validate the create payload before invoking your code. There is no SQL introspection and no SQL fallback.
Available examples
All examples live in the SDK repository. Each one ships with a README covering prerequisites, quick start, project structure, and how it works.
| Language | Framework | Schema lib | Source |
|---|---|---|---|
| TypeScript | Express | Zod | express |
| TypeScript | Next.js (App Router) | Zod | nextjs |
| TypeScript | Hono | Zod | hono |
| Python | FastAPI | Pydantic | fastapi |
| Python | Flask | Pydantic | flask |
| Python | Django | Pydantic | django |
| Elixir | Phoenix | Ecto schemas | phoenix |
| Java | Spring Boot | Bean Validation | spring-boot |
| Ruby | Rails | dry-validation | rails |
| Rust | Axum | serde + validator | axum |
| Go | Gin | go-playground/validator | gin |
| PHP | Laravel | Symfony Validator | laravel |
Configuration reference
Every example configures the same handler fields:
| Field | Description |
|---|---|
scopeField | The column that scopes all models to a tenant (e.g. organizationId). Declared in discover so the dashboard knows how to isolate test data. |
sharedSecret | Shared between your server and Autonoma. Verifies incoming requests via HMAC-SHA256. Generate with openssl rand -hex 32. |
signingSecret | Private to your server. Signs the refs token so teardown can only delete what was created. Generate with openssl rand -hex 32, and make it different from sharedSecret. |
factories | One factory per model. Each declares an inputSchema / input_model plus a create that calls your real service, and an optional teardown. |
auth | Called during up with the created user. Returns credentials (cookies, headers, or credentials) so Autonoma can act as the test user. |
For what each field does in depth, see Factories & the create payload, Authentication, and Security.