{"id":13406726,"url":"https://github.com/johannesjo/super-productivity","last_synced_at":"2026-01-04T19:15:32.395Z","repository":{"id":37432239,"uuid":"78243781","full_name":"johannesjo/super-productivity","owner":"johannesjo","description":"Super Productivity is an advanced todo list app with integrated Timeboxing and time tracking capabilities. It also comes with integrations for Jira, GitLab, GitHub and Open Project.","archived":false,"fork":false,"pushed_at":"2025-05-10T13:21:52.000Z","size":90455,"stargazers_count":13622,"open_issues_count":331,"forks_count":1077,"subscribers_count":136,"default_branch":"master","last_synced_at":"2025-05-11T13:58:40.474Z","etag":null,"topics":["electron-app","hacktoberfest","hacktoberfest2022","jira","linux","macos","productivity","task-manager","time-tracker","timetracking","to-do-list","todo"],"latest_commit_sha":null,"homepage":"http://super-productivity.com","language":"TypeScript","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/johannesjo.png","metadata":{"files":{"readme":"README.md","changelog":"CHANGELOG.md","contributing":".github/CONTRIBUTING.md","funding":".github/FUNDING.yml","license":"LICENSE","code_of_conduct":".github/CODE_OF_CONDUCT.md","threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":"SECURITY.md","support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null},"funding":{"github":["johannesjo"],"patreon":null,"open_collective":null,"ko_fi":null,"tidelift":null,"community_bridge":null,"liberapay":null,"issuehunt":null,"otechie":null,"custom":null}},"created_at":"2017-01-06T22:30:58.000Z","updated_at":"2025-05-11T13:38:57.000Z","dependencies_parsed_at":"2023-10-14T14:15:27.161Z","dependency_job_id":"a5ea02c0-f41d-4844-94ff-610fe31482c1","html_url":"https://github.com/johannesjo/super-productivity","commit_stats":null,"previous_names":[],"tags_count":468,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/johannesjo%2Fsuper-productivity","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/johannesjo%2Fsuper-productivity/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/johannesjo%2Fsuper-productivity/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/johannesjo%2Fsuper-productivity/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/johannesjo","download_url":"https://codeload.github.com/johannesjo/super-productivity/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":253576262,"owners_count":21930169,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["electron-app","hacktoberfest","hacktoberfest2022","jira","linux","macos","productivity","task-manager","time-tracker","timetracking","to-do-list","todo"],"created_at":"2024-07-30T19:02:37.661Z","updated_at":"2026-01-04T19:15:32.389Z","avatar_url":"https://github.com/johannesjo.png","language":"TypeScript","funding_links":["https://github.com/sponsors/johannesjo"],"categories":["TypeScript","Applications","Todo List","Tools","HarmonyOS","前端开发框架及项目","Personal Time Tracking","productivity","Application Recommendation","Utilities","Table of Contents","Official Resources","JavaScript","Collaboration"],"sub_categories":["Productivity","Uptime Monitoring","Time tracking and contractor management","Windows Manager","其他_文本生成、文本对话","🗂️ Personal knowledge management","To-Do Lists","🛠️ Utilities (79)","Utilities","Task Management","Kanban board (Trello alternatives)"],"readme":"\u003ca href=\"https://super-productivity.com/\"\u003e\n  \u003cimg align=\"center\" alt=\"Banner\" src=\"docs/screens/banner.png\" /\u003e\n\u003c/a\u003e\n\n\u003cbr\u003e\n\u003cbr\u003e\n\n\u003cp align=\"center\"\u003e\n\u003cstrong\u003eAn advanced todo list app with timeboxing \u0026 time tracking capabilities that supports importing tasks from your calendar, Jira, GitHub and others\u003c/strong\u003e\n\u003cp\u003e\n  \n\u003cp align=\"center\"\u003e:globe_with_meridians: \u003ca href=\"https://app.super-productivity.com\"\u003eOpen Web App\u003c/a\u003e or :computer: \u003ca href=\"https://github.com/johannesjo/super-productivity/releases\"\u003eDownload\u003c/a\u003e\u003c/p\u003e\n\n\u003cbr\u003e\n\n\u003cp align=\"center\"\u003e\n\u003ca href=\"https://youtu.be/_mvMXWLsL-8\"\u003e\n    \u003cimg src=\"https://github.com/user-attachments/assets/15384cae-8ba3-4474-bc2c-13e7765c2dd1\" alt=\"animated\" /\u003e\n\u003c/a\u003e\n\u003c/p\u003e\n\u003cbr\u003e\n\n\u003cp align=\"center\"\u003e\n      \u003cimg src=\"https://repobeats.axiom.co/api/embed/61f9b9de1bc34a2b526faf6d356120bdae7f4249.svg\" alt=\"analytics\" /\u003e\n\u003c/p\u003e\n\n\u003cbr\u003e\n\u003cbr\u003e\n\n[![Stand With Ukraine](https://raw.githubusercontent.com/vshymanskyy/StandWithUkraine/main/banner2-direct.svg)](https://vshymanskyy.github.io/StandWithUkraine)\n\n\u003cp align=\"center\" style=\"text-align: center;\"\u003e\n\u003ca href=\"https://lbesson.mit-license.org\"\u003e\n  \u003cimg alt=\"MIT license\"\n       src=\"https://img.shields.io/badge/License-MIT-blue.svg?style=flat-square\"\n       align=\"center\"\u003e\n\u003c/a\u003e\n\u003ca href=\"https://github.com/johannesjo/super-productivity/releases\"\u003e\n  \u003cimg alt=\"GitHub All Releases\"\n       src=\"https://img.shields.io/github/downloads/johannesjo/super-productivity/total\"\n       align=\"center\"\u003e\n\u003c/a\u003e\n\u003ca href=\"https://community.chocolatey.org/packages/super-productivity\"\u003e\n  \u003cimg alt=\"Chocolatey package\"\n       src=\"https://img.shields.io/chocolatey/dt/super-productivity?color=blue\u0026label=chocolatey\"\n       align=\"center\"\u003e\n\u003c/a\u003e\n\u003ca href=\"https://www.producthunt.com/posts/super-productivity\"\u003e\n  \u003cimg alt=\"On product hunt\"\n       src=\"https://img.shields.io/badge/on-product%20hunt-blue.svg?style=flat-square\"\n       align=\"center\"\u003e\n\u003c/a\u003e\n\u003ca href=\"https://www.reddit.com/r/superProductivity/\"\u003e\n  \u003cimg alt=\"Reddit Community\"\n       src=\"https://img.shields.io/badge/Reddit-%23FF4500.svg?style=for-the-badge\u0026logo=Reddit\u0026logoColor=white\"\n       align=\"center\"\u003e\n\u003c/a\u003e\n\u003ca href=\"https://mastodon.social/@superproductivity\"\u003e\n  \u003cimg alt=\"Super Productivity on Mastodon\"\n       src=\"https://img.shields.io/badge/-MASTODON-%232B90D9?style=for-the-badge\u0026logo=mastodon\u0026logoColor=white\"\n       align=\"center\"\u003e\n\u003c/a\u003e\n\u003ca href=\"https://x.com/intent/post?text=Super%20Productivity%20%20https%3A%2F%2Fsuper-productivity.com\"\u003e\n  \u003cimg alt=\"Tweet\"\n       src=\"https://img.shields.io/badge/TWEET-%23000000.svg?style=for-the-badge\u0026logo=X\"\n       align=\"center\"\u003e\n\u003c/a\u003e\n\u003c/p\u003e\n\n\u003cp align=\"center\" style=\"text-align: center;\"\u003e\n  \n\u003ca href='https://flathub.org/apps/com.super_productivity.SuperProductivity' target=\"_blank\"\u003e\n  \u003cimg alt='Get it on Flathub'\n       src='https://flathub.org/api/badge?locale=en'\n       align=\"center\"\n       style=\"height: 50px\"\n       height=\"50\" /\u003e\n  \u003c/a\u003e\n  \n\u003ca href=\"https://snapcraft.io/superproductivity\" target=\"_blank\"\u003e\n  \u003cimg alt=\"Get it from the Snap Store\"\n       src=\"https://snapcraft.io/static/images/badges/en/snap-store-black.svg\"\n       align=\"center\"\n       style=\"height: 50px\"\n       height=\"50\"\u003e\n\u003c/a\u003e\n\u003ca href='//www.microsoft.com/store/apps/9NHFVG8361TW?cid=storebadge\u0026ocid=badge' target=\"_blank\"\u003e\n  \u003cimg src='https://developer.microsoft.com/store/badges/images/English_get-it-from-MS.png'\n       align=\"center\"\n       alt='English badge'\n       style=\"height: 50px\"\n       height=\"50\" /\u003e\n\u003c/a\u003e\n\u003ca href='//apps.apple.com/de/app/super-productivity/id1482572463?l=en\u0026mt=12' target=\"_blank\"\u003e\n  \u003cimg src='docs/screens/app-store-badge.svg'\n       align=\"center\"\n       alt='App Store Badge'\n       style=\"height: 50px\"\n       height=\"50\" /\u003e\n\u003c/a\u003e\n\u003ca href='//play.google.com/store/apps/details?id=com.superproductivity.superproductivity' target=\"_blank\"\u003e\n  \u003cimg src='docs/screens/google-play-badge.png'\n       align=\"center\"\n       alt='Play Store Badge'\n       style=\"height: 50px\"\n       height=\"50\" /\u003e\n\u003c/a\u003e\n\u003ca href='//f-droid.org/en/packages/com.superproductivity.superproductivity' target=\"_blank\"\u003e\n  \u003cimg src='https://f-droid.org/assets/fdroid-logo-text_S0MUfk_FsnAYL7n2MQye-34IoSNm6QM6xYjDnMqkufo=.svg'\n       align=\"center\"\n       alt='F-Droid Badge'\n       style=\"height: 50px\"\n       height=\"50\" /\u003e\n\u003c/a\u003e\n\u003ca href='http://apps.obtainium.imranr.dev/redirect.html?r=obtainium://add/https://github.com/johannesjo/super-productivity/releases'\u003e\n  \u003cimg src='https://raw.githubusercontent.com/ImranR98/Obtainium/main/assets/graphics/badge_obtainium.png'\n       align=\"center\"\n       alt='Obtanium Badge'\n       style=\"height: 50px\"\n       height=\"50\" /\u003e\n\u003c/a\u003e\n\u003c/p\u003e\n\n\u003cbr\u003e\n\n## :heavy_check_mark: Features\n\n- **Keep organized and focused!** Plan and categorize your tasks using sub-tasks, projects and tags and color code them as needed.\n- Use **timeboxing** and **track your time**. Create time sheets and work summaries in a breeze to easily export them to your company's time tracking system.\n- Helps you to **establish healthy \u0026 productive habits**:\n  - A **break reminder** reminds you when it's time to step away.\n  - The **anti-procrastination feature** helps you gain perspective when you really need to.\n  - Need some extra focus? A **Pomodoro timer** is also always at hand.\n  - **Collect personal metrics** to see, which of your work routines need adjustments.\n- Integrate with **Jira**, **Trello**, **GitHub**, **GitLab**, **Gitea** and **OpenProject**. Auto import tasks assigned to you, plan the details locally, automatically create work logs, and get notified immediately, when something changes.\n- Basic **CalDAV** integration.\n- Back up and synchronize your data across multiple devices with **Dropbox** and **WebDAV** support\n- Attach context information to tasks and projects. Create **notes**, attach **files** or create **project-level bookmarks** for links, files, and even commands.\n- Super Productivity **respects your privacy** and **does NOT collect any data** and there are no user accounts or registration. **You decide where you store your data!**\n- It's **free** and **open source** and always will be.\n\nAnd much more!\n\n\u003ca href=\"https://youtu.be/_mvMXWLsL-8\"\u003e\u003cimg alt=\"Work View with global links\" src=\"screens/screen_standard.png\" width=\"100%\"\u003e\u003c/a\u003e\n\n## :question: How to use it\n\nIf you need some help, [this article on dev.to is the best place to start](https://dev.to/johannesjo/getting-started-with-super-productivity-2791).\n\nIf you prefer, there is also a (long) [YouTube video available](https://www.youtube.com/watch?v=VoF2_RSdNXA).\n\nThere is another older – the app looks and feels much better now ;) – [article](https://dev.to/johannesjo/super-productivity-how-to-grow-fond-of-time-tracking-and-task-management-22ee) on how I personally might use the app - and still [another one](https://dev.to/johannesjo/the-prioritising-scheme-how-to-eat-the-frog-with-super-productivity-mlk) on how I implement the 'eat the frog' prioritizing scheme in the app.\n\n[If you have further questions, please refer to the discussions page](https://github.com/johannesjo/super-productivity/discussions).\n\n\u003cdetails\u003e\n\u003csummary\u003e \u003cb\u003e⌨ Keyboard shortcuts and short-syntax\u003c/b\u003e\u003c/summary\u003e\n\n### Keyboard shortcuts (most important)\n\n- `Shift`+`P`: Open create project dialog\n- `Shift`+`A`: Open add task bar\n- `Enter`: Edit currently focussed task title\n- `Arrow keys`: Navigate around task list\n- `D`: Mark currently focused task as done\n- `A`: Add subtask to currently focused task\n- `Y`: Toggle tracking time to currently focused task\n- `S`: Open schedule dialog for currently focused task\n- `Backspace`: Delete currently focused task\n- `ArrowRight`: Open additional info panel for currently focused task\n- `Ctrl`+`Shift`+`ArrowUp`: Move currently focused task up in list\n- `Ctrl`+`Shift`+`ArrowDown`: Move currently focused task down in list\n\n### Short-Syntax\n\nCan be used when adding a task. \u003cstrong\u003e(Each of these can be disabled in settings-\u003eshort syntax)\u003c/strong\u003e\n\n- `# \u003ctag-name\u003e`: add a tag to the task  \n  (`\"task-description #tag1\"`)\n- `\u003cnumber\u003em` or `\u003cnumber\u003eh`: set time-estimate for the task  \n  (`\"task-description 10m\"` or `\"task-description 5h\"`)\n- `@\u003ctime\u003e`: add due time to the task\n  (`\"task-description @fri 10pm\"`)\n- `+ \u003cproject-name\u003e`: add the task to an existing project  \n  (`\"task-description +Important Project\"`)\n- `Ctr + 2`: toggle between moving the new task to the bottom and top of the list\n\n\u003c/details\u003e\n\n## :globe_with_meridians: Web Version\n\nCheck out the web version even though it is a bit limited: Time tracking only works if the app is open and for idle time tracking to work, the chrome extension must be installed.\n\nIf you want the Jira integration and idle time tracking to work, you also have to download and install the [Super Productivity Chrome Extension](https://chrome.google.com/webstore/detail/super-productivity/ljkbjodfmekklcoibdnhahlaalhihmlb).\n\n## :computer: Downloads \u0026 Install\n\n### All Platforms\n\n[Install from the releases page](https://github.com/johannesjo/super-productivity/releases).\n\n### Windows\n\nDue to certification issues it's recommended to download the app from the Microsoft Store:\n\n\u003ca href='//www.microsoft.com/store/apps/9nhfvg8361tw?cid=storebadge\u0026ocid=badge'\u003e\u003cimg src='https://developer.microsoft.com/store/badges/images/English_get-it-from-MS.png' alt='English badge' width=\"127\" height=\"52\"/\u003e\u003c/a\u003e\n\nYou can also install the app using [Chocolatey](https://community.chocolatey.org/packages/super-productivity):\n\n```powershell\nchoco install super-productivity\n```\n\n### Linux\n\n#### Snap - Most distributions\n\nInstall via command-line:\n\n```bash\n# stable\nsudo snap install superproductivity\n\n# edge channel releases\nsudo snap install --channel=edge superproductivity\n\n# it is also recommended to disable updates to the app while it is running:\nsudo snap set core experimental.refresh-app-awareness=true\n```\n\n\u003ca href=\"https://snapcraft.io/superproductivity\"\u003e\n  \u003cimg alt=\"Get it from the Snap Store\" src=\"https://snapcraft.io/static/images/badges/en/snap-store-black.svg\" /\u003e\n\u003c/a\u003e\n\n#### Flatpak - Most distributions\n\nMust install Flatpak first. See [setup instructions for all distributions](https://flathub.org/setup).\n\nInstall via command-line:\n\n```bash\n# install\nflatpak install flathub com.super_productivity.SuperProductivity\n\n# run\nflatpak run com.super_productivity.SuperProductivity\n```\n\n\u003ca href='https://flathub.org/apps/com.super_productivity.SuperProductivity'\u003e\n    \u003cimg width='175' alt='Get it on Flathub' src='https://flathub.org/api/badge?locale=en'/\u003e\n  \u003c/a\u003e\n\n#### Aur - Arch Linux\n\n```bash\ngit clone https://aur.archlinux.org/superproductivity-bin.git\ncd superproductivity-bin\nmakepkg -si\n```\n\n#### AppImage\n\nIf you encounter problems, please have a look here:\nhttps://github.com/johannesjo/super-productivity/issues/3193#issuecomment-2131315513\n\n### MacOS\n\nInstall via [homebrew cask](https://github.com/caskroom/homebrew-cask):\n\n```bash\nbrew install --cask superproductivity\n```\n\n\u003ca href='//apps.apple.com/de/app/super-productivity/id1482572463?l=en\u0026mt=12' target=\"_blank\"\u003e\n  \u003cimg src='docs/screens/app-store-badge.svg'\n       alt='App Store Badge'\n       height=\"50\" /\u003e\n\u003c/a\u003e\n\n### Android\n\nA new version of the Android app is now available with **Connectivity-Free Mode**, allowing you to use the app without an internet connection.\n\nThis update offers more flexibility, supporting both fully offline usage and integration with services like WebDAV and Dropbox for syncing. Enjoy a smoother, more reliable experience whether you're online or offline.\n\nStay tuned for even more exciting updates!\n\nYou can find the Android app here:\n\n\u003ca href='//play.google.com/store/apps/details?id=com.superproductivity.superproductivity' target=\"_blank\"\u003e\n  \u003cimg src='docs/screens/google-play-badge.png'\n       align=\"center\"\n       alt='App Store Badge'\n       height=\"50\" /\u003e\n\u003c/a\u003e\n\u003ca href='//f-droid.org/en/packages/com.superproductivity.superproductivity' target=\"_blank\"\u003e\n  \u003cimg src='https://f-droid.org/assets/fdroid-logo-text_S0MUfk_FsnAYL7n2MQye-34IoSNm6QM6xYjDnMqkufo=.svg'\n       align=\"center\"\n       alt='F-Droid Badge'\n       height=\"50\" /\u003e\n\u003c/a\u003e\n\nThe sources can be [found here](/android).\n\n## Community\n\nThe development of Super Productivity is driven by a wonderful community of users and contributors. Thank you all so much for your support!\n\n### :hearts: Contributing\n\nIf you want to get involved, please check out the [CONTRIBUTING.md](CONTRIBUTING.md)\n\nThere are several ways to help.\n\n1. **Spread the word:** More users mean more people testing and contributing to the app which in turn means better stability and possibly more and better features. You can vote for Super Productivity on [Slant](https://www.slant.co/topics/14021/viewpoints/7/~productivity-tools-for-linux~super-productivity), [Product Hunt](https://www.producthunt.com/posts/super-productivity), [Softpedia](https://www.softpedia.com/get/Office-tools/Diary-Organizers-Calendar/Super-Productivity.shtml) or on [AlternativeTo](https://alternativeto.net/software/super-productivity/), you can [tweet about it](https://twitter.com/intent/tweet?text=I%20like%20Super%20Productivity%20%20https%3A%2F%2Fsuper-productivity.com), share it on [LinkedIn](http://www.linkedin.com/shareArticle?mini=true\u0026url=https://super-productivity.com\u0026title=I%20like%20Super%20Productivity\u0026), [reddit](http://www.reddit.com/submit?url=https%3A%2F%2Fsuper-productivity.com\u0026title=I%20like%20Super%20Productivity) or any of your favorite social media platforms. Every little bit helps!\n\n2. **Provide a Pull Request:** Here is a list of [the most popular community requests](https://github.com/johannesjo/super-productivity/issues?q=is%3Aissue+is%3Aopen+sort%3Areactions-%2B1-desc) and here some info on [how to run the development build](https://github.com/johannesjo/super-productivity#running-the-development-server).\n   Please make sure that you're following the [angular commit guidelines](https://github.com/angular/angular.js/blob/master/DEVELOPERS.md#commits) and to also include the issue number in your commit message, if you're fixing a particular issue (e.g.: `feat: add nice feature with the number #31`).\n\n3. **[Answer questions](https://github.com/johannesjo/super-productivity/discussions)**: You know the answer to another user's problem? Share your knowledge!\n\n4. **[Provide your opinion](https://github.com/johannesjo/super-productivity/issues?q=is%3Aissue+is%3Aopen+sort%3Areactions-%2B1-desc+label%3A%22community+feedback+wanted%22):** Some community suggestions are controversial. Your input might be helpful and if it is just an up- or down-vote.\n\n5. **[Provide a more refined UI spec for existing feature requests](https://github.com/johannesjo/super-productivity/issues?q=is%3Aissue+is%3Aopen+label%3A%22needs+concept+and%2For+ui+spec%22)**\n\n6. **[Report bugs](https://github.com/johannesjo/super-productivity/issues/new)**\n\n7. **[Make a feature or improvement request](https://github.com/johannesjo/super-productivity/issues/new)**: Something can be done better? Something essential missing? Let us know!\n\n8. **[Translations](https://github.com/johannesjo/super-productivity/tree/master/src/assets/i18n), Icons, etc.**: You don't have to be a programmer to help. Some of the icons really need improvement and many of the translations could use some love.\n\n[//]: # '[![inlang status badge](https://badge.inlang.com/?url=github.com/johannesjo/super-productivity)](https://fink.inlang.com/github.com/johannesjo/super-productivity?ref=badge)'\n[//]: #\n[//]: # 'You can use the Fink Localization Editor to edit, lint, and add translations for different languages. [Contribute via fink Guide](https://inlang.com/g/6ddyhpoi).'\n\n9. **[Sponsor the project](https://github.com/sponsors/johannesjo)**\n\n10. **[Create custom plugins](docs/plugin-development.md)**: Extend Super Productivity with your own features and integrations by developing custom plugins.\n\n### Special Thanks to our Sponsors!!!\n\nRecently support for Super Productivity has been growing! A big thank you to all our sponsors, especially the ones below!\n\n\u003cp style=\"font-size:21px; color:black;\"\u003eBrowser testing via \n        \u003ca href=\"https://www.lambdatest.com/?utm_source=superproductivity\u0026utm_medium=sponsor\" target=\"_blank\"\u003e\n            \u003cimg src=\"https://www.lambdatest.com/blue-logo.png\" style=\"vertical-align: middle;\" width=\"250\" height=\"45\" /\u003e\n        \u003c/a\u003e\n    \u003c/p\u003e\n\n_(If you are, intend to or have been a sponsor and want to be shown here, [please let me know](mailto:contact@super-productivity.com)!)_\n\n## Running the development server\n\nIf you don't want or cannot use Codespaces for any reason, here are the instructions for local development.\n\nTo run the development server you need to have Node installed (version 20 or higher required). Go to https://nodejs.org for installation instructions.\n\n**Clone repo**\n\n```bash\ngit clone https://github.com/johannesjo/super-productivity.git\n```\n\n**Install dependencies**\n\n```bash\ncd super-productivity\nnpm i -g @angular/cli\nnpm i\n# prepare the env file once\nnpm run env\n```\n\n**Run the dev server**\n\n```bash\nng serve\n```\n\nAfterwards you can open http://localhost:4200 in your browser. For most adjustments this should be enough and also enables you to use the [redux dev tools](https://chrome.google.com/webstore/detail/redux-devtools/lmhkpmbekcpmknklioeibfkpmmfibljd?hl=de).\n\nIf you want to run the app standalone do the following:\n\n```bash\nng serve\n\n# in a new console tab\nnpm start\n```\n\n### :rocket: Try with GitHub Codespaces\n\nYou can develop and run Super Productivity instantly in your browser using [GitHub Codespaces](https://github.com/features/codespaces): no need to install Node.js or any dependencies locally. On the top of the repository page, click on \"Code\", \"Codespaces\", and then on the plus button, \"Create Codespace\".\n\nYour VS Code settings can sync as usual, so your environment feels just like home. The development server starts automatically, and the dev container auto-forwards the port. Open the \"Ports\" tab and Ctrl+Click the available link to preview your running Super Productivity app.\n\nFurther customizations to the Codespaces dev container can be performed by editing the .devcontainers/devcontainers.json file according to the [Codespaces documentation](https://docs.github.com/en/codespaces/setting-up-your-project-for-codespaces/adding-a-dev-container-configuration/introduction-to-dev-containers#creating-a-custom-dev-container-configuration) and the [devcontainers full specification](https://containers.dev/implementors/spec/).\n\n### Packaging the app\n\nPackaging the app is done via [electron-builder](https://github.com/electron-userland/electron-builder). To start packaging run `npm run dist`. If you want to add new platforms and experiment with the build options the easiest way to do so is manipulating the `build` property in the [package.json](https://github.com/johannesjo/super-productivity/blob/develop/package.json), but you can also use the [command line interface of electron builder](https://www.electron.build/cli).\n\n### Building for Android\n\n_This feature was added on October 7, 2024. See [Pull Request #57](https://github.com/johannesjo/super-productivity-android/pull/57)._\n\nTo build the Android version of Super Productivity, please refer to the [Android Build Documentation](./android/README.md), which includes instructions on configuring **Connectivity-Free Mode** and **Online-Only Mode (Compatibility Mode)**.\n\nEnsure you follow the setup steps properly to configure the environment for building the app.\n\n## Run as Docker Container\n\n```bash\ndocker run -d -p 80:80 johannesjo/super-productivity:latest\n```\n\n\u003e [!NOTE]\n\u003e The command will automatically pull the container that matches the host's platform. Use `--platform` to specify a different one.\n\u003e\n\u003e Currently supported architectures: `linux/amd64`, `linux/arm64`, `linux/arm/v7`.\n\nNow you can access the web app from your browser at `http://localhost`.\n\nThis container only serves the web app, and the user data is stored in the browser. Therefore, it does not have any persistent storage.\n\n### Integrate with WebDAV backend server\n\nYou can integrate the container with a WebDAV server container to provide WebDAV service with base url `http://localhost/webdav`.\n\n**Download pre-configured files**\n\nDownload the pre-configured `docker-compose.yaml` and `webdav.yaml` from this repository to a local directory, say `sp/`.\n\n```bash\n# Alternatively, you can get them by cloning this repository\ngit clone https://github.com/johannesjo/super-productivity.git\nmkdir -p sp\ncp super-productivity/docker-compose.yaml sp/\ncp super-productivity/webdav.yaml sp/\ncd sp\n```\n\n**Setup user accounts**\n\nEdit `webdav.yaml` to configure username and password. Remember to create and assign different directories to different users (within `/data`) to avoid mixing up user data.\n\n**Start the services**\n\n```bash\ndocker compose pull\ndocker compose up -d\n```\n\nAdditionally to accessing the web app from your browser at `http://localhost`, you can set up WebDAV synchronization with base url `http://localhost/webdav/`.\n\n### Other configuration of docker container\n\nYou can provide the default values for WebDAV settings in the \"Sync\" section of the \"Settings\" page, via setting some environment variables of the docker container. This could be used for single user instances. Check out `docker-compose.yaml` in this repository for available environment variables.\n\n## Custom themes (desktop only)\n\nIn addition to color coding your projects and tags and to the dark and light theme you can also load completely custom CSS to restyle everything. To load a custom theme you simply need to put them into a new file named `styles.css` directly in the [user data folder](#user-data-folder).\n\nThere is a great set of [themes available for download in this repository](https://github.com/johannesjo/super-productivity-themes/tree/main/dist) as well as some [info on how to create your own custom themes](https://github.com/johannesjo/super-productivity-themes).\n\n## Custom WebDAV Syncing\n\nIf using the integrated WebDAV Syncing is not working out for you, you can also try to sync all app files, which are located in the [user data folder](#user-data-folder).\n\n## Automatic Backups\n\nFor the desktop version automatic backups are stored by default in the `backup` subfolder of the [user data folder](#user-data-folder). Once you locate a backup, you can restore it on the settings page under `Sync \u0026 Export/Import/Export/Import from file`.\n\n## User Data Folder\n\nWhere user data is stored differs from OS to OS. The most common locations are:\n\n| OS          | Location                                                                                        |\n| ----------- | ----------------------------------------------------------------------------------------------- |\n| **Mac OS**  | `~/Library/Application Support/superProductivity/`                                              |\n| **Windows** | `C:\\Users\\\u003cYOUR_USER_NAME\u003e\\AppData\\Roaming\\superProductivity/` or `%APPDATA%\\superProductivity` |\n| **Linux**   | `~/.config/superProductivity/`                                                                  |\n\nThe path should be shown when you go to the \"Automatic Backups\" section on the configuration page (minus the \"backup\" subfolder). You can also see it printed out when you start the app from the command line.\n\nFor web browsers, data is simply stored for the current user inside the browser storage.\n\n### Using a custom folder to save user data\n\nYou can specify a custom folder for saving your data by starting the application with the `--user-data-dir` parameter like so:\n\n```bash\nsuperproductivity --user-data-dir=/path/to/my/data\n```\n\n### Linux/Wayland Compatibility\n\nIf you're experiencing issues running Super Productivity on Wayland (such as rendering problems, VSync errors, or GLib-GObject warnings), you can force the application to use X11 mode by starting it with the `--force-x11` parameter:\n\n```bash\nsuperproductivity --force-x11\n```\n\nThis will automatically apply compatibility fixes including:\n\n- Forcing the Ozone platform to use X11 instead of Wayland\n- Disabling GPU VSync to prevent GetVSyncParametersIfAvailable() errors\n- Setting the appropriate environment variables for X11 compatibility\n\nThe application will automatically detect Wayland sessions and apply these fixes, but you can use this flag if automatic detection doesn't work properly.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fjohannesjo%2Fsuper-productivity","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fjohannesjo%2Fsuper-productivity","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fjohannesjo%2Fsuper-productivity/lists"}