How shubgupta10/focus-app works
Lockout is an offline-first Android focus app: users choose distracting apps, start a timed or open-ended focus session, and the native blocker enforces it; completed sessions contribute to on-device statistics and coin rewards. The app also supports recurring routines, strict mode, appearance customization, permissions, notifications, data management, and feedback. The graph combines documented product capabilities with relationships visible in sampled excerpts and the source index; several screens and native implementation files were not sampled, so their internal wiring is not inferred.
Main entry points: useFocusEngine.ts Focus engine · useSessionController.ts Session lifecycle · useRoutines.ts Routine manager · useShopController.ts Theme shop
Components 25
App experience
- Home and sessions
src/app/(tabs)/index.tsx - App navigation
src/app/(tabs)/_layout.tsx - Onboarding
src/features/onboarding/hooks/useOnboardingController.ts
Focus and blocking
- App blocklist
src/app/(tabs)/apps.tsx - Blocklist controls
src/features/blocklist/hooks/useBlocklistController.ts - Session lifecycle
src/features/session/hooks/useSessionController.ts - Focus engine
src/hooks/useFocusEngine.ts - Blocker module
modules/focus-blocker/src/FocusBlockerModule.ts - Android blocker
modules/focus-blocker/android/src/main/java/expo/modules/focusblocker/FocusService.kt
Routine scheduling
- Routine schedules
src/app/(tabs)/routines.tsx - Routine controls
src/features/routines/hooks/useRoutinesController.ts - Routine manager
src/hooks/useRoutines.ts - Routine storage
src/features/routines/db/routineRepository.ts
Data and rewards
- Local database
src/store/database.ts - App state
src/store/useAppStore.ts - Statistics
src/features/stats/db/statsRepository.ts - Theme shop
src/features/shop/hooks/useShopController.ts - Shop catalog
src/features/shop/data/shopCatalog.ts
Settings and support
- Appearance
src/contexts/ThemeContext.tsx - Settings
src/hooks/useSettings.ts - Data management
src/features/data-management/hooks/useDataManagementController.ts - Feedback
src/features/feedback/hooks/useFeedbackController.ts - Anonymous analytics
src/utils/analytics.ts
Other components
- User
- Aptabase
Connections 24
- User → App navigation: opens app
- App navigation → Home and sessions: shows home
- Onboarding → Focus engine: configures apps
src/features/onboarding/hooks/useOnboardingController.ts - App blocklist → Blocklist controls: uses controls
src/app/(tabs)/apps.tsx - Blocklist controls → Focus engine: toggles apps
src/features/blocklist/hooks/useBlocklistController.ts - Focus engine → App state: updates state
src/hooks/useFocusEngine.ts - Focus engine → Blocker module: updates blocklist
src/hooks/useFocusEngine.ts - Session lifecycle → Focus engine: controls sessions
src/features/session/hooks/useSessionController.ts - Session lifecycle → App state: records session
src/features/session/hooks/useSessionController.ts - Blocker module → Android blocker: dispatches blocking
- User → Routine schedules: sets schedules
- Routine schedules → Routine controls: uses controls
- Routine controls → Routine manager: manages routines
src/features/routines/hooks/useRoutinesController.ts - Routine manager → Routine storage: reads and writes
src/hooks/useRoutines.ts - Routine manager → Blocker module: schedules alarms
src/hooks/useRoutines.ts - App state → Statistics: loads statistics
src/store/useAppStore.ts - Session lifecycle → Statistics: updates totals
- User → Theme shop: customizes orb
- Theme shop → Shop catalog: reads catalog
src/features/shop/hooks/useShopController.ts - Theme shop → Settings: saves appearance
src/features/shop/hooks/useShopController.ts - Appearance → Settings: loads preferences
src/contexts/ThemeContext.tsx - User → Data management: backs up data
- User → Feedback: sends feedback
- Anonymous analytics → Aptabase: sends events
src/utils/analytics.ts