Skip to content

markhwinters/FocusFlow

Repository files navigation

🌊 FocusFlow — Minimal Flow-State Productivity App

Breathe. Focus. Flow.

FocusFlow is a sleek, privacy-first focus timer and reflection app built with React Native + Expo Router + NativeWind. It’s designed for creatives, remote workers, and ADHD users who want less friction and more flow — not another bloated productivity tool.


🧭 Why FocusFlow Exists

Most productivity apps overcomplicate what should be simple: starting work, staying present, and finishing strong.

Reddit research and user feedback reveal consistent pain points:

  • “I spend more time organizing than doing.”
  • “I want a focus app that just works, offline.”
  • “I need reflection, not streak gamification.”

FocusFlow directly addresses these needs with:

  • Instant one-tap focus sessions
  • Smart break cycles that protect against burnout
  • Gentle cues instead of dopamine-driven streaks
  • Biometric-secured offline storage
  • A clean, breathing interface that promotes calm presence

🔐 Biometric Security (Built-In)

FocusFlow requires biometric authentication on every launch for full privacy. No passwords, no accounts, no cloud — your data stays 100% local on your device, encrypted and protected via fingerprint or face ID.


🚀 Core Features

🕒 1. Focus Sessions

  • Start instantly with preset or custom durations (5–45 min)
  • Quick Start button uses your saved default timer
  • Full-screen progress ring visualization
  • Subtle breathing animation and timer feedback

🧘‍♀️ 2. Smart Break Mode

  • Automatic 5-minute cooldown after each session
  • Visual countdown ring for pacing your rest
  • Encourages rhythm and recovery between focus blocks
  • Skip or start the next session immediately

💬 3. Reflection Modal (Optional)

  • Appears after breaks to help you reflect intentionally
  • Rate session (1–5 stars) and add short notes
  • Reflections saved locally and shown in History view
  • Skippable for frictionless flow

🎵 4. Haptics + Sound Cues

  • Gentle haptic feedback on session start and completion
  • Soft chime sound (complete.mp3) at focus end
  • Fully controlled via Settings

📊 5. Task History & Insights

  • Automatic session tracking with AsyncStorage
  • Visual charts for daily and weekly focus totals
  • View session reflections with timestamps and notes

⚙️ 6. Settings & Personalization

  • Adjust default focus duration, sound, and haptic feedback
  • Settings persist locally (no cloud dependencies)
  • Clear all stored data with a single tap

🔒 7. Secure & Offline-First

  • Biometric login required (fingerprint or face)
  • No cloud, no tracking, no internet needed
  • FocusFlow runs entirely offline and respects your privacy

💨 8. Seamless App Flow

Splash → Biometric Auth
      ↓
Home → Focus → Break → Reflect → Tasks
      ↓
Settings (Customize + Privacy)

🧠 Design Philosophy

1. Minimal Friction Every extra tap between intention and action kills momentum.

2. Mindful Feedback Gentle cues (sound, haptics, pacing) promote awareness, not stress.

3. Private Reflection Progress is personal — your data stays on your device, encrypted and secure.


🧰 Tech Stack

  • Expo + React Native — cross-platform mobile framework
  • Expo Router — file-based navigation
  • NativeWind — Tailwind-style styling for React Native
  • AsyncStorage — secure local persistence
  • Expo Local Authentication — biometric unlock
  • React Native Circular Progress — animated ring countdown
  • Expo AV + Haptics — sound and tactile feedback
  • Ionicons — elegant system icons

📦 Run Locally

npm install
npx expo start

Then open in Expo Go or your device simulator.


🗂 Project Structure

app/
 ├── index.tsx            # Splash Screen
 ├── auth.tsx             # Required Biometric Unlock
 ├── focus.tsx            # Focus Timer w/ Progress Ring
 ├── break.tsx            # Smart Break + Reflection Modal
 └── (tabs)/
      ├── home.tsx        # Quick Start + Timer Selection
      ├── tasks.tsx       # History + Chart View
      └── settings.tsx    # Personalization
utils/
 └── storage.ts           # AsyncStorage helpers (sessions + settings)
assets/
 ├── logo.svg / logo.png  # Branded assets
 └── complete.mp3         # Focus completion chime

🧩 Addresses These User Pain Points

Pain Point How FocusFlow Solves It
“Too much setup before working” One-tap Quick Start button
“I lose focus easily” Full-screen minimal timer + gentle cues
“I forget to rest” Built-in Smart Break cycles
“I want privacy” Local biometric-secured storage
“I can’t see my progress clearly” Visual charts + reflections
“I get overwhelmed by tasks” FocusFlow centers on doing, not managing

🔮 Future Enhancements

  • 🌧 Background ambient sounds (rain, cafe, white noise)
  • 🧩 Focus streak visualization
  • 🗣️ Voice capture for quick reflections
  • 💫 Optional encrypted cloud sync (user-controlled)

❤️ Built For

Those who crave deep focus, not endless to-do lists. Those who want to trust themselves, not their notifications. Those who believe that clarity comes from calm.


⚖️ License

This project is licensed under the MIT License. See the LICENSE file for more details. For more detailed information regarding permissions and restrictions, please refer to the FOCUSFLOW-LICENSE.md file included in this repository.

About

No description, website, or topics provided.

Resources

License

Stars

Watchers

Forks

Releases

No releases published

Packages

 
 
 

Contributors