# Project pack: Super Productivity @ 78139c5

Facts about **Super Productivity** for an AI following the [BespokeAI handover guide](https://handoff.bespokeai.software/guide/v4.md). Pinned to one version; never changes after publication.

> Super Productivity is a to-do list and day planner for deep work. Plan your day, track time on tasks, use focus sessions and breaks, and pull in tasks from tools like GitHub, Jira or calendars. It works in the browser, on desktop and on mobile, with no account, no tracking, and data that stays on your device unless you choose to sync.

## Setup path (checked 2026-11-03)
- **Start here, no Docker:** Use it in a web browser; nothing to install on your computer.
- Offer Docker only if the person asks or this path fails. The commands further down may use Docker; they are not the starting point.
- Verdict source: https://raw.githubusercontent.com/super-productivity/super-productivity/HEAD/README.md
- You may be unable to download source archives or run commands in this session. The person downloads and runs things; if you cannot fetch something, give any changed file in full in chat with its path.

## Version and source
- Repository: https://github.com/johannesjo/super-productivity
- Pinned commit: `78139c531c808bab7c46ef96fd0fbb0a3b6f7d6d`. Use exactly this version.
- Zip the person can download in a browser: https://github.com/johannesjo/super-productivity/archive/78139c531c808bab7c46ef96fd0fbb0a3b6f7d6d.zip
- Fresh checkout (only if you have a shell and git): use the commands below in an empty folder. If this exact source is already checked out, keep your branch and use the development command; do not clone again or reset local changes.
- Official docs: https://github.com/super-productivity/super-productivity/wiki
- Live demo: https://app.super-productivity.com. The full web app. Data is stored in your browser only.
- Licence: **MIT**. Free to use, change and share, even commercially. Keep the original copyright notice.

## Commands from the pinned source
- Developer commands (they may use Docker):

  ```sh
  git clone https://github.com/johannesjo/super-productivity bespoke-super-productivity
  cd bespoke-super-productivity
  git checkout --detach 78139c531c808bab7c46ef96fd0fbb0a3b6f7d6d
  # Prepare development requirements and local configuration first.
  # Setup notes: web dev server on http://localhost:4200
  npm install && npm run startFrontend
  ```

- Separate trial of the current upstream release (not your changes; sample data and a separate data directory only):

  ```sh
  Easiest: open https://app.super-productivity.com in your browser. Self-host: docker run -d -p 8080:80 johannesjo/super-productivity:latest   # then open http://localhost:8080
  ```
- Tools these commands use: Nothing for the web app; Node 22 + npm for development
- Develop: `npm install && npm run startFrontend   # web dev server on http://localhost:4200`
- Test: `npm run test:affected`
- Check/lint: `npm run checkFile <changed files>`
- Stack: typescript, scss (Angular, NgRx, Angular Material, Electron, Capacitor). Difficulty for a non-developer with an AI: **advanced**. A large Angular app with sync logic, so core code changes are for agent-mode AIs only. But plugins (plain JavaScript, no build) and CSS themes make many adaptations easy without touching the core.
- The project's own AI instructions, in the repository: `AGENTS.md`, `CLAUDE.md`, `ARCHITECTURE-DECISIONS.md`, `docs/repository-map.md`, `packages/plugin-dev/QUICK_START.md`.
Personal data: **yes**. Stored in: In the browser (IndexedDB) or the desktop app's local storage; optional sync to a provider you choose. Secrets are entered by the person, never in chat.

---
Later, only when a step needs it: [reference.md](https://handoff.bespokeai.software/p/super-productivity/78139c5/r3/reference.md) (customisation points, must-keep-working, data and costs, coding conventions) · [hosting.md](https://handoff.bespokeai.software/p/super-productivity/78139c5/r3/hosting.md) (long-term hosting; hosts are paid third parties) · [bespoke.yaml](https://handoff.bespokeai.software/p/super-productivity/78139c5/r3/bespoke.yaml) · [SKILL.md](https://handoff.bespokeai.software/p/super-productivity/78139c5/r3/SKILL.md)