# Focus Better

> Focus sessions and habits, without the noise. An offline-first productivity platform featuring event-sourced timers, atomic habit tracking, project milestone boards, and Mount Olympus expedition gamification.

Focus Better combines deep-work timers, habit consistency streaks, project execution, and non-intrusive gamification into a unified, high-performance web and desktop platform.

## Core Capabilities

- [Focus Timers](https://app.focusbetter.io/focus): Event-sourced countdown and flow timers with ambient soundscapes, pause/resume accounting, and task linking.
- [Atomic Habits](https://app.focusbetter.io/habits): Habit tracking with target frequencies, streaks, and freeze tokens.
- [Projects & Tasks](https://app.focusbetter.io/projects): Portfolio view, kanban roadmap, milestones, ideas, and activity audit trails.
- [Expedition & Gamification](https://app.focusbetter.io/expedition): Mount Olympus progression, Summit Coins, Momentum execution scoring, and basecamp rewards.
- [Calendar Integration](https://app.focusbetter.io/calendar): Google Calendar two-way sync and iCalendar RRULE projections.
- [Offline-First Engine](https://app.focusbetter.io): Durable IndexedDB offline queue with optimistic updates and replay idempotency.

## Technology Stack

- **Frontend**: Next.js 16 (App Router), React 19, TypeScript, Tailwind CSS v4, Motion
- **Backend**: NestJS, Fastify, Prisma ORM, PostgreSQL, pg-boss background worker
- **Authentication**: NextAuth v5 (credentials + Google OAuth)
- **Deployment**: Vercel (Web), AWS EC2 + RDS PostgreSQL + S3 + CloudFront (Backend)

## Optional

- [Privacy Policy](https://app.focusbetter.io/privacy): Complete privacy disclosures, data processing terms, and Google API Limited Use compliance statement.
- [Terms of Service](https://app.focusbetter.io/terms): Legally binding terms of service, platform license, and user agreement.
- [Full System & Architecture Spec](https://app.focusbetter.io/llms-full.txt): Complete technical architecture, data models, scoring formulas, and API documentation for AI answer engines.