How jeet2005/niva works
NIVA is a local-first Flutter personal-context and planning app. The main user workflow is to enter or review tasks and personal context, receive a deterministic daily plan and reminders, and ask questions through an optional Groq-backed conversation boundary; replanning proposals require app-side validation and confirmation. The README also documents memory correction, relevance, route estimates, calendar/weather boundaries, and privacy/settings screens. Mobile source excerpts were not provided, so mobile connections are shown as unverified; the backend-to-Groq call is visible in its excerpt.
Main entry points: context_engine.dart Context engine · planning_engine.dart Daily planning · home_screen.dart Home and today · drift_local_store.dart Local persistence
Components 25
Mobile experience
- Flutter app shell
apps/mobile/lib/app/niva_app.dart - App state
apps/mobile/lib/app/app_state.dart - Home and today
apps/mobile/lib/features/home/home_screen.dart - Conversation
apps/mobile/lib/features/conversation/conversation_screen.dart - Plan screen
apps/mobile/lib/features/plans/plan_screen.dart - Memory screen
apps/mobile/lib/features/memories/memories_screen.dart - Privacy settings
apps/mobile/lib/features/privacy/privacy_screen.dart - Integrations screens
apps/mobile/lib/features/integrations/integrations_screen.dart - Context simulator
apps/mobile/lib/features/integrations/context_simulator_screen.dart
Context and planning
- Context engine
apps/mobile/lib/context/context_engine.dart - Relevance engine
apps/mobile/lib/context/relevance_engine.dart - Daily planning
apps/mobile/lib/planning/planning_engine.dart - Adaptive alarms
apps/mobile/lib/planning/adaptive_alarm_service.dart - Reminder scheduling
apps/mobile/lib/notifications/reminder_scheduler.dart - Notification intelligence
apps/mobile/lib/notifications/notification_intelligence.dart
Local data
- Memory service
apps/mobile/lib/memory/memory_service.dart - Calendar boundary
apps/mobile/lib/calendar/calendar_service.dart - Weather boundary
apps/mobile/lib/weather/weather_service.dart - Route services
apps/mobile/lib/routing/routing_service.dart - Route memory
apps/mobile/lib/routing/route_memory_service.dart - Local persistence
apps/mobile/lib/storage/drift_local_store.dart - Domain models
apps/mobile/lib/models
Assistant boundary
- Conversation API
backend/app/main.py
Other components
- Person
- Groq API
Connections 25
- Person → Flutter app shell: uses
- Flutter app shell → App state: manages
- App state → Home and today: presents
- Person → Conversation: asks
- Person → Plan screen: reviews
- Person → Memory screen: corrects memories
- Person → Privacy settings: manages privacy
- Person → Integrations screens: reviews integrations
- Person → Context simulator: simulates context
- Home and today → Context engine: uses context
- Context engine → Relevance engine: ranks candidates
- Home and today → Daily planning: requests plan
- Daily planning → Adaptive alarms: informs alarms
- Daily planning → Reminder scheduling: schedules reminders
- Reminder scheduling → Notification intelligence: checks priority
- Memory screen → Memory service: uses memories
- Context engine → Calendar boundary: reads calendar boundary
- Context engine → Weather boundary: reads weather boundary
- Context engine → Route services: uses route context
- Route services → Route memory: uses route profiles
- Daily planning → Local persistence: persists plans
- Memory service → Local persistence: persists memories
- Local persistence → Domain models: stores records
- Conversation → Conversation API: sends request
- Conversation API → Groq API: calls
backend/app/main.py