Skip to content
luiscassihPublic

About

Source Code of DokiToki.app - 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.

Topics

Resources

Contributing

Stars

0 stars

Watchers

1 watching

Forks

Repository files navigation

DokiToki Logo

DokiToki

The pulse of your projects

dokitoki.app

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.

ko-fi

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.


Overview

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.

Basic TODO template

From a basic todo list...

School timetable template

...to a school timetable.


Widgets

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.

Timers & Projects

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
Loading

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.

Stopwatch

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)

Pomodoro

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

Countdown

  • Classic countdown timer, optionally linked to a project
  • Deadline mode — set a target date and see it in the calendar on the top bar

Other Widgets

  • 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.


Usage

  • Add widgets — Double-click the board, right-click → Add, or press Space twice
  • Move & arrange — Drag widgets freely. Multi-select with Ctrl+Click or hold-click
  • Pan & zoom — Hold Space or 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

Development

Setup

# 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 dev

Build & Preview

bun run build
bun run preview

Test

bun run test

Tech Stack

React · TypeScript · Preact Signals · Tailwind CSS · Vite · Vitest

Creating Widgets

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.


Pricing

$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 ☕


AI Usage

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.


Trivia

The name comes from a Japanese wordplay: Doki Doki (どきどき), the onomatopoeia for a heartbeat, combined with Toki (時), meaning time.

About

Source Code of DokiToki.app - 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.

Topics

Resources

Contributing

Stars

0 stars

Watchers

1 watching

Forks

Contributors

Languages