by huytd

huytd / pomoday-v2

A keyboard only task management web app

482 Stars 46 Forks Last release: Not found BSD 3-Clause "New" or "Revised" License 150 Commits 0 Releases

Available items

No Items, yet!

The developer of this repository has not created any items for sale yet. Need a bug fixed? Help with integration? A different license? Create a request here:

Be productive without leaving your keyboard

Try it online at https://pomoday.app. Don't forget to follow us on Twitter @pomoday_app.

What is Pomoday?

Pomoday is an easy to use, yet powerful and flexible web-based task management software that you can use with just a keyboard.

It's flexible and doesn't tie with any productivity methodologies, that means, you can customize and use it in anyway you want, try implementing yourself a GTD or Kanban or Pomodoro workflow with it.


  1. Task management (of course)
  2. Keyboard only workflow
  3. Built-in time tracker
  4. Activities log to get an overview on how you spent your day
  5. Dark mode
  6. (A lot coming...)

Usage and Installation

There are two ways to use Pomoday:

Online version

You can use the online version at https://pomoday.app

Self-hosted version

Please make sure you have

installed on your machine.

To host Pomoday locally or on your own server:

  1. Clone this repository
    git clone https://github.com/huytd/pomoday-v2
  2. Install the dependencies
    npm install
  3. Build
    npm run dist
  4. Now you can deploy the
    folder anywhere, just like a static web page

It's recomended to deploy it to now.sh, because it's easy:

$ cd dist
$ now


To run it locally during development, use:

npm run dev


This repo includes a

and a
to easily run the project in a container. Just run the following two commands to build the container image and start it up:
$ docker-compose build
$ docker-compose up -d

Syncing across devices

To sync the data across devices, you'll need to implement your own backend, please see Backend API Specification for the details.

To use https://pomoday.app with your own backend, there's a

command in the app, you'll be able to put your backend API URL there.

Similar Projects

  • taskbook: This is an awesome task management application that actually works, and works very well for everyone who likes to live in a command line. Pomoday was also heavily inspired by Taskbook, as you can see from the UI and the keyboard-only command interfaces.

Backers and Sponsors

I would like to give a special thanks to all of the advisors and backers who sponsored this project since day-zero.

| | | | | | | | |:--:|:--:|:--:|:--:|:--:|:--:|:--:| |imhuyqn|ledongthuc|trungfinity|thaod|mquy|quannt|dvkndn|


Code Contributors

This project exists thanks to all the people who contribute. [Contribute].

Financial Contributors

Become a financial contributor and help us sustain our community. [Contribute]



Support this project with your organization. Your logo will show up here with a link to your website. [Contribute]


Pomoday is published under BSD 3-Clause license.

We use cookies. If you continue to browse the site, you agree to the use of cookies. For more information on our use of cookies please see our Privacy Policy.