# Athena examples
The `examples/` folder is the executable usage map for the Rust SDK and gateway surface. It is where you point contributors when they need working request shapes instead of abstract explanations.
## Example lanes
- edge and D1: `gateway_d1_flat_crud.rs`
- gateway builders: `gateway_fetch_builder.rs`, `gateway_insert_builder.rs`, `gateway_update_builder.rs`, `gateway_delete_builder.rs`, `gateway_row_id_shortcuts.rs`, `gateway_sql.rs`, `gateway_rpc_builder.rs`, `gateway_alias_methods.rs`, `gateway_shared_conditions.rs`, `gateway_complex_filters.rs`, `gateway_raw_select_nested.rs`
- gateway contracts: `gateway_endpoints.rs`, `gateway_routes_static.rs`, `gateway_typed_requests.rs`
- gateway workflows: `gateway_bulk_workflow.rs`
- performance: `perf_insert_duplicate_replay.rs`
- sdk: `athena_client_sdk.rs`, `storage_sdk.rs`, `supabase_health_tracking.rs`
## Notes
- Start with [MANIFEST.md](MANIFEST.md) if you need the whole example index.
- Prefer adding a focused example here when a new public surface needs a copyable workflow.
- Keep examples aligned with the root SDK and gateway contracts rather than app-specific wrappers.