Focalboard is an open source, self-hosted project management platform designed as a private alternative to Trello, Notion, and Asana. It provides both standalone desktop applications for personal use and a multi-user server edition for teams, enabling users to create Kanban boards, track goals, and manage tasks without relying on cloud-hosted services. The project was originally developed by Mattermost but is now unmaintained, with the community invited to take over maintenance. Focalboard supports cross-platform deployment—Windows, macOS, Linux—and offers a REST API for integration. Its architecture includes a Go backend and TypeScript-based web frontend, with SQLite as the default database for personal editions.
What You Get
- Kanban-style boards - Create customizable boards with cards, lists, and drag-and-drop functionality to visualize workflows, similar to Trello.
- Multi-user server support - Run a self-hosted instance with user authentication and team collaboration features, ideal for small teams or departments.
- Desktop applications - Native macOS, Windows, and Linux apps that bundle the server and SQLite for offline personal task management.
- REST API access - Expose board data via a documented Swagger API for integrations, automation, or custom frontends.
- Self-hosted and private - Full control over data; no third-party cloud dependencies, suitable for compliance-sensitive environments.
- Cross-platform builds via Docker - Official Docker images and build scripts allow deployment on any platform supporting containerization.
Common Use Cases
- Building a private team project board - A small startup uses Focalboard Personal Server on an internal Ubuntu machine to track sprint tasks without using cloud-based tools like Jira or Trello.
- Personal productivity tracking - A developer uses the Focalboard desktop app on macOS to manage personal todos, learning goals, and side projects without syncing data externally.
- Replacing SaaS project tools for compliance - A healthcare team migrates from Asana to Focalboard to ensure PHI data never leaves their on-premises infrastructure.
- DevOps teams managing internal tools - Engineers deploy Focalboard via Docker in a Kubernetes cluster to coordinate documentation, bug triage, and feature backlog across distributed teams.
Under The Hood
Mattermost Focalboard is a flexible, extensible collaboration platform that combines task management with visual board interfaces, supporting multi-platform development and deep integration capabilities. It is designed to be modular and adaptable across web, desktop, and import functionalities.
Architecture
The project adopts a layered architecture that clearly separates frontend, backend, and platform-specific modules to support cross-platform deployment.
- Modular design with distinct components for web, desktop, and import/export functionalities
- Clear separation of concerns between UI, business logic, and data handling layers
- Support for extensible architecture through plugin and integration points
Tech Stack
The tech stack is built around TypeScript and Go, leveraging modern web development practices with a strong emphasis on tooling and testing.
- Built primarily in TypeScript and Go, with React as the core frontend framework
- Extensive use of modern JavaScript tooling including Parcel, ESLint, and TypeScript compiler
- Comprehensive test infrastructure with Jest and TypeScript-based runners
- Integrates a wide range of import/export libraries for third-party platform support
Code Quality
The codebase reflects a mixed quality landscape with strengths in testing and error handling, although some inconsistencies and technical debt remain.
- Strong test coverage across components, modules, and integration points
- Consistent error handling through try/catch blocks and explicit error propagation
- Varied code style and naming conventions across different parts of the codebase
- Evidence of accumulated technical debt in some legacy modules and workflows
What Makes It Unique
Focalboard stands out through its blend of visual task management and multi-platform extensibility, offering a unique approach to flexible collaboration tools.
- Combines traditional task management with visual board interfaces for enhanced user experience
- Offers deep integration capabilities and modular architecture that supports cross-platform deployment
- Supports import from popular tools like Jira, Asana, and Notion with extensible data handling
- Designed for flexibility and extensibility, enabling custom integrations and platform-specific adaptations