How ashishsoni145/smartmind works
SharpMind is a cloud-first student academic platform with web, mobile, and backend code. The README explicitly says Phase 01 product features have not been implemented, so the repository tree alone is not evidence of a complete learning workflow. The clearest implemented runtime path in the excerpts is Android focus monitoring and intervention; backend assessment and student-model handlers are also represented. Several backend and web subsystems are present in the tree but their wiring was not sampled, so those relationships are omitted rather than inferred.
Main entry points: FocusRuntime.kt Focus runtime · useFocusSession.ts Focus session hook · FocusForegroundService.kt Foreground monitor · MainApplication.kt App runtime setup
Components 23
Mobile app
- Mobile shell
apps/mobile/src/app/App.tsx - Navigation
apps/mobile/src/navigation/RootNavigator.tsx - Focus session hook
apps/mobile/src/features/focus/useFocusSession.ts - Focus API
apps/mobile/src/api/index.ts - Focus outbox
apps/mobile/src/features/focus/focusSync.ts
Android focus
- Native bridge
apps/mobile/android/app/src/main/java/com/sharpmind/app/bridge/SharpMindAndroidModule.kt - App runtime setup
apps/mobile/android/app/src/main/java/com/sharpmind/app/MainApplication.kt - Focus runtime
apps/mobile/android/app/src/main/java/com/sharpmind/app/focus/FocusRuntime.kt - Foreground monitor
apps/mobile/android/app/src/main/java/com/sharpmind/app/services/FocusForegroundService.kt - Usage access
apps/mobile/android/app/src/main/java/com/sharpmind/app/usage/AppUsageManager.kt - Usage path policy
apps/mobile/android/app/src/main/java/com/sharpmind/app/focus/UsagePathPolicy.kt - Accessibility service
apps/mobile/android/app/src/main/java/com/sharpmind/app/accessibility/SharpMindAccessibilityService.kt - Event processor
apps/mobile/android/app/src/main/java/com/sharpmind/app/accessibility/AccessibilityEventProcessor.kt - Restriction engine
apps/mobile/android/app/src/main/java/com/sharpmind/app/focus/RestrictionEngine.kt - Restriction rules
apps/mobile/android/app/src/main/java/com/sharpmind/app/focus/RestrictionRule.kt
Backend domains
- Assessment handlers
backend/src/modules/assessments/assessment.controller.ts - Assessment service
backend/src/modules/assessments/assessment.service.ts - Student model handlers
backend/src/modules/student-model/student-model.controller.ts - Student model service
backend/src/modules/student-model/student-model.service.ts - Search service
backend/src/modules/search/search.service.ts
AI platform
- AI orchestration
backend/src/ai/orchestrator.ts
Other components
- Student
- Supabase database
Connections 19
- Student → Mobile shell: uses
- Mobile shell → Navigation: renders
apps/mobile/src/app/App.tsx - Focus session hook → Focus API: calls
apps/mobile/src/features/focus/useFocusSession.ts - Focus session hook → Focus outbox: queues events
apps/mobile/src/features/focus/useFocusSession.ts - Focus session hook → Native bridge: uses bridge
apps/mobile/src/features/focus/useFocusSession.ts - App runtime setup → Native bridge: registers
apps/mobile/android/app/src/main/java/com/sharpmind/app/MainApplication.kt - App runtime setup → Focus runtime: initializes
apps/mobile/android/app/src/main/java/com/sharpmind/app/MainApplication.kt - Foreground monitor → Focus runtime: ticks
apps/mobile/android/app/src/main/java/com/sharpmind/app/services/FocusForegroundService.kt - Foreground monitor → Usage access: reads usage
apps/mobile/android/app/src/main/java/com/sharpmind/app/services/FocusForegroundService.kt - Foreground monitor → Usage path policy: checks path
apps/mobile/android/app/src/main/java/com/sharpmind/app/services/FocusForegroundService.kt - Accessibility service → Focus runtime: submits events
apps/mobile/android/app/src/main/java/com/sharpmind/app/accessibility/SharpMindAccessibilityService.kt - Accessibility service → Event processor: processes events
apps/mobile/android/app/src/main/java/com/sharpmind/app/accessibility/SharpMindAccessibilityService.kt - Focus runtime → Restriction engine: evaluates restrictions
- Restriction engine → Restriction rules: applies
apps/mobile/android/app/src/main/java/com/sharpmind/app/focus/RestrictionEngine.kt - Assessment handlers → Assessment service: calls
backend/src/modules/assessments/assessment.controller.ts - Student model handlers → Student model service: calls
backend/src/modules/student-model/student-model.controller.ts - Search service → Supabase database: queries
backend/src/modules/search/search.service.ts - Assessment service → Supabase database: persists
- Student model service → Supabase database: persists