Documentation

The core flow. Add a title and description, then hit Start. Pause anytime, resume when ready. Stop ends the session and lets you publish it.

Hours, minutes, seconds displayed in large Inter Tight typography. The display scales automatically to fit your screen width.

A pulsing LED dot next to the timer. Green = running, yellow = paused. Visual confirmation at a glance without reading the numbers.

Every action (start, pause, resume, stop) is logged with a timestamp. Add manual stages during a session to mark milestones. Each stage has an editable note and a duration badge.

Countdown timer with presets: 25, 50, or 90 minutes. A circular SVG ring shows progress. When done, a smart break is suggested (5, 10, or 20 min). Browser notification + audio alert.

Interval sound alerts at 15, 30, or 60 minutes. Generated in-browser via Web Audio API -- no external files. Works on all platforms including iOS Safari.

Define projects, categories, and tags before or during a session. These labels are associated with the session and used for filtering in History and Dashboard.

A task list available while the timer runs. Add, check off, and delete tasks. Keeps your focus on what needs to get done during the session.

Free-text scratchpad. Auto-saves 700ms after you stop typing. Quick thoughts and reminders without leaving the timer view.

After stopping a session, rate how it felt: Hard, Ok, or Great. The mood is saved with the session and can be used to filter in Dashboard.

Before each new session starts, a window asks for your session intention or focus. Helps frame the work ahead. Enable it in Settings > Preferences.

After stopping a session, a mini-journal appears before publishing. A moment to reflect. Enable it in Settings > Preferences.

After 2 hours 30 minutes without any interaction, a warning appears. No response in 30 minutes = auto-pause. Prevents forgotten sessions running all night.

Scan a QR code from the stage journal to move the active session to another device instantly. The token expires after 60 seconds for security.

Sessions persist across refreshes and devices. The timer syncs state every 30 seconds + on every action. Open timer.design on any device and pick up where you left off.

Current conditions and temperature for your location. Updates automatically. Displayed as a compact card below the timer.

On the web: an ad-free YouTube player below the timer, with built-in presets (lofi, ambient, classical) or your own YouTube links. In the mobile app: plays audio files from your phone, chosen from Files, with playlist and loop. No ads, no recommendations, no distractions.

Personal event calendar. Add events with title, description, date, and time. Events show on a calendar view with month navigation.

Display time in 3 timezones simultaneously. Click any slot to change the city. Useful for remote teams or international collaboration.

Set a one-time alarm for a specific time. Browser notification + audio alert when the alarm fires. Independent of the timer.

Inspirational quotes displayed as a widget card. A curated collection that rotates with each session.

Quick currency conversion widget. Select base and target currencies, get live exchange rates. Useful for freelancers working with international clients.

Sessions load progressively as you scroll. No pagination, no "load more" buttons. Your entire work history is one continuous feed.

Filter sessions by time range: last 24 hours, 7 days, 30 days, or 12 months. See exactly what you worked on in any period.

Assign color-coded labels to sessions. Create labels in the timer panel. Use them to categorize work by project, client, or type.

Expand any session to see the full stage journal: every start, pause, resume, manual stage, and their notes and duration badges.

Export sessions as JSON (full data with stage journal) or CSV (line-by-line, ready for Excel or AI). Available in two modes: daily export for a single day, or total export for your entire history.

Write free-form journal entries separate from timer sessions. Add a title and description. They persist and appear in chronological order.

Add custom tags to any journal entry. Use them to categorize your notes by topic, mood, or project. Tags are searchable and filterable.

If you don't attach a specific image to an entry, the app generates one automatically. Every entry has a visual identity.

Older entries load automatically as you scroll down. No pagination -- your entire journal is one continuous feed.

Every entry can be edited inline or deleted. Changes are saved immediately to the server.

If you start writing a journal entry and navigate away, the title and description are saved locally. Come back and your draft is still there.

Total hours, total sessions, average duration, longest session. A hero card with shader animation shows the headline stats. Filtered or global.

How many consecutive days you have used the timer. The streak widget counts your daily discipline and displays it prominently.

Filter all statistics by project, category, tag, day of the week, mood (Hard / Ok / Great), or time period. Combine filters to drill into specific patterns.

Automatic weather and location data captured with each session. See how your productivity correlates with conditions and places.

A visually designed card with your stats (total hours, sessions, streak). Share it as an image on social media or with your team.

Toggle each widget on or off. Disabled widgets are hidden from the timer view. The timer widget itself cannot be disabled.

Toggle inactivity warning (auto-pause after 3h of no activity), session intention modal, and gratitude journal.

Choose between 6 animated shader themes: Sunset, Accent, Warm, Cool, Clean, and Interstellar. The theme colors the animated background behind all cards.

Choose between Cloud (synced across devices, automatic backup) and Local (browser-only, no server sync). Switch anytime -- your data migrates automatically.

6 languages: Romanian, English, German, Spanish, Russian, Chinese. The interface switches instantly. Your data stays unchanged.

Update your first name, last name, and display name. These appear on your shareable stats card.

First-time users see a 5-step guided setup: intro, language selection, welcome, widget picker, and data mode selection. Runs once, never again.

All session titles, descriptions, journal entries, and notes are encrypted with AES-256-GCM before being stored in the database. Even a database administrator cannot read your content.

CSRF protection with nonce tokens, honeypot fields, minimum submission time check, and per-IP rate limiting (10 login attempts per 5 min, 3 registrations per hour).

Each device is identified by a unique local ID. Only the device that owns the session can modify it. Takeover requires explicit user action.

Keep all data exclusively in your browser. Nothing is sent to the server. Full privacy for sensitive work.