A production-ready, multi-tenant SaaS project management platform. Plan, track, and deliver projects with powerful Kanban boards, real-time collaboration, and insightful analytics.
- Multi-Tenant Architecture — Complete data isolation between organizations
- Kanban Boards — Drag-and-drop task management with customizable columns
- Workspace & Project Management — Hierarchical organization of work
- Task Tracking — Subtasks, checklists, comments, attachments, labels, and time tracking
- Role-Based Access Control — Five roles: super_admin, admin, manager, member, viewer
- Dashboard & Analytics — Task statistics, completion rates, and recent activity
- Notifications — Real-time notifications for assignments, invitations, and mentions
- Internationalization — English and Farsi/Persian support with RTL layout
- Dark/Light Theme — System-aware theme switching
- Mobile App — React Native (Expo) with bottom tab navigation
| Layer | Technology |
|---|---|
| Frontend | Next.js 15, React 19, TypeScript, Tailwind CSS, Zustand, React Query |
| Backend | Python 3.12, FastAPI, SQLAlchemy (async), Alembic, Pydantic v2 |
| Database | MySQL 8.0 |
| Cache | Redis 7 |
| Storage | MinIO (S3-compatible) |
| Mobile | React Native (Expo SDK 52) |
| Containers | Docker & Docker Compose |
| CI/CD | GitHub Actions |
- Docker & Docker Compose v2+
git clone https://github.com/flowdesk/flowdesk.git
cd FlowDesk
docker compose up -d| Service | URL |
|---|---|
| Frontend | http://localhost:3000 |
| Backend API | http://localhost:8000 |
| Swagger Docs | http://localhost:8000/docs |
| MinIO Console | http://localhost:9001 |
FlowDesk/
├── backend/ # Python FastAPI backend
├── frontend/ # Next.js 15 frontend
├── mobile/ # React Native (Expo) mobile app
├── docker/ # Docker configurations
├── docs/ # Documentation & GitHub Wiki
├── docker-compose.yml # Development Docker Compose
└── README.md
| Document | Description |
|---|---|
| Deployment Guide | Build and run with Docker |
| Development Guide | Local development setup |
| Database Schema | ER diagram and table definitions |
| GitHub Wiki | Full project documentation |
See CONTRIBUTING.md for guidelines.
This project is licensed under the MIT License — see the LICENSE file for details.