World Focus

Demo

https://github.com/user-attachments/assets/6097f47b-d045-44a1-a0e8-4547647c785d

What it does

• Focus timer — Focus, Short break, and Long break modes with Classic, Deep 50, Flow 90, or custom presets.
• Live atmospheres — Curated YouTube live views across cities, nature, and focus scenes; favorites, custom streams, temporary quarantine, and retry fallback.
• Session planning — Tasks, due dates, estimated sessions, subtasks, routines, calendar blocks, and temporary shared rooms.
• Audio — Official Lofi Girl YouTube radio with active-broadcast discovery, locally generated rain, or optional Spotify playback.
• Insights — Total hours, completed sessions, streaks, 28-day consistency, period charts, achievements, and CSV/JSON export.
• Local-first — Works without an account or Supabase configuration using browser persistence; guest settings and active sessions survive reload. After the first online load, the app shell, lazy views and sounds are available offline. Supabase sync is optional.

Screenshots

Tech stack

• React 19 + Vite
• Vanilla CSS with a responsive glass UI
• Supabase for optional auth, sync, and shared sessions
• Vercel serverless validation for live YouTube streams
• Vitest + Testing Library for unit and UI tests

Run locally

git clone https://github.com/amassias/Pomodoro.git
cd Pomodoro
npm install
npm run dev

Open http://localhost:5173.

Useful checks:

npm run lint
npm run test:run
npm run build

Quality and current limitations

See the checked backlog and the full validation report for tested flows, release checks and integration limits.

Optional integrations

Supabase auth and sync

Create .env.local at the repository root:

VITE_SUPABASE_URL=https://YOUR_PROJECT_REF.supabase.co
VITE_SUPABASE_ANON_KEY=YOUR_SUPABASE_ANON_PUBLIC_KEY

Run supabase/user_state.sql in the Supabase SQL editor. For an existing database with the feedback table, also apply supabase/quality_hardening.sql to restrict client privileges. Then add these redirect URLs:

• http://localhost:5173/auth-callback
• https://pomodoro-khaki-one.vercel.app/auth-callback

Never expose a Supabase service_role key in the frontend.

Spotify

Add /spotify-callback to the Spotify application redirect URIs, then connect from Settings → Music Provider → Spotify. Spotify Web Playback requires a Premium account; authentication uses PKCE and does not require a client secret in the frontend.

Keyboard shortcuts

Key	Action
Space	Start or pause the timer
R	Reset the timer
M	Mute or unmute sounds
Esc	Close settings or Insights

Project structure

api/              Vercel serverless functions
docs/             Product notes, performance docs, sources, and media
public/           Static assets, sounds, icons, and service worker
supabase/         Database schema
src/
  app/             Application shell
  features/        Timer, tasks, atmospheres, audio, Insights, settings…
  hooks/           Shared React hooks
  lib/             Pure logic and colocated tests
  providers/       Auth, user data, and shared-session state

License

MIT — see LICENSE.

Latest delivery

Backlog and activation status · 15 October implementation and checks · iPhone app and widget setup.