Task Master
Getting started & feature guide
Task Master lets you sequence work by project: add tasks, drag them into order, and set dependencies so prerequisites stay ahead. Status moves from To Do through Testing to Done (or Won’t Do). Use it signed out on this device, or sign in to sync projects across devices. Switch between Tasks and Whiteboard, and import/export JSON or PNG when you need a backup.
Getting Started
- Click + New Project in the sidebar to create a project.
- Give it a name, optional details, and links, then click Save.
- Add tasks with + Add Task or Bulk Add (one task per line). The Add Task modal also has a Save & New button so you can keep adding without closing the dialog.
- Drag tasks to reorder them. The list order is the recommended sequence.
- Set dependencies by dragging one task onto another (middle zones) or via the Edit modal.
- Update status with the status chip on each card (To Do → In Progress → Testing → Done / Won’t Do).
Views
A toggle at the top of the sidebar switches between two views. Your last choice is remembered the next time you open the app.
Tasks
The default focused view. Select a project in the sidebar to see and edit its tasks, reorder them, set dependencies, and change status.
Whiteboard
A two-column overview of all active projects and their tasks. Useful for seeing everything at once.
- Click a task to toggle its status relative to when the page loaded:
- If it was Done → switches to To Do
- If it was any other status → switches to Done
- Click again to restore the original status
Toggled tasks stay visible even if “Show done / won’t do” is unchecked. When you switch back to the Tasks view, those toggles are committed and the tasks become ordinary completed (or current-status) tasks.
- Hover a task to reveal a grip on the left (drag to reorder within the project; dependencies are respected) plus Edit and Delete icons. Edit opens the normal task dialog; Delete asks for confirmation.
- Hover a project title to reveal a grip on the left (drag to reorder projects) plus Edit and Add icons on the right. Edit switches to the Tasks view for that project. Add opens the bulk-add form (same as clicking the title itself). Icons stay hidden until you hover.
- Collapse / expand a project with the chevron that appears right after the item count when you hover the title. It shows or hides the task list; the choice is remembered. The chevron does not appear when printing.
- Project titles show the project’s task count display (set in Project Settings): either
(x/y) (completed or won’t do / total) or (z) (remaining). Hover the title for the full description. This is independent of the “Show done / won’t do” filter.
- Click a project title to open a bulk-add form at the bottom of that list. Enter one task per line and click Add Tasks.
- Controls in the header let you show/hide done items and turn numbering on or off. When numbering is off, each task has a bullet.
Account and signed out
- Signed out — you can still create and edit projects on this device. A bright red Local Mode banner stays at the top of the page while you are signed out (use “Mute color” on the banner for the quieter look). Each new browser session while signed out, a notice reminds you that changes are stored only on this device and offers a link to create an account or sign in (you can check “Don’t ask again today” to skip it for the rest of the day). Projects stay in this browser until you sign in and choose to bring them into your account.
- Account — sign in from the profile bar. Your projects are stored on the server and can be used on other devices. Every account project syncs; there is no per-project opt-out.
- Auto-save — when you are signed in and online, every change is saved to the server automatically (debounced). The status chip shows “Saving…” then “Synced”. A local copy is kept as a cache so you can keep working if you go offline; pending changes are pushed when you reconnect.
- Sync — the Sync button still does a full push + pull (useful to pull changes made on another device). Click the status chip for a recent sync log.
- Save to Local — copy selected account projects into the signed-out store on this device.
- Import From Local — copy selected signed-out projects into your account. Matching projects are merged (newer content wins; unique tasks and links are kept). They are uploaded on the next auto-save or Sync.
- Profile — click the name/avatar in the sidebar to set first name, last name, and an avatar. Initials are shown if there is no avatar. Profile is kept locally and on the server; the newer copy wins. From Profile you can also Export All your projects (JSON or PNG) as a backup, or drop a backup file to import selected projects (matching projects are merged).
- Password — use Forgot password? on the sign-in form. Reset links expire after one hour. Show password is available next to the password label.
- Sessions stay signed in until you log out. Signing out returns you to the signed-out projects on this device. Your account data is not deleted.
Projects
- Sidebar — lists active projects. Drag the grip to reorder (the order is saved and syncs across devices when signed in). Each project shows its task count display (smaller text) beside the name; hover for details. On a computer, drag the right edge of the sidebar to resize it (remembered, 180–480 px). The collapse button shrinks the sidebar (remembered; Whiteboard also collapses it). On a phone, open the sidebar from the menu button; selecting a project closes it.
- Project Settings (gear icon) — edit name, description, links, and the task count display. The count display chooses whether project headers show
(x/y) (completed or won’t do / total) or (z) (remaining). Also Archive, Export JSON, Export as PNG, Delete, and Import. Deleting a project removes it here and, once you are online, from the server so Sync does not bring it back.
- Show Archived — toggle in the sidebar footer. Off hides archived projects and Done / Won’t Do tasks. On shows both.
- Dark Mode — toggle in the sidebar footer. The app supports light and dark themes. Your choice is remembered, and it starts with your system preference if unset.
- Import / Export — export a single project as JSON or PNG from Project Settings (filenames are prefixed with
taskmaster- plus the project name). Export all projects at once from the Profile dialog. Drop a JSON or PNG file onto the sidebar (or into Project Settings / Profile), or click the drop zone to browse for a file. Other file types are accepted and will be attempted as JSON. Smart merge options handle name conflicts and duplicate tasks; bulk import merges matching projects by id (newer content wins).
Tasks
- The badge next to “Tasks” shows the same count display chosen for the project:
(x/y) or (z). Hover it for details.
- Title, description, type, status — types: Enhancement, New Idea, Bug, Question/Spike. Click the type chip on a task card to change it without opening the modal.
- Type and status chips — sit on the same row as the task title. Click either chip to open a picker and change it without opening the modal. Done and Won’t Do move the task to Archived Tasks (with a confirmation).
- Dependencies — a task can depend on others. Drag zones on a task card:
- Left 25% — insert before
- Right 25% — insert after
- Top middle — this task depends on the dragged task (and moves the dragged task ahead)
- Bottom middle — the dragged task depends on this one (and moves this task ahead)
Circular dependencies are blocked.
- Hide details — toggle in the tasks header to show or hide the description plus Date Added and Last Modified. Everything else stays the same.
- Last modified — subtle timestamp on each card (and in the edit modal) reflecting the last status change.
- Delete — icon on the card; modal confirm with a “Don’t ask again this session” option.
- Save & New — when adding a task, this button saves the current one and immediately opens a fresh Add Task dialog so you can keep going.
Modals
- Clicking outside a modal does not close it. Use Cancel or the × button.
- The close button is a compact icon in the top-right of the modal header.
Tips
Signed-out work stays in this browser. Account projects sync to the server and are cached on the device. Export JSON or PNG if you want a file backup.
The order of active tasks is the recommended sequence to tackle them. Dependencies reinforce that order when you create them via drag.
The Help button (question-mark icon) in the sidebar header opens this page in a new tab.
Keyboard & Mouse
- Click a project in the sidebar to select it.
- Drag the grip on a project to reorder the list.
- Drag a task card to reorder or set dependencies (watch the zone labels).
- On the Whiteboard, click a task to toggle its status, click a project title to bulk-add, or hover for edit/delete and edit/add icons. Tasks with a description show an expand/contract button right after the title (hidden when printing). Use Print to open the browser print dialog (Save as PDF works too); the print layout keeps project letters stable. With Enumerate Tasks on, collapsed projects print as a title and count only (no tasks). With it off, collapsed projects are omitted. Expanded projects include their tasks and descriptions. Controls are hidden.
Task Master — Track the details of your Projects