> ## Documentation Index > Fetch the complete documentation index at: https://committ.mintlify.site/llms.txt > Use this file to discover all available pages before exploring further. # Client-Side Overview > Interactive map of the apps/native/ codebase — click any module to dive into its documentation. # Client-Side Overview This is your interactive launchpad for the entire `apps/native/` codebase. Every box below links to its deep-dive documentation page. Click to explore. *** ## The Monorepo at a Glance ``` apps/ ├── native/ ← You are here (React Native + Expo) ├── web/ ← Tauri desktop dashboard ├── extension/ ← Browser distraction blocker (WXT) └── BugReport/ ← Issue tracking templates ``` Everything below documents the **native** client — the core Android application. *** ## app/ — Screens and Routing File-based routing powered by Expo Router. Each folder maps to a route group with its own layout and navigation stack. The entry point — 9-layer provider nesting, console hijack, and invisible system components. Sign-in, OAuth, welcome screen, and session-based routing guards. Bottom tab navigator: Commits, Schedules, Presets, Alerts, Profile. Hub-and-Spoke architecture for building commitments with spoke screens. Day picker, time windows, Google Maps geofencing, per-slot attachments. Three-tab interface: Apps (native bridge), Websites (manual), Search. CalendarKit grid with drag-and-drop event management. Photo, email, money, and direct-commit penalty sub-screens. CAPTCHA and paragraph transcription redemption challenges. 8-point hardware permission audit with deep-link to Android Settings. Immutability lock activation — edits and deletes rejected until expiry. Location, blocklist, and rule preset CRUD with isolated state. Active verification: GPS polling, photo capture, checkpoint checks. *** ## lib/ — Core Infrastructure The engine room. These modules handle data persistence, synchronization, and hardware coordination. Saga-pattern engine: Convex → SQLite → AlarmManager with automatic rollback. Delta payload ingestion with Freshness Guard and corruption recovery. Singleton Promise-chain mutex serializing all database writes. V12 Instance-Dependent SQLite schema and Nuke & Pave migration strategy. Task-level CRUD with Unified Identity strategy and prepared statement batching. Instance lifecycle management with orphan survival and atomic clobber-and-spawn. Console hijack with persistent daily log files and auto-tracing. JS-side interface to the Kotlin AlarmManager native module. Better Auth client configuration and session management. Date formatting, epoch conversion, and timezone-safe helpers. Runtime validation for task drafts and time slot configurations. *** ## modules/ — Native Kotlin Bridges (JSI) Kotlin native modules that bypass the React Native bridge for direct hardware access via JSI. AlarmManager + WakeLock orchestration. BootReceiver re-hydrates state on device restart. High-speed JSI extraction of all installed packages via Android PackageManager. Accessibility-based anti-circumvention engine for app and website blocking. Permission deep-links and Device Admin management for enforcement settings. Nuclear reset and self-healing connection recovery (process restart). Native in-memory buffer bridging Android logcat output to the JS Logger. *** ## stores/ — Zustand State Machines Client-side state managed by Zustand stores with logger middleware. The 800+ line, 26KB store powering the entire commitment wizard state machine. Calendar grid state, view modes, date selection, and event interaction tracking. Read-only store of hydrated location, blocklist, and rule presets from Convex. Dashboard list selection, context menu, and deletion state. Real-time GPS, geofence match, camera, and CAPTCHA verification state. Dual-mode recovery: healing spinner and crash confirmation with nuclear reset. Isolated editing state for preset CRUD without affecting the wizard. Global foreground/background state for HydrationSync triggers. Read-only SQLite task cache for the Dashboard commits list. Dev-only store for injecting failures and testing system resilience. *** ## hooks/ — React Hooks Custom hooks that orchestrate data flow between stores, Convex, SQLite, and native modules. Background sync engine: boot sync, foreground re-sync, zombie detection, and Smart Blame Logic. One-shot hook at wizard layout mount to pre-load all presets from Convex. Master orchestrator that fires the Triple-Write when the user commits (\~450 lines). CRUD actions: delete, edit, move, and strict-mode lock via Triple-Write. Convex reactive query for tasks with Zustand store synchronization. Drives active verification: GPS polling, photo capture, status transitions. Server-authoritative subscription to the next pending event (zero-horizon). GPS tracking with three-branch permission handling (granted, askable, blocked). 8-point Android permission audit and deep-link triggers. Transforms instances into CalendarKit event blocks with status-based coloring. Computes visible date range for the calendar grid query scope. Data layer for EventDetailModal: instance parsing, verification status, and actions. Bidirectional sync between penalty sub-screens and the draft store. Bidirectional sync between waiver sub-screens and the draft store. Multi-select state for bulk task operations on the Dashboard. JSI-powered installed app enumeration from AppListerModule. Auto-populates penalty and waiver fields from saved accountability presets. Time-limited signed URL generation for penalty photo uploads to Convex Storage. *** ## components/ — UI Components Invisible root component that runs useHydrationSync for background data sync. Root/jailbreak detection gate that unmounts the entire app tree on compromised devices. Full-screen recovery modal: healing spinner during sync, crash confirmation on failure. Reusable primitives: buttons, inputs, modals, sliders, skeletons, and layout containers. ChaosFab and DbDebugFab — floating debug buttons for resilience testing. DEPRECATED — Legacy zombie detector. Replaced by HydrationSync. *** ## providers/ and contexts/ — React Providers Catastrophic failure recovery — increments iteration counter for full client rebirth. Manages Convex client lifecycle with graceful teardown on resurrection. Uniwind dark-mode theming with the Hardened Saffron design token system. Tab navigation state, visit tracking, state persistence, and preload optimization. *** ## plugins/ — Expo Config Plugins Expo config plugins that patch the AndroidManifest.xml at build time via AST transforms: * **withAlarmPermissions** — Injects `SCHEDULE_EXACT_ALARM` and `USE_EXACT_ALARM` permissions into the manifest, required for hardware alarm scheduling on Android 12+. *** ## Quick Reference: File to Documentation Map For the full directory tree with line-by-line annotations, see the [Folder Structure](/client-side/folder-structure) page.