{"id":14424226,"url":"https://github.com/mattermost-community/focalboard","last_synced_at":"2025-11-18T15:03:59.403Z","repository":{"id":37032544,"uuid":"301793434","full_name":"mattermost-community/focalboard","owner":"mattermost-community","description":"Focalboard is an open source, self-hosted alternative to Trello, Notion, and Asana.","archived":false,"fork":false,"pushed_at":"2024-09-27T13:56:19.000Z","size":58844,"stargazers_count":23351,"open_issues_count":758,"forks_count":2151,"subscribers_count":151,"default_branch":"main","last_synced_at":"2025-05-11T05:47:50.832Z","etag":null,"topics":["asana","collaboration","goal-tracking","golang","hacktoberfest","kanban-board","notion","project","project-management","trello"],"latest_commit_sha":null,"homepage":"https://www.focalboard.com","language":"TypeScript","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"other","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/mattermost-community.png","metadata":{"files":{"readme":"README.md","changelog":"CHANGELOG.md","contributing":"CONTRIBUTING.md","funding":null,"license":"LICENSE.txt","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":".github/CODEOWNERS","security":"SECURITY.md","support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null}},"created_at":"2020-10-06T16:46:23.000Z","updated_at":"2025-05-11T05:18:20.000Z","dependencies_parsed_at":"2023-09-27T02:57:56.777Z","dependency_job_id":"13daefb8-bd58-4920-965b-f8446498ee99","html_url":"https://github.com/mattermost-community/focalboard","commit_stats":{"total_commits":3249,"total_committers":267,"mean_commits":"12.168539325842696","dds":0.7857802400738689,"last_synced_commit":"bfaa37fc2445c76620bb6fda5ceceb909e65fd30"},"previous_names":["mattermost-community/focalboard","mattermost/focalboard"],"tags_count":168,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/mattermost-community%2Ffocalboard","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/mattermost-community%2Ffocalboard/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/mattermost-community%2Ffocalboard/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/mattermost-community%2Ffocalboard/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/mattermost-community","download_url":"https://codeload.github.com/mattermost-community/focalboard/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":253523733,"owners_count":21921818,"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":["asana","collaboration","goal-tracking","golang","hacktoberfest","kanban-board","notion","project","project-management","trello"],"created_at":"2024-08-30T02:02:28.580Z","updated_at":"2025-11-18T15:03:59.357Z","avatar_url":"https://github.com/mattermost-community.png","language":"TypeScript","funding_links":[],"categories":["TypeScript","Apps","HarmonyOS","project-management","Utilities","Table of Contents","🔧 Utilities \u0026 Miscellaneous"],"sub_categories":["KnowledgeBase","Windows Manager","Productivity","Project Management"],"readme":"\u003e [!WARNING]\n\u003e This repository is currently not maintained. If you're interested in becoming a maintainer please [let us know here](https://github.com/mattermost-community/focalboard/issues/5038).\n\u003e\n\u003e This repository only contains standalone Focalboard. If you're looking for the Mattermost plugin please see [mattermost/mattermost-plugin-boards](https://github.com/mattermost/mattermost-plugin-boards).\n\u003e\n\n# Focalboard\n\n![CI Status](https://github.com/mattermost/focalboard/actions/workflows/ci.yml/badge.svg)\n![CodeQL](https://github.com/mattermost/focalboard/actions/workflows/codeql-analysis.yml/badge.svg)\n![Dev Release](https://github.com/mattermost/focalboard/actions/workflows/dev-release.yml/badge.svg)\n![Prod Release](https://github.com/mattermost/focalboard/actions/workflows/prod-release.yml/badge.svg)\n\n![Focalboard](website/site/static/img/hero.jpg)\n\nFocalboard is an open source, multilingual, self-hosted project management tool that's an alternative to Trello, Notion, and Asana.\n\nIt helps define, organize, track and manage work across individuals and teams. Focalboard comes in two editions:\n\n* **[Personal Desktop](https://www.focalboard.com/docs/personal-edition/desktop/)**: A standalone, single-user [macOS](https://apps.apple.com/app/apple-store/id1556908618?pt=2114704\u0026ct=website\u0026mt=8), [Windows](https://www.microsoft.com/store/apps/9NLN2T0SX9VF?cid=website), or [Linux](https://www.focalboard.com/download/personal-edition/desktop/#linux-desktop) desktop app for your own todos and personal projects.\n\n* **[Personal Server](https://www.focalboard.com/download/personal-edition/ubuntu/)**: A standalone, multi-user server for development and personal use.\n\n## Try Focalboard\n\n### Personal Desktop (Windows, Mac or Linux Desktop)\n\n* **Windows**: Download from the [Windows App Store](https://www.microsoft.com/store/productId/9NLN2T0SX9VF) or download `focalboard-win.zip` from the [latest release](https://github.com/mattermost/focalboard/releases), unpack, and run `Focalboard.exe`.\n* **Mac**: Download from the [Mac App Store](https://apps.apple.com/us/app/focalboard-insiders/id1556908618?mt=12).\n* **Linux Desktop**: Download `focalboard-linux.tar.gz` from the [latest release](https://github.com/mattermost/focalboard/releases), unpack, and open `focalboard-app`.\n\n### Personal Server\n\n**Ubuntu**: You can download and run the compiled Focalboard **Personal Server** on Ubuntu by following [our latest install guide](https://www.focalboard.com/download/personal-edition/ubuntu/).\n\n### API Docs\n\nBoards API docs can be found over at \u003chttps://htmlpreview.github.io/?https://github.com/mattermost/focalboard/blob/main/server/swagger/docs/html/index.html\u003e\n\n### Getting started\n\nOur [developer guide](https://developers.mattermost.com/contribute/focalboard/personal-server-setup-guide) has detailed instructions on how to set up your development environment for the **Personal Server**. You can also join the [~Focalboard community channel](https://community.mattermost.com/core/channels/focalboard) to connect with other developers.\n\nCreate an `.env` file in the focalboard directory that contains:\n\n```\nEXCLUDE_ENTERPRISE=\"1\"\n```\n\nTo build the server:\n\n```\nmake prebuild\nmake\n```\n\nTo run the server:\n\n```\n ./bin/focalboard-server\n```\n\nThen navigate your browser to [`http://localhost:8000`](http://localhost:8000) to access your Focalboard server. The port is configured in `config.json`.\n\nOnce the server is running, you can rebuild just the web app via `make webapp` in a separate terminal window. Reload your browser to see the changes.\n\n### Building and running standalone desktop apps\n\nYou can build standalone apps that package the server to run locally against SQLite:\n\n* **Windows**:\n  * *Requires Windows 10, [Windows 10 SDK](https://developer.microsoft.com/en-us/windows/downloads/sdk-archive/) 10.0.19041.0, and .NET 4.8 developer pack*\n  * Open a `git-bash` prompt.\n  * Run `make prebuild`\n  * The above prebuild step needs to be run only when you make changes to or want to install your npm dependencies, etc.\n  * Once the prebuild is completed, you can keep repeating the below steps to build the app \u0026 see the changes.\n  * Run `make win-wpf-app`\n  * Run `cd win-wpf/msix \u0026\u0026 focalboard.exe`\n* **Mac**:\n  * *Requires macOS 11.3+ and Xcode 13.2.1+*\n  * Run `make prebuild`\n  * The above prebuild step needs to be run only when you make changes to or want to install your npm dependencies, etc.\n  * Once the prebuild is completed, you can keep repeating the below steps to build the app \u0026 see the changes.\n  * Run `make mac-app`\n  * Run `open mac/dist/Focalboard.app`\n* **Linux**:\n  * *Tested on Ubuntu 18.04*\n  * Install `webgtk` dependencies\n    * Run `sudo apt-get install libgtk-3-dev`\n    * Run `sudo apt-get install libwebkit2gtk-4.0-dev`\n  * Run `make prebuild`\n  * The above prebuild step needs to be run only when you make changes to or want to install your npm dependencies, etc.\n  * Once the prebuild is completed, you can keep repeating the below steps to build the app \u0026 see the changes.\n  * Run `make linux-app`\n  * Uncompress `linux/dist/focalboard-linux.tar.gz` to a directory of your choice\n  * Run `focalboard-app` from the directory you have chosen\n* **Docker**:\n  * To run it locally from offical image:\n    * `docker run -it -p 80:8000 mattermost/focalboard`\n  * To build it for your current architecture:\n    * `docker build -f docker/Dockerfile .`\n  * To build it for a custom architecture (experimental):\n    * `docker build -f docker/Dockerfile --platform linux/arm64 .`\n\nCross-compilation currently isn't fully supported, so please build on the appropriate platform. Refer to the GitHub Actions workflows (`build-mac.yml`, `build-win.yml`, `build-ubuntu.yml`) for the detailed list of steps on each platform.\n\n### Unit testing\n\nBefore checking in commits, run `make ci`, which is similar to the `.gitlab-ci.yml` workflow and includes:\n\n* **Server unit tests**: `make server-test`\n* **Web app ESLint**: `cd webapp; npm run check`\n* **Web app unit tests**: `cd webapp; npm run test`\n* **Web app UI tests**: `cd webapp; npm run cypress:ci`\n\n### Staying informed\n\n* **Changes**: See the [CHANGELOG](CHANGELOG.md) for the latest updates\n* **Bug Reports**: [File a bug report](https://github.com/mattermost/focalboard/issues/new?assignees=\u0026labels=bug\u0026template=bug_report.md\u0026title=)\n* **Chat**: Join the [~Focalboard community channel](https://community.mattermost.com/core/channels/focalboard)\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fmattermost-community%2Ffocalboard","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fmattermost-community%2Ffocalboard","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fmattermost-community%2Ffocalboard/lists"}