Next Steps¶

You've finished the Quickstart and have a working Ferro app. Pick a path from what you're building.

Learn by Use Case¶

Building an API¶

For REST APIs with FastAPI, Starlette, or similar:

1. Models & Fields — field types, constraints, and defaults
2. Relationships — foreign keys, back-references, many-to-many
3. Queries — filtering with lambda predicates, ordering, and pagination
4. How-To: Pagination — efficient offset and cursor pagination
5. How-To: Testing — fast, isolated tests with in-memory SQLite

Data Processing¶

For ETL pipelines and bulk workloads:

1. Mutations — bulk_create and bulk update/delete for throughput
2. Transactions — make multi-step writes atomic
3. Queries — filter in the database, not in Python

Production Deployment¶

When you're ready to ship:

1. Connections & Databases — connection URLs and pool configuration
2. Migrations — the Alembic workflow for evolving schemas
3. How-To: Multiple Databases — working with more than one database
4. How-To: Testing — a test suite you can trust before deploying

Common Patterns¶

Recipes for things most applications need:

• Testing — per-test database isolation and fixtures
• Pagination — offset- and cursor-based pagination
• Timestamps — created_at / updated_at on every model
• Soft Deletes — flag rows as deleted instead of removing them
• Multiple Databases — connecting to more than one database
• Migrating from SQLAlchemy — a side-by-side translation guide

Reference Material¶

• API Reference — complete documentation for every public class and method: Model, Queries, Fields & Types, Relationships
• Concepts — how Ferro works under the hood: Architecture, Identity Map, Type Safety
• Roadmap — what's implemented today and what's planned

Get Help¶

• GitHub Issues — report bugs or request features
• GitHub — star the repo to follow releases

Build something real and reach for the guides above as questions come up.