lightmorphic/todom repository overview

⁠Todom

A stupidly simple todo list.

Website: todom.lightmorphic.com⁠

Todom is a small, dependency-free todo list. Every task has a due date, active tasks are sorted soonest-first, and completing a task records the completion date.

See CHANGELOG.md⁠ for version history.

⁠Features

• Clean, minimal interface
• Dark interface as standard
• Every task has a due date; tasks are sorted nearest-due first
• Colour-coded urgency (overdue / due today / due soon / later)
• Completion date recorded automatically when you check a task off
• Installable PWA (works offline, "Add to Home Screen")
• Server-side storage - same task list on every device

⁠Storage

Todom stores tasks server-side in a single JSON file (tasks.json), written by a small Node/Express backend. There is no database and no accounts, just one file. Because storage lives on the server rather than in the browser, every device that opens the same URL sees the same task list.

⁠Quick Start

⁠Running locally without Docker

Requires Node.js 20+.

curl -LO https://todom.buildmorphic.com/code/latest.tar.gz
tar -xzf latest.tar.gz
cd todom-v*
npm install
node server.js

Open http://localhost:3000⁠. Tasks are written to tasks.json, whose location defaults to /data/tasks.json but can be overridden with the DATA_FILE environment variable, e.g. DATA_FILE=./tasks.json node server.js.

⁠Using Docker

1. Pull from Docker Hub

   docker pull lightmorphic/todom:latest
   sudo mkdir -p /opt/todom
   docker run -p 4070:3000 -v /opt/todom:/data lightmorphic/todom:latest
   

   Copy

2. Or build locally

   docker build -t todom .
   sudo mkdir -p /opt/todom
   docker run -p 4070:3000 -v /opt/todom:/data todom
   

   Copy

3. Docker Compose

   services:
     todom:
       image: lightmorphic/todom:latest
       container_name: todom
       restart: unless-stopped
       ports:
         - "4070:3000"
       volumes:
         - /opt/todom:/data
   

   Copy

   sudo mkdir -p /opt/todom
   docker compose up -d
   

   Copy

Open http://localhost:4070⁠. Tasks are stored server-side in a JSON file inside /opt/todom, so every device that opens this URL sees the same task list.

⁠Image publishing

The image is built on the maintainer's own computer and published to lightmorphic/todom⁠ on Docker Hub with each release.

⁠Project Structure

todom/
├── public/                 # Static frontend served by the app
│   ├── index.html
│   ├── manifest.json
│   ├── service-worker.js
│   ├── todom-logo-small.png
│   └── todom-logo-large.png
├── server.js                # Node/Express backend, reads/writes tasks.json
├── package.json
├── Dockerfile
├── docker-compose.yml
├── .dockerignore
├── .gitignore
└── .github/workflows/docker-publish.yml

⁠Development

Keep it dumb, keep it simple - if you're writing complex code to solve a simple problem here, you're probably doing it wrong.

⁠Licence

Todom is free software, licensed under GPL version 3 or any later version. See the LICENSE⁠ file for the full text.

⁠Disclaimer

This software is provided "as is", without warranty of any kind, express or implied - see the LICENSE file for the exact legal terms. You use it entirely at your own risk.

Comments are stripped from the published code to keep it lean.