Guides

Start with the eight tutorials below. They are the ones we keep complete: a problem, a compiling example, and a link into the package set. Everything else is a how-to — useful, thinner, and owned by the matching package GUIDE.

If you have not scaffolded yet:

uv add oridecon-cli
oridecon new project my-app --template web-api
cd my-app
oridecon run

Coming from FastAPI? Keep Starlette routing and Pydantic; add a composition root. The map is Migrating from FastAPI.

Canonical

Guide	When to read it
Authentication	JWT, guards, RBAC
Database	Repositories, SQL, migrations
Background jobs	`oridecon-tasks` queues and schedules
AI agents	Tools, strategies, executors
RAG	Chunk, retrieve, cite
Testing	Fakes, test beds, compliance suites
Deployment	`oridecon run` in production
Migrating from FastAPI	Keep your Starlette instincts, add a composition root

How-tos

These stay in the sidebar under More how-tos. Prefer the package Quickstart / Guide / How-tos strip when you already know which package you want.

AI — integration, feedback, MCP, memory, sessions, skills, workers
Web — GraphQL, HTTP client, real-time, webhooks, multi-tenancy
Data — NoSQL, graph, vectors, files, search, cache
Ops — queue, workflows, events, observability, audit, notifications, flags, resilience, CLI, contracts

Runnable companions for several of these live in the examples catalog.

Next Steps

Your First App — the 60-second walkthrough
The oridecon CLI — new, gen, run, dev, db
Project Structure — where generated files land
The Ecosystem — every package, grouped by purpose