Skip to content

Vedant08-blip/Track-Flow

Repository files navigation

πŸš€ TrackFlow

Enterprise-grade agile project management β€” built for clarity, speed, and real collaboration.

React Vite TailwindCSS Express MongoDB


πŸ“Œ What is TrackFlow?

TrackFlow is a full-stack agile project management platform designed for engineering teams who need more than a basic task board. It combines sprint planning, real-time collaboration, AI-powered insights, GitHub integration, and detailed analytics β€” all in a single, responsive interface.

Whether you're managing a solo side project or coordinating across a team, TrackFlow gives you the tools to ship faster and communicate better.


✨ Core Features

πŸ—‚οΈ Agile Workflow

  • Kanban Board β€” drag-and-drop task management with customizable columns
  • Backlog Management β€” organize, prioritize, and groom your task backlog
  • Sprint Planning β€” define sprints, assign work, and track progress against goals

🀝 Team & Collaboration

  • Real-time collaboration β€” work simultaneously with your team without conflicts
  • Team communication β€” built-in messaging and discussion threads per project

πŸ€– AI & Intelligence

  • AI Chat Assistant β€” ask questions about your project and get instant, contextual insights
  • Intelligent Analysis β€” AI-driven suggestions to improve team productivity and delivery

πŸ“Š Reporting & Analytics

  • Time Tracking β€” log time per task and visualize where effort is going
  • Analytics Dashboard β€” charts and graphs powered by Recharts for deep visibility
  • PDF & CSV Export β€” generate professional reports and share them instantly

πŸ”— Integrations

  • GitHub Integration β€” link repositories and issues directly to TrackFlow tasks
  • API-first backend β€” RESTful Express API ready for future integrations

🎨 Customization

  • Theme Customization β€” personalize the UI to match your team's style
  • Responsive UI β€” works seamlessly across desktop and mobile
  • Smooth Animations β€” Framer Motion powered transitions throughout

πŸ—οΈ Project Structure

TrackFlow/
β”œβ”€β”€ πŸ“ src/                          # Frontend (React + Vite)
β”‚   β”œβ”€β”€ components/
β”‚   β”‚   β”œβ”€β”€ auth/                    # Login, register components
β”‚   β”‚   β”œβ”€β”€ backlog/                 # Backlog management UI
β”‚   β”‚   β”œβ”€β”€ board/                   # Kanban board components
β”‚   β”‚   β”œβ”€β”€ dashboard/               # Dashboard & overview
β”‚   β”‚   β”œβ”€β”€ planning/                # Sprint planning components
β”‚   β”‚   β”œβ”€β”€ portfolio/               # Portfolio view
β”‚   β”‚   β”œβ”€β”€ reports/                 # Reporting & exports
β”‚   β”‚   β”œβ”€β”€ shared/                  # Reusable components (buttons, modals, etc.)
β”‚   β”‚   └── timeline/                # Timeline/Gantt components
β”‚   β”‚
β”‚   β”œβ”€β”€ context/                     # Global state management
β”‚   β”‚   β”œβ”€β”€ AuthContext.jsx          # Authentication state
β”‚   β”‚   β”œβ”€β”€ ProjectContext.jsx       # Project state
β”‚   β”‚   β”œβ”€β”€ ThemeContext.jsx         # Theme switching
β”‚   β”‚   β”œβ”€β”€ ChatAssistantContext.jsx # AI chat state
β”‚   β”‚   β”œβ”€β”€ TimeTrackingContext.jsx  # Time tracking state
β”‚   β”‚   β”œβ”€β”€ GitHubIntegrationContext.jsx
β”‚   β”‚   └── CollaborationContext.jsx # Real-time collaboration
β”‚   β”‚
β”‚   β”œβ”€β”€ pages/                       # Route-level pages
β”‚   β”‚   β”œβ”€β”€ LoginPage.jsx
β”‚   β”‚   β”œβ”€β”€ RegisterPage.jsx
β”‚   β”‚   β”œβ”€β”€ DashboardPage.jsx
β”‚   β”‚   β”œβ”€β”€ BoardPage.jsx
β”‚   β”‚   β”œβ”€β”€ BacklogPage.jsx
β”‚   β”‚   β”œβ”€β”€ PlanningPage.jsx
β”‚   β”‚   β”œβ”€β”€ ReportsPage.jsx
β”‚   β”‚   └── PortfolioPage.jsx
β”‚   β”‚
β”‚   β”œβ”€β”€ routes/                      # Router configuration
β”‚   β”‚   └── AppRouter.jsx
β”‚   β”‚
β”‚   β”œβ”€β”€ utils/                       # Helper functions
β”‚   β”‚   β”œβ”€β”€ helpers.js
β”‚   β”‚   β”œβ”€β”€ mockData.js
β”‚   β”‚   └── reportGenerator.js
β”‚   β”‚
β”‚   β”œβ”€β”€ hooks/                       # Custom React hooks
β”‚   β”‚   └── useUserProfile.js
β”‚   β”‚
β”‚   β”œβ”€β”€ data/                        # Static data
β”‚   β”‚   └── avatarMetadata.js
β”‚   β”‚
β”‚   β”œβ”€β”€ App.jsx
β”‚   β”œβ”€β”€ main.jsx
β”‚   └── index.css
β”‚
β”œβ”€β”€ πŸ“ backend/                      # Backend (Node.js + Express)
β”‚   β”œβ”€β”€ server.js                    # Express server entry point
β”‚   β”‚
β”‚   β”œβ”€β”€ config/
β”‚   β”‚   └── database.js              # MongoDB connection
β”‚   β”‚
β”‚   β”œβ”€β”€ models/                      # Mongoose schemas
β”‚   β”‚   β”œβ”€β”€ User.js
β”‚   β”‚   β”œβ”€β”€ Project.js
β”‚   β”‚   └── schemas.js
β”‚   β”‚
β”‚   β”œβ”€β”€ routes/                      # API route handlers
β”‚   β”‚   β”œβ”€β”€ auth.js
β”‚   β”‚   β”œβ”€β”€ projectRoutes.js
β”‚   β”‚   β”œβ”€β”€ storyRoutes.js
β”‚   β”‚   β”œβ”€β”€ iterationRoutes.js
β”‚   β”‚   β”œβ”€β”€ chatRoutes.js
β”‚   β”‚   β”œβ”€β”€ teamRoutes.js
β”‚   β”‚   β”œβ”€β”€ commentRoutes.js
β”‚   β”‚   └── index.js
β”‚   β”‚
β”‚   β”œβ”€β”€ controllers/                 # Business logic
β”‚   β”‚   β”œβ”€β”€ userController.js
β”‚   β”‚   β”œβ”€β”€ projectController.js
β”‚   β”‚   β”œβ”€β”€ storyController.js
β”‚   β”‚   β”œβ”€β”€ iterationController.js
β”‚   β”‚   β”œβ”€β”€ chatController.js
β”‚   β”‚   β”œβ”€β”€ teamController.js
β”‚   β”‚   └── commentController.js
β”‚   β”‚
β”‚   β”œβ”€β”€ middleware/                  # Express middleware
β”‚   β”‚   β”œβ”€β”€ authMiddleware.js        # JWT verification
β”‚   β”‚   β”œβ”€β”€ errorMiddleware.js
β”‚   β”‚   └── validationMiddleware.js
β”‚   β”‚
β”‚   β”œβ”€β”€ services/                    # External service integrations
β”‚   β”‚   └── databaseService.js
β”‚   β”‚
β”‚   β”œβ”€β”€ utils/                       # Helper utilities
β”‚   β”‚   β”œβ”€β”€ constants.js
β”‚   β”‚   β”œβ”€β”€ helpers.js
β”‚   β”‚   └── logger.js
β”‚   β”‚
β”‚   └── package.json
β”‚
β”œβ”€β”€ πŸ“ public/                       # Static assets
β”‚   β”œβ”€β”€ screenshots/
β”‚   β”œβ”€β”€ Avatar/
β”‚   └── favicon.svg
β”‚
β”œβ”€β”€ vite.config.js
β”œβ”€β”€ package.json
β”œβ”€β”€ README.md
└── LICENSE

🧰 Tech Stack

Layer Technology
Frontend React 18 + Vite
Styling Tailwind CSS
Animations Framer Motion
Charts Recharts
Backend Node.js + Express
Database MongoDB + Mongoose
Auth JWT-based authentication

⚑ Getting Started

Prerequisites

  • Node.js v18+
  • MongoDB (local or Atlas)

Frontend

git clone https://github.com/Vedant08-blip/Track-Flow.git
cd Track-Flow
npm install
npm run dev

App runs at http://localhost:5173

Backend

cd backend
npm install
npm run dev

API runs at http://localhost:5000/api/v1


πŸ“‘ API Reference

Base URL: http://localhost:5000/api/v1

Method Endpoint Description
POST /auth/register Register a new user
POST /auth/login Login and receive JWT
GET /projects Fetch all projects
POST /projects Create a new project
PUT /projects/:id Update a project
DELETE /projects/:id Delete a project

πŸ“„ License

This project is licensed under the BSD 2-Clause License. See the LICENSE file for details.


Made with β˜• and consistency β€” 122 commits and still counting.

About

A feature-rich Kanban task tracker built with React 19 + Vite. Supports drag-and-drop task flow, recharts-powered analytics, date-based scheduling, and animated UI via Framer Motion.

Resources

License

Stars

Watchers

Forks

Releases

No releases published

Packages

 
 
 

Contributors

Languages