System Documentation

The Gamified
Focus Engine.

Official technical architecture and release notes for Unbreakfocus — built by a 15-year-old student, for students.

v1.1.0 — Stable Release
What's New in v1.1.0

This update brings several customer-requested improvements: a rebuilt audio engine, smart notification channels, improved background reliability for returning users, and smoother account configuration.

🎵 The Audio Update
  • Ultra-low latency audio engine: Rebuilt for deep work sessions with minimal lag and zero interruption.
  • Seamless mixing: UI sound effects now mix over background apps like Spotify or Apple Music without pausing or ducking the music.
  • Mute toggle: A persistent toggle in Settings lets you quickly disable UI sounds.
🔔 Smart Notifications
  • Smart channels: Selecting or updating your mission goal now auto-registers you to dedicated notification channels for tailored content.
  • Broadcast messages: Receive curriculum reminders, motivational alerts, and goal-specific updates.
🔐 Security & UI Polish
  • PIN visibility toggle: Toggle visibility when entering or updating your 4-digit security PIN to avoid typos and accidental lockouts.
  • Fluid animations: Crisp audio feedback mapped to button presses and transitions during setup.
🛡️ Background Protection
  • Bypass fixed: Resolved an edge case where restored accounts skipped device-settings checks and went straight to the dashboard.
  • Uninterrupted tracking: Returning users are prompted to grant background execution privileges so the Focus Shield stays active.
🛡️ The Focus Engine & App Shield
  • Persistent Background Watchdog: Dynamically polls app usage while preserving battery. Accurately logs fractional XP even if the OS attempts to suspend the app.
  • Strict Mode: A high-stakes mode — once engaged, emergency abort costs 25% total XP and instantly resets your Streak to 0.
  • Overtime Sequence: Keep the timer running past your daily goal to grind bonus XP at a 1.5× accelerated multiplier.
  • Live Native Chronometer: Ticking timer pinned accurately to your notification tray without flooding the system with updates.
🎮 Gamification & Progression Economy
  • Exponential Leveling System: True RPG-style curve. Base XP starts at 50 and exponentially doubles every level.
  • Dynamic XP Multipliers: Flow State sessions (1hr+, 2hr+) yield higher rates. Daily streaks grant up to +50% permanent bonus.
  • The Store & Vault: Purchase utilities like the Streak Freeze (1500 XP) to protect your daily streak. Real consequences, real rewards.
⚙️ Technical Architecture
  • Real-Time Firebase Sync: Profiles, wallets, and inventory seamlessly sync to the cloud in real-time.
  • Offline-First Architecture: Network down? App generates secure _OFFLINE_ tags that merge with the cloud once restored.
  • Instant Wake-Up Listeners: The background isolate communicates via dedicated streams, ensuring the UI updates the exact millisecond a state changes.
  • OLED-Optimized: Pure Black (#000000) background saves battery on AMOLED displays and prevents visual smearing.
← Back to Unbreakfocus Install Guide