# Usage Scenarios

Practical guides for specific SmartAsync use cases.

## Fundamentals

Essential scenarios for getting started:

- **[01: Sync App → Async Libraries](01-sync-app-async-libs.md)** - CLI tools using httpx, aiohttp
- **[02: Async App → Sync Libraries](02-async-app-sync-libs.md)** - FastAPI/Django with sync databases
- **[03: Testing Async Code](03-testing-async-code.md)** - Simplified async tests

## Architecture

Design patterns for larger systems:

- **[04: Unified Library API](04-unified-library-api.md)** - Single codebase for sync and async users
- **[05: Gradual Migration](05-gradual-migration.md)** - Incremental sync-to-async migration
- **[06: Plugin Systems](06-plugin-systems.md)** - Plugins that can be sync or async

## Integration

Framework and tool integration:

- **[07: Mixed Frameworks](07-mixed-framework.md)** - Flask with async microservices
- **[08: Web Scraping](08-web-scraping.md)** - Async fetch + sync parsing
- **[09: Interactive Environments](09-interactive-environments.md)** - Jupyter notebooks

---

Each scenario includes problem description, solution with SmartAsync, and complete working examples.