CommitFlow is an AI-powered project management and analytics platform designed for modern development teams.
It connects with your GitHub repositories to automatically analyze commits, visualize contributor activity, and provide smart project insights -- while also helping teams manage tasks via an integrated Kanban board.

With CommitFlow, you can plan, track, and analyze your projects -- all in one place.

• AI Recommendations - Get automatic suggestions for prioritization and sprint planning.
• Smart Summaries - Let AI summarize repository activity and project status.
• Insight Chatbot - Ask questions like "which tasks are in progress??" or "who contributed the most to the commitflow repo?"

A beautiful, AI-assisted workspace for managing your projects and tasks:

• Kanban Board - Organize tasks visually using drag-and-drop.
  Each task card shows priority color accents, assignee avatars, and due dates.
• List View - See all tasks in a clean table layout; click any row to open task details.
• Timeline View - A Gantt-style horizontal timeline to visualize progress and overlaps between tasks.
• Task Details Modal -
  • Rich text editor (React Quill) for descriptions
  • File attachments (via AWS S3 integration)
  • Inline comments with author, timestamp, and preview links
• Smart Selectors -
  • Assignee and Priority fields powered by React Select, dynamically colored per user or priority level
• Workspace Management -
  Add workspace.
• Project Management Sidebar -
  • Create or delete projects easily
  • Integrated SweetAlert2 confirmations for safe deletions
• Team Management -
  Add or remove team members using modern UI components, with color-coded avatars automatically generated.
  • Toast notifications (react-toastify) for success actions (e.g., project or member added)
• Dark/Light Mode Aware -
  Smooth color transitions and well-tuned contrast for both themes.
• Due date labels: Due Today & Overdue
• Filter Assigned to Me

• Follow up tasks via WhatsApp
  • Generates dynamic wa.me link (manual click -- no API yet)
  • Pre-filled message with task title & status
• Real-time collaboration coming soon
• Follow up tasks via WhatsApp
• Automatic email notifications sent to team members when tasks are updated
• Invite team members via email with secure join links

• Works seamlessly without internet
• Local storage caching (offline-first approach)
• Auto-synchronization when back online

• GitHub Analytics - Fetch organization repositories, commits, and contributor stats.
• Contribution Breakdown - Understand who contributes what and when.
• Activity Timeline - Visualize commit frequency and collaboration trends.

• Smooth animations
• Responsive layout
• Clean, minimalist UX with focus on productivity

• React + Vite
• TypeScript
• TailwindCSS
• Zustand (State Management)
• LocalStorage / IndexedDB (Offline Sync)
• React Query (Data Fetching & Sync Management)
• Socket.IO Client (Real-time updates)
• React Quill (Rich Text Editor)
• SweetAlert2 (Dialogs)
• React Toastify (Notifications)
• Framer Motion / GSAP (Animations & interactive UI)
• XLSX (Export Excel)

• Nest.js
• TypeScript
• Prisma ORM
• PostgreSQL
• Socket.IO Gateway (Real-time events)
• Nodemailer (Email Delivery via SMTP)
• Multer (File upload middleware)
• Class Validator / Class Transformer
• Swagger (API documentation)
• Google TTS API
• AWS SDK for S3 Storage
• JWT Authentication (Access & Refresh Tokens)
• OpenAI API Integration (AI features / content generation)

• PostgreSQL Database - Structured project and task data.
• AWS S3 Storage - Media & attachments.
• SMTP Email (Nodemailer) - Invitations & notifications.
• Environment Variables (.env) - Secure credential management.
• WebSocket Gateway - Realtime updates via Socket.IO.
• JWT Authentication - Secure login, workspace access, and API protection.
• OpenAI Integration - AI-driven generation (text, automation, suggestions).
• LocalStorage + IndexedDB - Offline-first data with auto-sync.
• Swagger UI - API documentation.

• Docker and Docker Compose
• A GitHub Personal Access Token (with repo scope)
• An OpenAI API Key (for AI Insights & Automation)
• AWS S3 Credentials (for document and image storage)

Then fill in your configuration values:

Note: Use db as the PostgreSQL host inside Docker (not localhost).

For production:

For development (with hot reload and live updates):

• Email: admin@example.com
• Password: admin123

Then add a new PostgreSQL server:

If this is your first time running CommitFlow, run a Prisma database sync:

The scripts/build.sh script automatically handles Prisma setup on first run.

Development (hot reload):

Production:

You can switch between development and production using different Docker Compose files.

CommitFlow is open source and welcomes contributions!
If you'd like to improve the Kanban UI, enhance the AI insights, or build integrations for new project tools -- feel free to fork and open a pull request.

This project is licensed under the MIT License.
Feel free to use, modify, and distribute it for both personal and commercial projects.

Created with by developers who love open source, AI, and productivity.