How rafapradana/deltamind works
Project type and purpose
• DeltaMind is a cross-platform (iOS, Android, Web, Windows, macOS, Linux) Flutter application that serves as an AI-powered personalized study tool.
• It follows a full-stack, feature-first architecture: a single Dart/Flutter codebase (client) invoking external services (backend-as-a-service & AI APIs).
File structure
• Top-level platform folders (android/, ios/, web/, macos/, windows/, linux/) house native build/config files.
• lib/ is the heart of the app:
• core/: app-wide utilities, constants, routing, theming
• features/: independent feature modules (auth, quiz, analytics, notes, gamification, etc.)
• models/: Dart data classes
• services/: clients for Supabase, Google Gemini, analytics, spaced repetition, etc.
• main.dart: application entry point
• Configuration: pubspec.yaml lists dependencies; .env for SUPABASE_URL, GEMINI_API_KEY.
Insights from README
• Uses Riverpod for dependency injection & state management.
• Feature-first modules encapsulate UI, controllers, any per-feature services.
• External systems:
• Supabase (Auth, Storage, Postgres)
• Google Gemini AI API
• Syncfusion PDF processing
a. Main components
• Client (Flutter App)
• Presentation/UI Layer (Widgets & Pages)
• State Management & Controllers (Riverpod providers, feature controllers)
• Domain Layer (Models & Business Logic in services)
• External Backend Services
• Supabase (Postgres DB, Auth, Storage, Realtime)
• Google Gemini AI API
• Third-party Libraries
• Syncfusion PDF
• HTTP client for API calls
b. Relationships & interactions
• User taps UI → Flutter Widgets invoke Feature Controllers → Controllers call Services → Services perform HTTP/RPC to Supabase or Gemini → Responses flow back up to update state → UI re-renders.
• -taking and quiz data persist to Supabase; AI quiz generation & feedback via Gemini.
c. Architectural patterns & principles
• Layered Architecture: Presentation → Application (controllers/providers) → Domain (services/models) → Infrastructure (external APIs)
• Feature-first modularization for scalability and maintainability
• Dependency Injection via Riverpod
d. Key technologies & frameworks
• Flutter & Dart
• Riverpod (State/DI)
• Supabase Dart SDK
• HTTP/Dio for REST calls
• Google Gemini API
• Syncfusion Flutter PDF