Ralph Todo

A small, file-backed todo app with a Node.js server and a vanilla JS UI.

Prerequisites

• Node.js 18+ (Node 20+ recommended)
• sqlite3 CLI available in your PATH

Setup

npm install

Run

npm run start

The server runs on http://localhost:3000 by default. Open that URL in your browser (do not open public/index.html directly).

npm run start will run migrations automatically before starting the server.

Scripts

• npm run start: run migrations, then start the server
• npm run migrate: run database migrations only
• npm run typecheck: TypeScript type checking

Configuration

You can customize these environment variables:

• PORT: server port (default 3000)
• HOST: bind host (default localhost)
• DB_PATH: SQLite file path (default data/todo.sqlite3)

Notes

• If you previously started the server without running migrations, the API would return "Unable to load tasks" because the tasks table did not exist. The start script now runs migrations automatically.