bytelyst/learning_ai_clock
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity

docs: add industry research and update PRD v0.2 with competitive analysis

Browse Source 
- Add INDUSTRY_RESEARCH.md: market sizing, 9 competitors, 24 feature demands, trends
- Update PRD to v0.2: Next.js 16 + React 19 + TailwindCSS v4 stack
- Add visual timeline, Pomodoro, neurodivergent mode, AI reschedule features
- Promote iOS + Apple Watch to v1.0, add new v1.1 context phase
- Expand competitive analysis (Tiimo, Structured, Alarmy, TickTick, Forest, etc.)
- Add risk assessment section, revised monetization (Family tier)
- Update development phases to realistic 11-week roadmap
This commit is contained in:
saravanakumardb1 2026-02-27 16:57:47 -08:00
parent 67e17609ca
commit a9dc99ec23
2 changed files with 482 additions and 109 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

262
docs/INDUSTRY_RESEARCH.md Normal file
View File

@ -0,0 +1,262 @@
# ChronoMind — Industry Research & Feature Analysis
> **Date:** February 2026
> **Purpose:** Validate ChronoMind's positioning, identify gaps, and recommend feature adjustments based on the current market landscape.
---
## 1. Market Overview
### 1.1 Market Size & Growth
| Segment | 2025 Value | Projected (2033-34) | CAGR |
|---------|-----------|---------------------|------|
| **Productivity Apps** | $13.15B | $30.85B (2034) | 9.94% |
| **Alarm Clock (Hardware + Software)** | $3.2B | $4.5B (2033) | 4.0% |
| **Smart Alarm Clock** | $2.1B | $4.1B (2033) | 7.6% |
**Key takeaway:** The productivity app market is exploding at nearly 10% CAGR, driven by AI integration and wellness trends. Smart alarm/timer apps are a growing niche within this. ChronoMind sits at the intersection of both — a high-growth sweet spot.
### 1.2 Macro Trends Shaping This Space (2025-2026)
1. **AI-First Scheduling** — Reclaim.ai, Motion, and Tiimo have proven that users will pay for AI that manages their time. Over 1,000 parameters drive Motion's scheduling engine. Reclaim auto-schedules focus time, habits, and meetings.
2. **Neurodivergent-First Design** — Tiimo won Apple's **iPhone App of the Year 2025**. Built for ADHD/autistic users, it uses visual timers, gentle structure, and AI replanning. Over 3M downloads. The message: accessibility-first design wins the mainstream market too.
3. **Visual Time = Usable Time** — Structured (millions of users across iOS/Android/Mac) proved that a visual timeline > a flat list. Users want to *see* their day, not read it.
4. **Gamification for Focus** — Forest has 2M+ paying users and planted 1.5M real trees. Gamified focus timers drive engagement and retention far beyond simple countdowns.
5. **Wellness Integration** — Sleep tracking, morning routines, wind-down routines, and "wellness stacking" are mainstream. Alarmy (75M users) evolved from a loud alarm app to a "wellness app for waking up" with sleep tracking and mood tracking.
6. **Notification Fatigue** — Users are overwhelmed. Apps like Opal block distracting notifications. ChronoMind's cascade pre-warnings must be *smart*, not spammy. Adaptive frequency based on user behavior is essential.
7. **Live Activities & Widgets** — iOS Live Activities (Dynamic Island), Apple Watch complications, and Android widgets are now expected for timer apps. They provide glanceable status without opening the app.
8. **PWA Maturity** — PWA notifications are now supported on iOS (since 16.4), Android, and all desktop browsers. Tooling (Workbox, next-pwa) is mature. However, iOS PWA notifications still require home screen installation and are less reliable than native push — a known limitation.
9. **AI Replanning** — Structured 4.0 introduced "AI reschedule" — if you sleep in, AI automatically shifts your day. This is the direction: adaptive, forgiving time management.
10. **Body Doubling & Social Accountability** — Virtual co-working and shared focus sessions are growing (Focusmate, Flown). Collaborative/shared timers have untapped potential.
---
## 2. Competitive Landscape (Deep Analysis)
### 2.1 Direct Competitors
| App | Users | Pricing | Key Strengths | Key Weaknesses |
|-----|-------|---------|---------------|----------------|
| **Tiimo** | 3M+ | Free / $5.99/mo | iPhone App of Year 2025, AI planner, visual timeline, neurodivergent-first, Apple Watch | No pre-warning cascade, no linked timers, no cooking/utility timer focus |
| **Structured** | Millions | Free / $2.49/mo | Beautiful timeline, Pomodoro, Live Activities, cross-platform (iOS/Android/Mac) | No AI, no pre-warnings, no travel time, no shared timers |
| **Alarmy** | 75M | Free / $4.99/mo | Massive user base, sleep tracking, mission-based wakeup, mood tracker | Wake-up focused only, no countdown timers, no routines, no pre-warnings |
| **TickTick** | 10M+ | Free / $3.99/mo | All-in-one (tasks + calendar + Pomodoro + habits), Eisenhower matrix | Jack of all trades, timer is secondary feature, overwhelming for simple use |
| **Forest** | 2M+ paid | $3.99 one-time | Gamified focus, real tree planting, browser extension | Focus-only, no alarms, no routines, no pre-warnings |
| **Routinery** | 1M+ | Free / $4.99/mo | Step-by-step timed routines, habit building, morning/evening focus | Routine-only, no general timers, no pre-warnings, no calendar sync |
| **Due** | Premium | $7.99 one-time | Persistent re-reminders until acted on, auto-snooze | iOS/Mac only, dated UI, no routines, no urgency levels |
| **Focus (iOS)** | Popular | Free / $4.99 | Pomodoro, Apple Watch, Siri Shortcuts, Apple Intelligence | Focus-only, no general purpose timer |
### 2.2 Adjacent Competitors (AI Scheduling)
| App | Pricing | Relevance to ChronoMind |
|-----|---------|------------------------|
| **Reclaim.ai** | Free / $8/mo | AI auto-schedules focus time, habits, meetings. No timer/alarm function. |
| **Motion** | $19/mo | AI project manager + calendar. Over-engineered for simple timers. |
| **Morgen** | Free / $9/mo | Unified calendar with time blocking. No timer/alarm. |
### 2.3 Competitive Gap Analysis
**What NO existing app does (ChronoMind's unique opportunity):**
| Gap | Who comes closest | ChronoMind advantage |
|-----|-------------------|---------------------|
| Pre-warning cascade with urgency levels | Due (persistent reminders) | Configurable multi-step cascade tied to urgency — not just "nag until done" |
| Linked/chained timers | None | Cooking, project workflows, event coordination |
| Routines + general timers in one app | Routinery (routines only) or TickTick (timers secondary) | First-class for both use cases |
| Prep time + travel time intelligence | Google Calendar (basic) | Integrated into timer warnings, not just calendar events |
| Context-aware timer ("why" not just "when") | Tiimo (labels + AI), Motion (project context) | Timer-native context with intelligent pre-warning messages |
| Adaptive snooze learning | None | Learn patterns, suggest time adjustments |
| Web-first PWA (no app store friction) | None in this category | Instant access, no install, works everywhere |
---
## 3. Feature Demand Analysis
Based on research across app store reviews, Reddit discussions, and market trends, here are the most in-demand features ranked by user desire:
### 3.1 HIGH DEMAND (Must-Have for 2026)
| # | Feature | Evidence | Impact |
|---|---------|----------|--------|
| 1 | **Visual Timeline** | Structured & Tiimo's success; users want to *see* their day | Core UX differentiator |
| 2 | **AI Natural Language Input** | Every major productivity app now has AI input (Tiimo, TickTick, Motion) | Table stakes by 2026 |
| 3 | **Calendar Import/Sync** | #1 requested feature in timer/planner app reviews | Eliminates double-entry friction |
| 4 | **Apple Watch / Wearable Support** | Expected for any timer app; Live Activities on iOS | Glanceable, always-on timers |
| 5 | **Widgets (iOS/Android/Desktop)** | Structured, Tiimo, Forest all have widgets | Surface timers without opening app |
| 6 | **Focus/DND Integration** | Opal, Forest, iOS Focus Modes | Timer-aware notification blocking |
| 7 | **Dark + Light Theme** | No longer optional — both are expected | Accessibility requirement |
| 8 | **Neurodivergent-Friendly Design** | Tiimo's App of the Year win validates this massively | Visual cues, gentle structure, flexibility |
| 9 | **Haptic/Sound Customization** | Alarmy, Focus apps all offer rich sound libraries | Urgency differentiation |
| 10 | **Offline-First** | Universal expectation for timer/alarm apps | Non-negotiable for reliability |
### 3.2 MEDIUM DEMAND (Strong Differentiators)
| # | Feature | Evidence | Impact |
|---|---------|----------|--------|
| 11 | **AI Reschedule/Replan** | Structured 4.0's killer feature — "I slept in, fix my day" | Forgiveness-first UX |
| 12 | **Location-Based Reminders** | GPS Alarm, MyLifeOrganized; 1M+ downloads for GPS alarm apps | Context-aware triggers |
| 13 | **Gamification Elements** | Forest's 2M+ paid users; streaks, rewards, progress visualization | Retention driver |
| 14 | **Sleep/Wake Integration** | Alarmy's evolution to wellness; Sleep Cycle's AI sleep coach | Natural extension of alarm functionality |
| 15 | **Mood/Energy Tracking** | Alarmy added mood tracking; wellness stacking trend | Contextualizes timer effectiveness |
| 16 | **Cross-Device Sync** | Structured, Tiimo — users expect seamless multi-device | Cloud sync (optional, privacy-first) |
| 17 | **Keyboard Shortcuts / CLI** | Power user demand on Reddit and HN | Developer/power user appeal |
| 18 | **Pomodoro as First-Class** | Every focus app has this; Structured, TickTick, Forest | Expected, not differentiating alone |
### 3.3 EMERGING DEMAND (Future Differentiators)
| # | Feature | Evidence | Impact |
|---|---------|----------|--------|
| 19 | **AI Context Suggestions** | "You have a gap, want to schedule focus?" — Motion does this | Proactive intelligence |
| 20 | **Voice Control (Beyond Siri/Google)** | In-app voice: "Push everything back 30 minutes" | Hands-free operation |
| 21 | **Shared/Family Timers** | Family calendar apps growing; no shared timer app exists | Unique market position |
| 22 | **Body Doubling / Social Focus** | Growing ADHD community demand; Focusmate, Flown | Social accountability |
| 23 | **Webhook/API Integration** | Developer market; Zapier/IFTTT integration | Automation market |
| 24 | **Smart Home Integration** | Alexa, HomeKit, Google Home — trigger lights, music | Ambient awareness |
---
## 4. How ChronoMind Fits the Modern Fast-Paced Lifestyle
### 4.1 The Problem is Bigger Than Alarms
The modern professional/parent/student doesn't just need reminders — they need **time awareness infrastructure**. Consider a typical day:
- 6:30 AM — Wake up (alarm)
- 7:00 AM — Morning routine (routine timer)
- 8:30 AM — Commute (travel time awareness)
- 9:00 AM — Standup meeting (calendar event + prep warning)
- 10:00-12:00 — Deep work (focus mode + Pomodoro)
- 12:30 PM — Lunch with friend (travel + prep time)
- 2:00 PM — Kid's school pickup (CRITICAL, travel-aware)
- 3:00 PM — Pasta for dinner (linked cooking timers)
- 6:00 PM — Wind-down routine (evening routine timer)
**No single app handles all of this today.** People use 3-5 apps: Clock, Calendar, Pomodoro timer, Routine app, Cooking timer. ChronoMind can be the **unified time awareness layer**.
### 4.2 Why This Matters NOW (2026)
1. **Remote/Hybrid Work** — No office cues (coworker walking to meeting room). People need intelligent pre-warnings more than ever.
2. **Attention Economy** — Average attention span is shrinking. Pre-warnings help people transition between contexts smoothly.
3. **AI Expectations** — Users now expect AI to manage, not just remind. "Fix my schedule" is the new "set an alarm."
4. **Wellness-First** — Burnout is mainstream. Gentle urgency levels and focus modes align with the wellness zeitgeist.
5. **Neurodivergent Awareness** — 15-20% of the population is neurodivergent. ADHD time-blindness makes pre-warning cascades not just useful but essential.
### 4.3 ChronoMind's Unique Value Proposition (Refined)
> **ChronoMind is the first time-awareness app that understands *why* you set a timer, *how urgently* it matters, and *what you need to do to prepare* — with AI-powered pre-warning cascades, visual timelines, and routine orchestration.**
**Positioning:** Not a clock app. Not a calendar app. Not a Pomodoro app. A **time awareness layer** that sits alongside your calendar and makes sure you're never caught off-guard.
---
## 5. Recommended Changes to PRD
### 5.1 Tech Stack Updates
| Current PRD | Recommendation | Rationale |
|-------------|---------------|-----------|
| Next.js 14, Pages Router | **Next.js 16, App Router** | Next.js 16 is stable in 2026, App Router is the standard, better PWA support with Server Components |
| React 18 | **React 19** | Current stable version, needed for Next.js 16 |
| CSS custom properties only | **TailwindCSS v4 + CSS custom properties** | Faster development, consistent design system, v4 is lightweight |
| No component library | **shadcn/ui** | Accessible, beautiful, themeable components out of the box |
| No icons specified | **Lucide React** | Lightweight, consistent icon set |
| date-fns | **date-fns** (keep) | Still the best lightweight option |
| next-pwa | **@serwist/next** (Serwist) | next-pwa is unmaintained; Serwist is the active successor for Next.js PWA |
### 5.2 New Features to Add (MVP)
| Feature | Why MVP | Effort |
|---------|---------|--------|
| **Visual Timeline (vertical)** | Core UX — proven by Structured/Tiimo | Medium |
| **Light Theme + System Preference** | Accessibility expectation in 2026 | Low |
| **Pomodoro as first-class timer type** | Expected, not just a routine hack | Low |
| **iOS-style Live Activity simulation** | Glanceable timer in browser tab title | Low |
| **Contextual pre-warning messages** | AI-generated "Have you packed?" style messages | Medium |
| **Import from .ics / calendar URL** | Reduces friction for existing calendar users | Medium |
### 5.3 Features to Promote (from v2 to v1)
| Feature | Why Earlier | Rationale |
|---------|-------------|-----------|
| **Calendar sync (Google/Apple)** | Users won't adopt without it | Double-entry is the #1 adoption killer |
| **Apple Watch / wearable** | Timer apps live on the wrist | Table stakes for timer category |
| **Widgets** | Surface timers without opening app | Structured/Tiimo proved this is essential |
### 5.4 New Features to Add (v1-v2)
| Feature | Phase | Rationale |
|---------|-------|-----------|
| **AI Reschedule** ("I slept in, fix my day") | v1.0 | Structured's killer feature; forgiveness-first UX |
| **Location-based triggers** | v1.1 | "Remind me when I leave home" — context-aware |
| **Gamification** (streaks, focus scores) | v1.0 | Forest proved this drives retention |
| **Neurodivergent mode** (visual timers, gentle transitions) | v1.0 | Tiimo's App of Year win; huge underserved market |
| **Mood/energy check-in** | v1.1 | Contextualizes productivity; wellness trend |
| **Smart Home triggers** (webhooks to HomeKit/Alexa) | v2.0 | "Dim lights when wind-down routine starts" |
| **Body doubling / shared focus** | v2.0 | Growing demand in ADHD community |
| **Sleep integration** | v1.1 | Natural extension; alarm → sleep → wake cycle |
### 5.5 Naming Consideration
"ChronoMind" is solid but consider:
- **Nudge** was dismissed as "generic" — but it's actually perfect for the pre-warning concept and very memorable. Reconsider.
- **Cadence** — implies rhythm, routine, timing. Modern feel.
- **Headstart** — captures the prep-time / pre-warning essence.
- **Prelude** — "before the main event" — elegant, unique.
### 5.6 Monetization Adjustment
| Current PRD | Recommendation |
|-------------|---------------|
| Free / Pro $4/mo / Team $8/user/mo | **Free / Pro $3.99/mo or $29.99/yr / Family $5.99/mo** |
Rationale: Team pricing is premature. Family/household shared timers is the real v2 monetization path. $3.99/mo is the market standard (Structured $2.49, Routinery $4.99, Tiimo $5.99).
---
## 6. Risk Assessment
| Risk | Severity | Mitigation |
|------|----------|------------|
| **PWA notification unreliability on iOS** | High | Tab title updates, aggressive testing, native app fast-follow |
| **Feature creep** — too many timer types | High | Strict MVP scope; add types based on usage data |
| **AI costs** for NL input and suggestions | Medium | Local regex for MVP; LLM only for complex queries |
| **Calendar sync complexity** (OAuth, token refresh) | Medium | Start with .ics import (read-only), full sync in v1.1 |
| **Competition from Tiimo/Structured adding pre-warnings** | Medium | Move fast; pre-warning cascade is not trivial to implement well |
| **User overwhelm** — too many options per timer | Medium | Smart defaults; progressive disclosure (simple → advanced) |
---
## 7. Summary & Verdict
**ChronoMind occupies a genuine market gap.** No existing app combines:
- Pre-warning cascades
- Urgency-aware notifications
- Routine orchestration
- Context-aware intelligence
- Visual timeline
The closest competitors (Tiimo, Structured) are planners that happen to have timers. ChronoMind is a **timer that happens to be intelligent** — a fundamentally different approach.
**The 2026 market is ready for this:**
- AI scheduling is mainstream (Reclaim, Motion)
- Visual time management won App of the Year (Tiimo)
- Neurodivergent-first design wins mainstream users
- PWA tech is mature enough for MVP
- Wellness + productivity convergence demands intelligent time awareness
**Recommended priority order:**
1. Ship MVP PWA with pre-warning cascades, visual timeline, quick timers
2. Add AI NL input, routines, Pomodoro, calendar import (v1.0)
3. Native apps (iOS first), Apple Watch, widgets, shared timers (v1.1-v2.0)
**Confidence level: HIGH** — this product has a clear, defensible niche with real user demand.

329
docs/PRD.md
View File

@ -2,9 +2,10 @@
> **Product:** ChronoMind > **Product:** ChronoMind
> **Repo:** `learning_ai_clock` > **Repo:** `learning_ai_clock`
> **Version:** 0.1 (MVP) > **Version:** 0.2 (MVP — revised after industry research)
> **Date:** February 2026 > **Date:** February 2026
> **Author:** Saravana > **Author:** Saravana
> **Research:** See [INDUSTRY_RESEARCH.md](INDUSTRY_RESEARCH.md) for full competitive analysis
--- ---
@ -16,7 +17,13 @@
## 2. Vision ## 2. Vision
**ChronoMind** is a context-aware, AI-augmented clock/timer application that understands *why* you set a timer — not just *when*. It provides intelligent pre-warnings, adaptive escalation, routine orchestration, and natural language interaction. It bridges the gap between dumb alarms and full calendar apps by focusing on one thing: **making sure you never miss what matters, and always have time to prepare.** **ChronoMind** is a context-aware, AI-augmented **time awareness layer** that understands *why* you set a timer — not just *when*. It provides intelligent pre-warnings, adaptive escalation, routine orchestration, and natural language interaction. It bridges the gap between dumb alarms and full calendar apps by focusing on one thing: **making sure you never miss what matters, and always have time to prepare.**
### Market Context (2026)
The productivity app market is valued at **$13.15B (2025)** growing to **$30.85B by 2034** at 9.94% CAGR. Tiimo (visual planner) won **Apple's iPhone App of the Year 2025**, validating that visual, AI-powered time management is mainstream. Structured has millions of users with its timeline-first approach. Yet **no existing app combines pre-warning cascades + urgency intelligence + routine orchestration + visual timelines in a single product.**
ChronoMind is not a clock app. Not a calendar app. Not a Pomodoro app. It's a **time awareness layer** that sits alongside your calendar and makes sure you're never caught off-guard.
### The Problem with Current Timers & Clocks ### The Problem with Current Timers & Clocks
@ -35,6 +42,9 @@
| **No adaptive snooze** | Fixed 5/10min snooze | Snooze learns: "You always snooze this one 3 times — should I set it 15min earlier?" | | **No adaptive snooze** | Fixed 5/10min snooze | Snooze learns: "You always snooze this one 3 times — should I set it 15min earlier?" |
| **No focus integration** | Timer has no concept of deep work | "Block notifications for 90min, warn me 10min before standup" | | **No focus integration** | Timer has no concept of deep work | "Block notifications for 90min, warn me 10min before standup" |
| **No voice** | Visual-only or basic "Hey Siri" | Full voice control: "What's my next timer?" / "Push everything back 30 minutes" | | **No voice** | Visual-only or basic "Hey Siri" | Full voice control: "What's my next timer?" / "Push everything back 30 minutes" |
| **No visual timeline** | Flat list of alarms | Structured vertical timeline showing your entire day at a glance |
| **No AI replanning** | Missed alarm = chaos | "I slept in 30 min — reschedule my morning" |
| **No neurodivergent support** | One-size-fits-all | Visual timers, gentle transitions, ADHD time-blindness support |
--- ---
@ -42,13 +52,16 @@
| Phase | Platform | Tech Stack | | Phase | Platform | Tech Stack |
|-------|----------|------------| |-------|----------|------------|
| **MVP** | Web app (PWA) | Next.js 14, React 18, CSS custom properties | | **MVP** | Web app (PWA) | Next.js 16 (App Router), React 19, TailwindCSS v4 + shadcn/ui |
| **v1.1** | macOS menu bar | Tauri or SwiftUI | | **v1.0** | iOS app + Apple Watch | SwiftUI (native), WidgetKit, Live Activities |
| **v1.2** | iOS app | SwiftUI (native) | | **v1.1** | macOS menu bar | SwiftUI (native, shared code with iOS) |
| **v2.0** | Android | Jetpack Compose | | **v2.0** | Android + Wear OS | Jetpack Compose, Glance widgets |
| **v2.0** | Windows | Tauri | | **v2.0** | Windows | Tauri |
> **MVP is web-first** — works on any device, installable as PWA with notification support. > **MVP is web-first** — works on any device, installable as PWA with notification support.
> **v1.0 fast-follows with iOS** — timer apps live on the wrist; Apple Watch is table stakes in 2026.
>
> **PWA notification note:** iOS PWA push notifications are supported since iOS 16.4 but require home screen installation and are less reliable than native push. Tab title countdown is used as a supplementary signal. Native iOS app is prioritized for v1.0 to ensure alarm reliability.
--- ---
@ -60,11 +73,12 @@
|------|-------------|---------| |------|-------------|---------|
| **Alarm** | Fires at a specific date/time | "Wake up at 6:30 AM" | | **Alarm** | Fires at a specific date/time | "Wake up at 6:30 AM" |
| **Countdown** | Fires after a duration | "Timer for 25 minutes" | | **Countdown** | Fires after a duration | "Timer for 25 minutes" |
| **Pomodoro** | Focus session with work/break intervals | "4 rounds × 25min work / 5min break" |
| **Event Countdown** | Days/hours until a future date | "14 days until vacation" | | **Event Countdown** | Days/hours until a future date | "14 days until vacation" |
| **Routine** | Ordered sequence of timed steps | "Morning routine (5 steps, 75 min total)" | | **Routine** | Ordered sequence of timed steps | "Morning routine (5 steps, 75 min total)" |
| **Linked Timer** | Timer that triggers another timer | "When pasta timer ends, start sauce timer" | | **Linked Timer** | Timer that triggers another timer | "When pasta timer ends, start sauce timer" |
| **Recurring** | Repeats on a schedule | "Every weekday at 9:00 AM" | | **Recurring** | Repeats on a schedule | "Every weekday at 9:00 AM" |
| **Shared** | Visible/controllable by multiple people | "Family dinner timer" | | **Shared** | Visible/controllable by multiple people | "Family dinner timer" (v2) |
### 4.2 Urgency Levels ### 4.2 Urgency Levels
@ -156,47 +170,67 @@ Example: Dentist at 2:00 PM
| 2 | **Create countdown** | P0 | Set duration, label, urgency level | | 2 | **Create countdown** | P0 | Set duration, label, urgency level |
| 3 | **Pre-warning cascade** | P0 | Configure cascade per timer (presets + custom) | | 3 | **Pre-warning cascade** | P0 | Configure cascade per timer (presets + custom) |
| 4 | **Urgency levels** | P0 | 5 levels controlling notification style | | 4 | **Urgency levels** | P0 | 5 levels controlling notification style |
| 5 | **Active timers dashboard** | P0 | See all timers, sorted by "next to fire" | | 5 | **Visual timeline dashboard** | P0 | Vertical timeline (à la Structured/Tiimo) showing your day at a glance |
| 6 | **Browser notifications** | P0 | Push notifications via Web Notifications API | | 6 | **Browser notifications** | P0 | Push notifications via Web Notifications API + Service Worker |
| 7 | **Sound alerts** | P0 | Multiple alarm sounds, volume per urgency | | 7 | **Sound alerts** | P0 | Multiple alarm sounds, volume per urgency, haptic patterns |
| 8 | **Snooze / dismiss** | P0 | Snooze with configurable duration, dismiss with confirmation for CRITICAL | | 8 | **Snooze / dismiss** | P0 | Snooze with configurable duration, dismiss with confirmation for CRITICAL |
| 9 | **Recurring timers** | P1 | Daily, weekday, weekly, monthly, custom cron | | 9 | **Quick timer** | P0 | One-tap presets: 5m, 15m, 25m (pomodoro), 1h |
| 10 | **Timer labels + notes** | P1 | Add context: "Call Dr. Smith — phone: 555-1234" | | 10 | **Pomodoro timer** | P0 | First-class focus sessions with work/break intervals and round tracking |
| 11 | **Dark mode** | P1 | Full dark theme (default) | | 11 | **Timer labels + notes** | P1 | Add context: "Call Dr. Smith — phone: 555-1234" |
| 12 | **PWA install** | P1 | Installable on mobile/desktop via browser | | 12 | **Dark + light theme** | P1 | Both themes with system preference detection (dark default) |
| 13 | **Local storage** | P1 | All data in IndexedDB — no account needed | | 13 | **PWA install** | P1 | Installable on mobile/desktop via browser |
| 14 | **Timer history** | P2 | Past timers log with stats | | 14 | **Local storage** | P1 | All data in IndexedDB — no account needed, offline-first |
| 15 | **Keyboard shortcuts** | P2 | Quick-create, navigate, snooze | | 15 | **Recurring timers** | P1 | Daily, weekday, weekly, monthly, custom cron |
| 16 | **Quick timer** | P0 | One-tap presets: 5m, 15m, 25m (pomodoro), 1h | | 16 | **Tab title countdown** | P1 | Show "⏱ 14:32 — Standup" in browser tab (compensates for PWA notification gaps) |
| 17 | **Keyboard shortcuts** | P2 | Quick-create, navigate, snooze |
| 18 | **Timer history** | P2 | Past timers log with stats |
| 19 | **Contextual pre-warning messages** | P1 | AI-generated messages like "Have you packed?" based on timer label/context |
### 5.2 v1.0 — Intelligence Layer ### 5.2 v1.0 — Intelligence + iOS
| # | Feature | Description | | # | Feature | Description |
|---|---------|-------------| |---|---------|-------------|
| 17 | **Natural language input** | "Remind me to call Mom at 3pm with 1 hour warning" | | 20 | **Natural language input** | "Remind me to call Mom at 3pm with 1 hour warning" (local regex MVP, LLM for complex) |
| 18 | **Routines** | Create ordered sequences of timed steps | | 21 | **Routines** | Create ordered sequences of timed steps |
| 19 | **Linked timers** | "When timer A ends, start timer B" | | 22 | **Linked timers** | "When timer A ends, start timer B" |
| 20 | **Prep time** | Add preparation buffer before any timer | | 23 | **Prep time** | Add preparation buffer before any timer |
| 21 | **Adaptive snooze** | Learn snooze patterns, suggest earlier alarm | | 24 | **Calendar import (.ics)** | Import from .ics files or calendar URL (read-only) — reduces double-entry friction |
| 22 | **Focus mode** | Block notifications, only allow CRITICAL through | | 25 | **Focus mode** | Block notifications, only allow CRITICAL through; integrates with OS DND |
| 23 | **Event countdowns** | "132 days until wedding" with milestone warnings | | 26 | **Event countdowns** | "132 days until wedding" with milestone warnings |
| 24 | **Categories / tags** | Work, Personal, Health, Cooking, etc. | | 27 | **Categories / tags** | Work, Personal, Health, Cooking, etc. |
| 25 | **Statistics** | How many timers set, snooze rate, on-time rate | | 28 | **Statistics + streaks** | Timers set, snooze rate, on-time rate, focus streaks, gamification elements |
| 29 | **Adaptive snooze** | Learn snooze patterns, suggest earlier alarm |
| 30 | **AI reschedule** | "I slept in 30 min — shift my morning" (Structured 4.0's killer feature) |
| 31 | **iOS native app** | SwiftUI, full notification support, reliable background alarms |
| 32 | **Apple Watch** | Complications, Live Activities on Dynamic Island, haptic pre-warnings |
| 33 | **iOS widgets** | Home screen + Lock Screen widgets showing next timer and countdown |
| 34 | **Neurodivergent mode** | Visual countdown rings, gentle transitions, time-blindness aids, reduced cognitive load |
### 5.3 v2.0 — Platform Expansion ### 5.3 v1.1 — Context & Sync
| # | Feature | Description | | # | Feature | Description |
|---|---------|-------------| |---|---------|-------------|
| 26 | **Shared timers** | Family/team timers visible to invited users | | 35 | **Calendar sync (full)** | Two-way sync with Google Calendar, Apple Calendar, Outlook |
| 27 | **Calendar sync** | Import from Google/Apple/Outlook calendars | | 36 | **Location-based triggers** | "Remind me when I leave home" — geofence-aware timers |
| 28 | **Travel time (live)** | Maps API integration for real-time estimates | | 37 | **Travel time (live)** | Maps API integration for real-time traffic estimates |
| 29 | **Voice control** | "What's my next alarm?" / "Push everything back 30 minutes" | | 38 | **Sleep integration** | Bedtime routine, wake-up intelligence, sleep quality tracking |
| 30 | **Native apps** | macOS menu bar, iOS, Android, Windows | | 39 | **Mood/energy check-in** | Quick post-timer mood check; contextualizes productivity patterns |
| 31 | **Watch complications** | Apple Watch, Wear OS | | 40 | **Cloud sync (optional)** | End-to-end encrypted cross-device sync, privacy-first |
| 32 | **Widgets** | iOS/Android home screen widgets | | 41 | **macOS menu bar** | SwiftUI, shared code with iOS app |
| 33 | **API** | REST API for programmatic timer management |
| 34 | **Zapier / webhooks** | Timer events trigger external actions | ### 5.4 v2.0 — Platform Expansion & Social
| 35 | **AI suggestions** | "You have a gap between 2-3pm, want to schedule focus time?" |
| # | Feature | Description |
|---|---------|-------------|
| 42 | **Shared timers** | Family/household timers visible to invited users |
| 43 | **Voice control** | "What's my next alarm?" / "Push everything back 30 minutes" |
| 44 | **Android + Wear OS** | Jetpack Compose, Glance widgets |
| 45 | **Windows** | Tauri desktop app |
| 46 | **API** | REST API for programmatic timer management |
| 47 | **Webhooks / Zapier** | Timer events trigger external actions |
| 48 | **Smart Home** | HomeKit/Alexa triggers: "Dim lights when wind-down routine starts" |
| 49 | **AI suggestions** | "You have a gap between 2-3pm, want to schedule focus time?" |
| 50 | **Body doubling** | Shared focus sessions with accountability partners |
--- ---
@ -350,22 +384,24 @@ SCREEN MAP
| Layer | Technology | Rationale | | Layer | Technology | Rationale |
|-------|-----------|-----------| |-------|-----------|-----------|
| **Framework** | Next.js 14 (Pages Router) | Fast, SSR for landing, PWA-friendly | | **Framework** | Next.js 16 (App Router) | Current stable, App Router is the standard, excellent PWA support with Server Components |
| **UI** | React 18 + CSS custom properties | No Tailwind — clean vanilla CSS like MindLyst web | | **UI** | React 19 + TailwindCSS v4 + shadcn/ui | Modern, accessible, themeable components; Lucide React for icons |
| **State** | Zustand | Lightweight, persists to IndexedDB | | **State** | Zustand | Lightweight, persists to IndexedDB |
| **Storage** | IndexedDB (via idb) | Offline-first, no backend needed for MVP | | **Storage** | IndexedDB (via idb) | Offline-first, no backend needed for MVP |
| **Notifications** | Web Notifications API + Service Worker | Works when app is backgrounded (PWA) | | **Notifications** | Web Notifications API + Service Worker | Works when app is backgrounded (PWA) |
| **Audio** | Web Audio API | Low-latency alarm sounds | | **Audio** | Web Audio API | Low-latency alarm sounds |
| **Time** | date-fns | Lightweight date manipulation | | **Time** | date-fns | Lightweight date manipulation |
| **PWA** | next-pwa | Service worker, offline support, installable | | **PWA** | @serwist/next (Serwist) | Active successor to next-pwa (unmaintained); service worker, offline, installable |
| **NL Parsing** | chrono-node (local) | Natural language date/time parsing without LLM dependency |
| **Testing** | Vitest + Playwright | Unit + E2E | | **Testing** | Vitest + Playwright | Unit + E2E |
| **Analytics** | Plausible (self-hosted) or PostHog | Privacy-first analytics for PWA install, feature adoption tracking |
### 8.2 Data Model ### 8.2 Data Model
```typescript ```typescript
interface Timer { interface Timer {
id: string; // UUID id: string; // UUID
type: 'alarm' | 'countdown' | 'event' | 'routine_step'; type: 'alarm' | 'countdown' | 'pomodoro' | 'event' | 'routine_step';
label: string; label: string;
notes?: string; notes?: string;
urgency: 'critical' | 'important' | 'standard' | 'gentle' | 'passive'; urgency: 'critical' | 'important' | 'standard' | 'gentle' | 'passive';
@ -476,41 +512,54 @@ Timer Engine (runs in Service Worker)
learning_ai_clock/ learning_ai_clock/
├── docs/ ├── docs/
│ ├── raw_idea.md # Original idea │ ├── raw_idea.md # Original idea
│ └── PRD.md # This document │ ├── PRD.md # This document
├── web/ # Next.js 14 web app │ └── INDUSTRY_RESEARCH.md # Market research & competitive analysis
├── web/ # Next.js 16 web app (App Router)
│ ├── src/ │ ├── src/
│ │ ├── pages/ # Pages Router │ │ ├── app/ # App Router
│ │ │ ├── index.tsx # Landing page │ │ │ ├── layout.tsx # Root layout (theme, providers)
│ │ │ ├── app.tsx # Main app (dashboard) │ │ │ ├── page.tsx # Landing page
│ │ │ ├── create.tsx # Create timer │ │ │ ├── (app)/ # App routes (authenticated/main)
│ │ │ ├── routines.tsx # Routines │ │ │ │ ├── layout.tsx # App shell layout (sidebar, header)
│ │ │ ├── focus.tsx # Focus / pomodoro │ │ │ │ ├── page.tsx # Dashboard (timeline + clock)
│ │ │ ├── history.tsx # Timer history │ │ │ │ ├── create/ # Create timer flow
│ │ │ └── settings.tsx # Settings │ │ │ │ ├── routines/ # Routines management
│ │ │ │ ├── focus/ # Pomodoro / focus mode
│ │ │ │ ├── history/ # Timer history & stats
│ │ │ │ └── settings/ # Settings & preferences
│ │ │ └── manifest.ts # PWA manifest (dynamic)
│ │ ├── components/ │ │ ├── components/
│ │ │ ├── Clock.tsx # Large analog/digital clock │ │ │ ├── ui/ # shadcn/ui components
│ │ │ ├── Clock.tsx # Large digital clock with glow
│ │ │ ├── TimerCard.tsx # Individual timer display │ │ │ ├── TimerCard.tsx # Individual timer display
│ │ │ ├── Timeline.tsx # Vertical timeline of upcoming │ │ │ ├── Timeline.tsx # Vertical visual timeline (core UX)
│ │ │ ├── QuickTimer.tsx # One-tap preset buttons │ │ │ ├── QuickTimer.tsx # One-tap preset buttons
│ │ │ ├── CascadeEditor.tsx# Pre-warning cascade config │ │ │ ├── CascadeEditor.tsx# Pre-warning cascade config
│ │ │ ├── PomodoroView.tsx # Pomodoro focus session UI
│ │ │ ├── RoutineEditor.tsx# Routine step editor │ │ │ ├── RoutineEditor.tsx# Routine step editor
│ │ │ ├── AlarmOverlay.tsx # Full-screen alarm (CRITICAL) │ │ │ ├── AlarmOverlay.tsx # Full-screen alarm (CRITICAL)
│ │ │ └── NLInput.tsx # Natural language input │ │ │ ├── NLInput.tsx # Natural language input bar
│ │ │ └── CountdownRing.tsx# Visual countdown ring (neurodivergent-friendly)
│ │ ├── lib/ │ │ ├── lib/
│ │ │ ├── timer-engine.ts # Core scheduling logic │ │ │ ├── timer-engine.ts # Core scheduling logic
│ │ │ ├── store.ts # Zustand store + IndexedDB │ │ │ ├── store.ts # Zustand store + IndexedDB persistence
│ │ │ ├── notifications.ts # Web Notifications wrapper │ │ │ ├── notifications.ts # Web Notifications + Service Worker wrapper
│ │ │ ├── sounds.ts # Web Audio API sounds │ │ │ ├── sounds.ts # Web Audio API sounds
│ │ │ ├── cascade.ts # Pre-warning cascade logic │ │ │ ├── cascade.ts # Pre-warning cascade logic
│ │ │ ├── recurrence.ts # Recurrence rule engine │ │ │ ├── recurrence.ts # Recurrence rule engine
│ │ │ └── nl-parser.ts # Natural language time parser │ │ │ ├── nl-parser.ts # Natural language time parser (chrono-node)
│ │ │ └── tab-title.ts # Browser tab title countdown updater
│ │ └── styles/ │ │ └── styles/
│ │ └── globals.css # Full design system │ │ └── globals.css # Tailwind base + custom properties
│ ├── public/ │ ├── public/
│ │ ├── sounds/ # Alarm sound files │ │ ├── sounds/ # Alarm sound files (.mp3/.ogg)
│ │ └── icons/ # PWA icons │ │ ├── icons/ # PWA icons (multiple sizes)
│ │ └── sw.js # Service worker (Serwist-generated)
│ ├── package.json │ ├── package.json
│ └── next.config.js │ ├── next.config.ts
│ ├── tailwind.config.ts
│ ├── components.json # shadcn/ui config
│ └── tsconfig.json
├── .gitignore ├── .gitignore
└── README.md └── README.md
``` ```
@ -565,39 +614,62 @@ The main clock display uses a large, beautiful monospaced font with a subtle glo
## 10. Competitive Analysis ## 10. Competitive Analysis
| Feature | iOS Clock | Google Clock | Alarmy | Due | Toggl Track | **ChronoMind** | ### 10.1 Feature Matrix
|---------|----------|-------------|--------|-----|-------------|----------------|
| Basic alarm | Yes | Yes | Yes | Yes | No | **Yes** |
| Countdown timer | Yes | Yes | No | Yes | Yes | **Yes** |
| Pre-warnings | No | No | No | No | No | **Yes (core)** |
| Urgency levels | No | No | Partial | No | No | **Yes** |
| Cascade config | No | No | No | No | No | **Yes** |
| Routines | No | No | No | No | No | **Yes** |
| Linked timers | No | No | No | No | No | **Yes** |
| Prep time | No | No | No | No | No | **Yes** |
| Travel time | No | No | No | No | No | **Yes** |
| Focus / pomodoro | No | No | No | No | Yes | **Yes** |
| Event countdowns | No | No | No | No | No | **Yes** |
| Natural language | Siri | Google | No | No | No | **Yes** |
| Shared timers | No | No | No | No | Yes (team) | **Yes (v2)** |
| Adaptive snooze | No | No | No | No | No | **Yes (v1)** |
| Web PWA | No | No | No | No | Yes | **Yes** |
| Offline-first | N/A | N/A | Yes | Yes | No | **Yes** |
| Free | Yes | Yes | Freemium | $7 | Freemium | **Yes** |
**ChronoMind's moat:** No existing app combines pre-warning cascades + routines + linked timers + urgency levels + focus mode in a single, beautiful, offline-first web app. Most clock apps are feature-frozen utility apps from the early smartphone era. | Feature | iOS Clock | Alarmy | Tiimo | Structured | TickTick | Routinery | Forest | Due | **ChronoMind** |
|---------|----------|--------|-------|-----------|---------|----------|--------|-----|----------------|
| Basic alarm | Yes | Yes | No | No | Yes | No | No | Yes | **Yes** |
| Countdown timer | Yes | No | No | Yes | Yes | Yes | Yes | Yes | **Yes** |
| Pre-warnings | No | No | No | No | No | No | No | Nag | **Yes (core)** |
| Urgency levels | No | Partial | No | No | Partial | No | No | No | **Yes** |
| Cascade config | No | No | No | No | No | No | No | No | **Yes** |
| Visual timeline | No | No | **Yes** | **Yes** | No | No | No | No | **Yes** |
| Routines | No | Yes | Yes | No | No | **Yes** | No | No | **Yes** |
| Linked timers | No | No | No | No | No | No | No | No | **Yes** |
| Pomodoro | No | No | No | Yes | Yes | No | Yes | No | **Yes** |
| Prep/travel time | No | No | No | No | No | No | No | No | **Yes** |
| AI input/replan | Siri | No | **Yes** | **Yes** | Partial | No | No | No | **Yes** |
| Calendar sync | N/A | No | Yes | Yes | Yes | No | No | No | **Yes (v1)** |
| Apple Watch | N/A | No | Yes | Yes | Yes | No | No | No | **Yes (v1)** |
| Widgets | N/A | No | Yes | Yes | Yes | No | No | No | **Yes (v1)** |
| Gamification | No | Missions | No | No | No | No | **Yes** | No | **Yes (v1)** |
| Neurodivergent | No | No | **Yes** | Partial | No | Partial | No | No | **Yes** |
| Shared timers | No | No | No | No | Yes (team) | No | No | No | **Yes (v2)** |
| Web PWA | No | No | No | No | Web app | No | No | No | **Yes** |
| Offline-first | N/A | Yes | Yes | Yes | No | Yes | Yes | Yes | **Yes** |
| Free tier | Yes | Freemium | Freemium | Freemium | Freemium | Freemium | $3.99 | $7.99 | **Yes** |
### 10.2 Competitive Positioning
| Competitor | Users | What They Do Best | What They Miss |
|-----------|-------|-------------------|----------------|
| **Tiimo** (App of Year 2025) | 3M+ | Visual timeline, AI planner, neurodivergent-first | No timers, no pre-warnings, no cooking/utility use case |
| **Structured** | Millions | Beautiful timeline, Pomodoro, Live Activities | No AI, no pre-warnings, no linked timers, no travel |
| **Alarmy** | 75M | Wake-up missions, sleep/mood tracking | Wake-up only, no countdowns, no routines, no pre-warnings |
| **TickTick** | 10M+ | All-in-one (tasks + Pomodoro + habits) | Timer is secondary, overwhelming UI, no cascade |
| **Forest** | 2M+ paid | Gamified focus, real tree planting | Focus-only, no alarms, no routines |
| **Routinery** | 1M+ | Step-by-step timed routines | Routine-only, no general timers, no calendar |
| **Due** | Premium | Persistent re-reminders | iOS/Mac only, dated UI, no routines or urgency |
| **Reclaim.ai** | Growing | AI auto-scheduling, focus time protection | Calendar-only, no timer/alarm, $8/mo |
| **Motion** | Growing | AI project + calendar management | Over-engineered, $19/mo, no simple timers |
**ChronoMind's moat:** No existing app combines pre-warning cascades + urgency intelligence + visual timeline + routines + linked timers + Pomodoro + neurodivergent design in a single, beautiful, offline-first web app. The closest competitors (Tiimo, Structured) are planners that happen to have timers. ChronoMind is a **timer that happens to be intelligent** — a fundamentally different approach.
**Key insight from research:** Tiimo winning App of the Year 2025 proves that visual, gentle, AI-augmented time management is mainstream — not niche. ChronoMind should embrace this design philosophy from day one.
--- ---
## 11. Monetization (Future — v2+) ## 11. Monetization (Future — v1.1+)
ChronoMind is **free and open-source** for personal use. Potential future revenue: ChronoMind is **free and open-source** for personal use. Potential future revenue:
| Tier | Price | Features | | Tier | Price | Features |
|------|-------|----------| |------|-------|----------|
| **Free** | $0 | All MVP features, unlimited timers, local storage | | **Free** | $0 | All MVP + v1.0 features, unlimited timers, local storage, Pomodoro, routines |
| **Pro** | $4/mo | Cloud sync, shared timers, calendar integration, custom sounds | | **Pro** | $3.99/mo or $29.99/yr | Cloud sync, calendar integration, custom sounds, AI reschedule, advanced stats |
| **Team** | $8/user/mo | Team timers, admin dashboard, API access, webhooks | | **Family** | $5.99/mo | Shared timers (up to 6 members), household coordination, family routines |
> **Pricing rationale:** Market range is $2.49/mo (Structured) to $5.99/mo (Tiimo). $3.99/mo is the sweet spot. Family tier replaces "Team" — household coordination is the stronger v2 monetization path than enterprise. Team/API access can be added later if demand emerges.
--- ---
@ -616,62 +688,101 @@ ChronoMind is **free and open-source** for personal use. Potential future revenu
## 13. Development Phases ## 13. Development Phases
### Phase 1: MVP (2 weeks) ### Phase 1: MVP — Web PWA (2 weeks)
| Week | Deliverable | | Week | Deliverable |
|------|------------| |------|------------|
| Week 1 | Project setup, data model, timer engine, dashboard UI, create timer flow | | Week 1 | Project setup (Next.js 16, TailwindCSS v4, shadcn/ui, Zustand + IndexedDB), timer engine, visual timeline dashboard, create alarm/countdown flow, pre-warning cascade logic |
| Week 2 | Pre-warning cascade, notifications, sounds, PWA, quick timers, dark theme | | Week 2 | Urgency levels, notifications (Web Push + Service Worker), sounds (Web Audio), Pomodoro timer, quick timers, dark/light theme, PWA install (Serwist), tab title countdown |
### Phase 2: Intelligence (2 weeks) ### Phase 2: Intelligence + Polish (2 weeks)
| Week | Deliverable | | Week | Deliverable |
|------|------------| |------|------------|
| Week 3 | Routines, linked timers, focus/pomodoro mode | | Week 3 | Routines, linked timers, NL input (chrono-node), contextual pre-warning messages, recurring timers |
| Week 4 | Natural language input, recurring timers, prep time, history + stats | | Week 4 | Focus mode, prep time, history + stats + streaks, categories/tags, neurodivergent mode (visual countdown rings), calendar .ics import |
### Phase 3: Platform (4 weeks) ### Phase 3: iOS + Apple Watch (3 weeks)
| Week | Deliverable | | Week | Deliverable |
|------|------------| |------|------------|
| Week 5-6 | macOS menu bar app (Tauri/SwiftUI), cloud sync (optional) | | Week 5 | iOS app scaffold (SwiftUI), data model (SwiftData/CoreData), timer engine port, notification scheduling (UNUserNotificationCenter) |
| Week 7-8 | iOS native app, shared timers, calendar sync | | Week 6 | Apple Watch complications + Live Activities, iOS widgets (WidgetKit), haptic pre-warnings |
| Week 7 | AI reschedule, adaptive snooze, calendar sync (EventKit), polish + TestFlight |
### Phase 4: Context & Expansion (4 weeks)
| Week | Deliverable |
|------|------------|
| Week 8-9 | Full calendar sync (Google/Apple/Outlook OAuth), location-based triggers, travel time estimates |
| Week 10-11 | macOS menu bar (SwiftUI), cloud sync (E2E encrypted), sleep integration, shared timers MVP |
--- ---
## 14. Open Questions ## 14. Risk Assessment
| Risk | Severity | Mitigation |
|------|----------|------------|
| **PWA notification unreliability on iOS** | High | Tab title countdown as supplementary signal; aggressive testing on iOS Safari; native iOS app fast-follow in Phase 3 (week 5-7) |
| **Feature creep** — too many timer types | High | Strict MVP scope (alarm + countdown + Pomodoro only); add types based on usage data, not speculation |
| **AI costs** for NL input and suggestions | Medium | chrono-node (local) for MVP NL parsing; LLM only for complex queries in v2; no API costs for MVP |
| **Calendar sync complexity** (OAuth, token refresh) | Medium | Start with .ics import (read-only, zero OAuth) in v1.0; full OAuth sync deferred to v1.1 |
| **Competition from Tiimo/Structured adding pre-warnings** | Medium | Move fast; pre-warning cascade + urgency levels is non-trivial to implement well; ship MVP in 2 weeks |
| **User overwhelm** — too many options per timer | Medium | Smart defaults everywhere; progressive disclosure (simple → advanced); "quick timer" as primary entry point |
| **Service Worker killed by OS** | Medium | Periodic `setTimeout` checks (30s); `setInterval` poll in active tab; visible countdown in tab title; native app for critical reliability |
| **Neurodivergent design requires research** | Low | Study Tiimo's design patterns; consult ADHD/autism community; iterate based on feedback |
---
## 15. Open Questions
| # | Question | Decision Needed | | # | Question | Decision Needed |
|---|----------|----------------| |---|----------|----------------|
| 1 | Should MVP include cloud sync or be 100% local? | **Decision: local-only MVP, cloud in v1.1** | | 1 | Should MVP include cloud sync or be 100% local? | **Decision: local-only MVP, cloud in v1.1** |
| 2 | Natural language parsing: local regex or LLM API? | **Decision: local regex MVP, optional LLM v2** | | 2 | Natural language parsing: local regex or LLM API? | **Decision: chrono-node (local) for MVP, optional LLM v2** |
| 3 | Should the main clock be analog, digital, or both? | **Decision: digital primary, analog option** | | 3 | Should the main clock be analog, digital, or both? | **Decision: digital primary, analog option** |
| 4 | PWA notification reliability — is it good enough? | **Test: if <90% delivery, prioritize native** | | 4 | PWA notification reliability — is it good enough? | **Test: if <90% delivery, prioritize native iOS in Phase 3** |
| 5 | Should routines support branching (if/else steps)? | **Decision: linear-only MVP, branching v2** | | 5 | Should routines support branching (if/else steps)? | **Decision: linear-only MVP, branching v2** |
| 6 | Gamification: streaks only, or Forest-style planting? | **Decision: streaks + focus scores in v1.0; explore tree/garden metaphor based on user feedback** |
| 7 | Neurodivergent mode: separate toggle or default UX? | **Decision: design for neurodivergent by default (visual timers, gentle transitions); add "compact mode" for power users** |
| 8 | Calendar sync: read-only or two-way? | **Decision: read-only import (.ics) in v1.0; two-way sync in v1.1** |
--- ---
## 15. Appendix: Naming ## 16. Appendix: Naming
| Option | Pros | Cons | | Option | Pros | Cons |
|--------|------|------| |--------|------|------|
| **ChronoMind** | Unique, conveys "smart time" | Slightly long | | **ChronoMind** | Unique, conveys "smart time" | Slightly long |
| **Cadence** | Implies rhythm, routine, timing; modern feel | Might be confused with music apps |
| **Headstart** | Captures prep-time / pre-warning essence | Common word, SEO challenge |
| **Prelude** | "Before the main event" — elegant, unique | Might sound too musical |
| **Nudge** | Friendly, approachable, describes pre-warnings well | Generic, already used by other products |
| **PreWarn** | Describes core feature | Too narrow | | **PreWarn** | Describes core feature | Too narrow |
| **TimeShift** | Cool, implies flexibility | Vague | | **TimeShift** | Cool, implies flexibility | Vague |
| **CascadeTimer** | Describes cascade feature | Too technical |
| **Nudge** | Friendly, approachable | Generic |
**Working name: ChronoMind** — subject to change. **Working name: ChronoMind** — subject to change. "Cadence" and "Headstart" are strong alternatives.
--- ---
## 16. Summary ## 17. Summary
ChronoMind fills a real gap: the space between "dumb alarm" and "full calendar app." Every phone has a clock app, but none of them answer the question *"how do I make sure I'm prepared for what's coming?"* ChronoMind fills a real gap: the space between "dumb alarm" and "full calendar app." Every phone has a clock app, but none of them answer the question *"how do I make sure I'm prepared for what's coming?"*
**Three core innovations:** **The 2026 market is ready for this:**
1. **Pre-warning cascade** — configurable escalation so you're never surprised - AI scheduling is mainstream (Reclaim, Motion)
2. **Routines** — timed sequences that guide you through multi-step activities - Visual time management won App of the Year (Tiimo, 2025)
3. **Urgency-aware intelligence** — the app understands that a flight and a laundry timer are fundamentally different - Neurodivergent-first design wins mainstream users (3M+ Tiimo downloads)
- PWA tech is mature enough for MVP
- Wellness + productivity convergence demands intelligent time awareness
The MVP is achievable in 2 weeks as a web PWA with no backend dependency. **Five core innovations:**
1. **Pre-warning cascade** — configurable multi-step escalation so you're never surprised
2. **Visual timeline** — see your entire day at a glance, Structured/Tiimo-style
3. **Urgency-aware intelligence** — the app understands that a flight and a laundry timer are fundamentally different
4. **Routines + linked timers** — timed sequences for morning routines, cooking, and multi-step workflows
5. **Neurodivergent-first design** — visual countdown rings, gentle transitions, time-blindness support
**Positioning:** Not a planner that has timers (Tiimo, Structured). A **timer that is intelligent** — purpose-built for time awareness, prep, and execution.
The MVP is achievable in 2 weeks as a web PWA with no backend dependency. iOS + Apple Watch follows in weeks 5-7.