ADHD TimeBox

Calendar Sync
Task completion
Planning Agent
Planning Agent to organize timeboxing for every task. (will learn more about you as you use it more often)
Planning Agent to organize timeboxing for every task. (will learn more about you as you use it more often)
Thought Parking Agent
Focusing Agent that tracks user activity desktop
Focus Reminder Agent (reminding user to keep off useless or distractive Apps)
Resting Agent (Able to track user rest and manage productivity, while learn user resting pattern)

Inspiration

We were inspired by the common struggle people with ADHD face in time management and productivity. Many with ADHD experience procrastination and time-blindness, making it hard to stay on schedule.

We noticed that timeboxing (allocating fixed intervals to tasks) can greatly help, this technique forces structure and urgency. In particular, scheduling tasks into focused work periods (e.g., 15, 30, 60-minute blocks) creates clear start/stop signals.

We asked ourselves:

What if we could take a proven method used by Elon Musk and make it ADHD-friendly?

We model productivity as:
$ \text{Progress} = \text{Focus} \times \text{Clarity} \times \text{Compassion} $

This helped guide our design: tools should support cognition rather than punish lapses.

What it does

ADHD TimeBox is an AI-powered execution coach that helps users break scattered ideas into actionable 15/30/60-minute timeboxes. Key features:

Planning Chat – turns brain-dumps into concrete focus boxes.
Focus Guardian – detects drift and gently nudges you back.
Thought Parking – lets you store distractions without breaking flow.
Kind Reviews – ends each box with guilt-free reflection (finished, partial, or stuck).

The app follows a 4-state loop:

Planning – structure raw ideas into actionable blocks.
Focusing – work with a live timer and active task controls.
Interrupted – handle distractions with quick recovery options.
Resting – recover before restarting, promoting sustainable momentum.

AI (Gemini API) powers all phases to keep users on track and maintain momentum:
$$ \text{Momentum} = \frac{\text{Consistent Focus}}{\text{Task Switching}} $$

How we built it

We built ADHD TimeBox during a hackathon with a 4-person team.

Tech stack:

Frontend: Next.js for reactive UI and server-side rendering
Backend: FastAPI for REST APIs and async endpoints
AI: Gemini API for intelligent planning and focus nudges

Team workflow:

Frontend dev: UI & timer components
Backend dev: API endpoints, database integration
AI dev: Gemini integration & prompt design
UX dev: user flows, thought parking, reflections

Example FastAPI endpoint:

from fastapi import FastAPI
app = FastAPI()

@app.post("/tasks/")
async def create_task(title: str, duration: int):
    return {"status": "task created", "title": title}