titanrgb/timetender repository overview

⁠Timetender v1.0.3

English | 简体中文⁠

⁠1 Description

A Gantt-style todo list, written with Vite + React 19 + TypeScript + MUI (completely rewrote for v1.0.0).

It follows these rules:

• x-axis is the calendar (each column is a date), so it's infinite
• y-axis is task list (each line contains only one task), expanding

⁠1.1 (eliminated) Excel Concept

⁠1.2 Now Project

⁠2 Usage

Build Docker Image:

docker build -t timetender ./app

Run Docker Image:

# DockerHub
docker pull titanrgb/timetender:latest
# GitHub
docker pull ghcr.io/mehver/timetender:latest

docker run -d \
  --name=timetender \
  -e TZ=Asia/Shanghai \
  -p 127.0.0.1:80:8080/tcp \
  -v /path/for/data:/usr/lib/timetender/data \
  timetender:latest

Open http://localhost⁠ and choose "后端服务器存储" in Settings if you want server-side persistence (browser-local storage works out of the box too).

Single-file build (no server needed):

cd app
pnpm install
pnpm build

Then open dist/index.html directly in a browser (file:// works).

⁠3 Development

Requirements

• Node.js⁠ v24

Install Dependency

cd app
pnpm install

Frontend Development

pnpm start &       # optional: Express backend for the /api/data endpoints
pnpm dev

Frontend Compile

pnpm build

Backend Server

pnpm start

Tests / Typecheck

pnpm test          # vitest unit + smoke tests
pnpm typecheck     # tsc -b

Build Docker Image

pnpm install
pnpm build
docker build -t <YourID>/timetender:<tag> .

⁠4 Built With

• Node.js
  • React 19 + Vite
    • Material UI v7 (https://github.com/mui/material-ui⁠)
    • MUI X (https://github.com/mui/mui-x⁠)
      • Data Grid
      • Date Pickers
  • Express 5 (https://github.com/expressjs/express⁠)
• Docker
  • Node.js v24 Image (https://hub.docker.com/_/node⁠)
    • node:24-alpine

⁠5 License

This project is released under the BSD 3-Clause License. Code may be reused with proper attribution.

Copyright (c) 2022 Mehver (https://github.com/Mehver⁠). All rights reserved.

All dependencies are open-source and licensed under permissive licenses. No copyleft (e.g., GPL, AGPL) components are included.