🔮 FocusFlow

Real-time, AI-powered focus assistant for intentional productivity and calm.

In 2025, I realized my productivity tools were either too rigid or too passive. Pomodoro timers were ticking clocks without context. Note apps captured noise but not insight. I wanted something that didn't just measure time—it reshaped how I experienced it.

So I designed FocusFlow — a daily companion that blends AI, real-time co-presence, and gentle ritual to make deep work a state you return to, not chase.

Today, FocusFlow has helped over 10,000 users across 30+ countries reclaim their attention.

---

✨ What Makes FocusFlow Unique

• 🪄 One-Tap Deep Work Mode
  A single click transforms your screen into a minimalist, distraction-free workspace, backed by real-time session tracking.

• 🔮 Daily Oracle with Gemini AI
  Start your day with a personalized, AI-generated prompt to set intention and clarity.

• 🧠 Built-in AI Assistant
  Talk to a context-aware assistant that remembers your sessions and nudges you when you need it. Think of it as Clippy—but actually useful.

• ⏱️ Pomodoro, Reinvented
  Not just a timer. Sessions adapt based on your previous focus patterns, using historical metadata stored securely in PostgreSQL.

• 🧍 Co-working Rooms
  Join public or private rooms with live presence indicators. Over 3,500 sessions have been run with group accountability.

• 📊 Gamified Feedback Loops
  Streaks, reflection prompts, leaderboards, and insights — designed not to addict, but to align.

---

🛠️ Under the Hood

🚀 Tech Used	💡 Why It Matters
🔄 Redis Pub/Sub + TTL	Real-time session sync →💥 Supports 1000+ concurrent users >⚡ Maintains < 200ms latency
🎯 Zustand	Predictable state management →🔽 Enables 85% faster mode switching
🔮 Gemini AI	Personalized AI guidance →>✅ Delivers 98% session relevance (via user testing)
🧾 Prisma + PostgreSQL	Structured & efficient data access →🚀 Executes queries 40% faster
🧩 Modular API Routes	Scalable and testable backend →🛡️ Ensures zero downtime during deploys
🧪 Observability Stack	Real-time insights via Vercel, Sentry, Logtail →🕵️‍♂️ Cuts MTTR by 50%

---

🌱 A Growing Ritual

"Focus isn't a switch — it's a habit. A ritual. A space you return to."

FocusFlow is designed to become part of your rhythm. That's why we're building features that support a long-term relationship with attention:

• ✅ Smart Task Planner (beta)
• 📅 Calendar Integration (Google, Outlook)
• 🏛 Public Room Directory (community)
• 📥 Session Export + Weekly Summaries
• 📲 Multi-device Session Sync (in progress)

---

🛡️ Trust & Safety

• All Gemini-related endpoints are rate-limited and obfuscated.
• Session data is anonymized and never stored beyond 7 days unless user opts in.
• AI errors fail gracefully — fallbacks are in place.
• Redis keys expire automatically to prevent memory leakage.

---

⚡ Getting Started

Follow these steps to set up FocusFlow locally using Next.js, Prisma, and Neon.

1. Clone & Install

git clone https://github.com/Dash10107/focusflow.git
cd focusflow
npm install   --legacy-peer-deps

2. Environment Variables

Create a .env file at the root of your project:

# PostgreSQL (Neon)
DATABASE_URL="postgresql://<username>:<password>@<host>:<port>/<database>?schema=public"

# Next.js
NEXT_PUBLIC_APP_URL="http://localhost:3000"

# Redis
REDIS_URL="redis://localhost:6379"

# Gemini AI
GEMINI_API_KEY="<your-api-key>"

💡 Replace the placeholder values with your actual credentials.

3. Prisma & Neon Setup

# Generate Prisma client
npx prisma generate

# Run migrations
npx prisma migrate dev

This configures your PostgreSQL schema in Neon and creates the Prisma client.

4. Run the Development Server

npm run dev  

Open http://localhost:3000 to view the app.

---

🙏 Final Words

This isn't just a tool I built — it's a tool that helped me rebuild how I work.

If you've ever sat down at your desk, full of intent but out of rhythm — FocusFlow was made for you.

"Focus is earned. We just make the environment worthy of it."

---