rl-docs-hub

Home · Apps · rl-main-infra · todo_api · todo_mobile

---

todo_mobile

Production-oriented Flutter app (iOS/Android) for multi-list task management with offline-first local storage, Auth0 login, biometric unlock, GraphQL sync, and reminders.

Stack Snapshot

• Routing: go_router
• State/DI: flutter_riverpod, codegen providers (@riverpod)
• Auth: auth0_flutter + flutter_secure_storage + local_auth
• Data: Hive local boxes + GraphQL backend (graphql_flutter)
• Sync: queued SyncJob replay on connectivity restore
• Notifications: flutter_local_notifications + push gateway interface
• Observability: sentry_flutter

Documentation

• API Specs
• DB Schema
• Architecture

Key Runtime Flow

1. App boots, opens Hive boxes, and initializes Sentry.
2. User signs in with Auth0 (/login), then unlocks with biometrics.
3. App navigates to /lists; lists and todos are served from Hive immediately.
4. Local writes enqueue sync jobs.
5. On network availability, queued jobs are pushed via GraphQL mutation (upsertTodo).