changed to .md

readme.md

@@ -0,0 +1,98 @@
+# Learning Progress Tracker
+
+A web-based goal and learning progress tracker with subtask management, due dates, drag-and-drop reordering, task archiving, and persistent server-side storage.
+
+## Features
+
+- **Goal Management** — Create, edit, and delete learning goals with titles, descriptions, sizes, due dates, and optional rewards.
+- **Due Dates** — Set deadlines on tasks and subtasks. Color-coded badges show time remaining: green (plenty of time), amber (7 days or less), red (overdue/today). Completed tasks show a strikethrough date.
+- **Subtasks** — Break goals into smaller subtasks. Drag any task onto another to nest it, or promote subtasks back to top-level goals via right-click.
+- **Progress Tracking** — Automatic weighted progress calculation (Small 10%, Medium 25%, Large 50%).
+- **Archive** — Completed tasks show an "Archive" button. Switch to the Archive view to restore, edit, or permanently delete archived tasks.
+- **Drag & Drop** — Reorder tasks and subtasks. Hold over a task to reveal its drop zone for nesting.
+- **Context Menus** — Right-click for edit, delete, promote, archive, or restore actions.
+- **Double-Click to Edit** — Double-click any task or subtask card to open the editor.
+- **Expandable Descriptions** — Toggle "Show full description" per task to expand beyond the default 2-line clamp.
+- **Rewards** — Hidden rewards revealed only upon completion.
+- **Custom Background** — Place a `background.jpg` or `background.png` in `public/img/` to set a custom background image. The UI uses frosted glass (glassmorphism) over the image.
+- **Persistent Storage** — SQLite database with automatic schema migration.
+
+## Project Structure
+
+```
+├── public/
+│   ├── img/              # Place background.jpg or background.png here
+│   ├── index.html
+│   ├── styles.css
+│   └── app.js
+├── server/
+│   └── server.js
+├── data/                 # SQLite database (auto-created)
+├── package.json
+├── dockerfile
+└── README.md
+```
+
+## Getting Started
+
+### Prerequisites
+
+- [Node.js](https://nodejs.org/) v18 or later
+
+### Installation
+
+```bash
+cd learning-progress-tracker
+npm install
+npm start
+```
+
+Available at **http://localhost:3000**.
+
+For development with auto-reload:
+
+```bash
+npm run dev
+```
+
+### Custom Background
+
+Place your image at `public/img/background.jpg` (or `.png`). The CSS references `img/background.jpg` — rename or edit the CSS path as needed. Without an image, the app falls back to a soft gradient.
+
+### Docker
+
+```bash
+docker build -t learning-tracker .
+docker run -d -p 3000:3000 -v tracker-data:/app/data learning-tracker
+```
+
+## API Endpoints
+
+| Method | Endpoint | Description |
+|--------|----------|-------------|
+| `GET` | `/api/tasks` | Fetch active tasks (`?archived=1` for archived) |
+| `POST` | `/api/tasks` | Create a new task |
+| `PUT` | `/api/tasks/:id` | Update a task |
+| `PUT` | `/api/tasks/:id/archive` | Archive a task |
+| `PUT` | `/api/tasks/:id/unarchive` | Restore an archived task |
+| `DELETE` | `/api/tasks/:id` | Permanently delete a task |
+| `POST` | `/api/tasks/reorder` | Reorder tasks (array of IDs) |
+
+## Usage
+
+- **+ New Goal** to create a task with optional due date.
+- **Right-click** for context menu actions.
+- **Double-click** a card to edit it.
+- **Drag** to reorder or nest tasks.
+- **Archive** completed tasks, then switch views with the Active/Archive toggle.
+
+## Tech Stack
+
+- **Frontend:** Vanilla JavaScript, HTML, CSS (glassmorphism, CSS variables)
+- **Backend:** Node.js, Express
+- **Database:** SQLite3
+- **Containerization:** Docker
+
+## License
+
+MIT