The pulse of your projects
A free, open-source modular workspace where you create dashboards for different contexts — work, school, personal projects — and fill them with widgets like timers, kanban boards, notes, and flashcards, while tracking time across a project hierarchy.
Note
DokiToki works offline and stores data locally on your device using Local Storage. Your data never leaves your browser — no servers, no cookies, no tracking.
A dashboard is a collection of widgets on an infinite canvas. Create one for each context — work, school, side project — and arrange widgets however you like.
Note
In these first public versions the number of widgets is limited. More will be added over time, and there will be a public API to create your own.
Create timer widgets like Stopwatches, Pomodoro or Countdowns. They can be simple temporal timers, or you can link them to projects (kind of like tags) organized in a hierarchy where time automatically adds up into parent projects.
flowchart BT
TA(Pomodoro) --> A
A(Work) --> C(Coding)
TB(Stopwatch) --> B(Personal)
B --> C
For example, you might have a project called Coding with Work and Personal as sub-projects, so time you spend on Work also counts toward Coding.
Multiple timers can run simultaneously on the same project — start the day with a stopwatch on Work, then add a Pomodoro without stopping the stopwatch. The parent projects keep aggregating until all associated timers stop.
When you create a stopwatch timer, you have three options:
- Create a temporal stopwatch, which is the default, with no project associated. You can reset, edit or delete them as you want.
- Create a project affected stopwatch. This timer have it's own time, you can reset or edit them, but each time you start them, it will also start their associated and parent projects. You will want one of them for example, to track the total hours of the current day, then reset on the next day.
- Create a project timer, which will just show the time of that project. (If you add two stopwatchs of the same project in the same dashboard, they will just show the same time)
Configurable work/break intervals with full flexibility:
- Any number of steps (e.g. 25 min work → 5 min break → 25 min work → 15 min break)
- Multiple cycles (e.g. repeat the routine four times in the morning)
- Assign a project so work steps accumulate time automatically
- Classic countdown timer, optionally linked to a project
- Deadline mode — set a target date and see it in the calendar on the top bar
- Kanban — Each widget is a single column. Place multiple columns side by side to build your own board layout. Drag items between columns.
- Notes — Simple text notes.
- Memory Flashcards — Memory cards for study or review.
More widgets are planned. The goal is to have a custom widget API and potentially a widget store for community created widgets.
- Add widgets — Double-click the board, right-click → Add, or press
Spacetwice - Move & arrange — Drag widgets freely. Multi-select with
Ctrl+Clickor hold-click - Pan & zoom — Hold
Spaceor middle-click to pan. Scroll wheel to zoom. Pinch-to-zoom on touch devices - Find widgets —
Ctrl+/to search and locate any widget - Context menu — Right-click any widget for options (on mobile, touch and hold)
- Menu — Click the top-left hamburger icon for project manager, dashboards, save data, wallpaper, and more
- Templates — Start with a pre-made layout from the tutorial, or build from scratch
# Local HTTPS (you can remove it from viteconfig http is enough)
mkcert -install
cd certs/ && mkcert dev.dokitoki.app
nvim /etc/hosts # add 127.0.0.1 dev.dokitoki.app
# Install & run
bun install
bun run devbun run build
bun run previewbun run testReact · TypeScript · Preact Signals · Tailwind CSS · Vite · Vitest
There's a Widget base class you can inherit from. Add your type to WidgetType, implement a few members, and you're done. Storage, data migration, and positioning are handled for you.
import { Widget, WidgetProps } from '@core'
interface Props {
example?: string
}
export class Example extends Widget {
// Bump this version and add a migration when your data structure changes.
static version = 1
static migrations: MigrationRecord = {
// 2: (data) => {
// const { example, ...rest } = data
// return { ...rest, new_example: example ?? "" }
// },
}
widgetType = WidgetType.Example
example: string
constructor(props: Props & WidgetProps) {
super(props)
this.example = props.example ?? ""
}
dispose() {
return super.dispose()
}
serialize() {
return {
...super.serialize(),
version: Example.version,
example: this.example,
}
}
draw() {
return <div>{this.example}</div>
}
}For widgets that need live updates (e.g. timers), subscribe to the main loop in the constructor:
Subscribe(this.id, this.update.bind(this))The update method will be called 30 times per second.
Check the Notes widget (src/modules/widgets/notes.tsx), is the most simple one.
$0. DokiToki is free and without ads, forever. This repo is open source and the app works offline — clone it and run locally if you prefer.
If you find it useful, consider buying me a coffee ☕
While this project was not vibecoded, I did use AI like a proper tool, mainly for polishing, boilerplate, and finishing the project. Everything was reviewed.
The name comes from a Japanese wordplay: Doki Doki (どきどき), the onomatopoeia for a heartbeat, combined with Toki (時), meaning time.

