ByteFixers

A modern, full-featured project management tool for teams to collaborate, track tasks, manage projects, and communicate efficiently.

---

🚀 Features

• User Authentication (JWT-based)
• Project & Task Management (CRUD, priorities, status, subtasks)
• Team Collaboration (teams, member assignment)
• File Upload & Management (Cloudinary integration)
• Notifications (real-time, per user)
• Calendar & Scheduling
• Chat System
• Activity Logging
• Responsive UI (React, Material UI, TailwindCSS)
• API-first Design (RESTful endpoints)
• CI/CD (GitHub Actions)
• Testing (Jest)

---

🏗️ Tech Stack

• Frontend: React, Material UI, TailwindCSS
• Backend: Node.js, Express.js
• Database: MongoDB (Mongoose)
• Authentication: JWT
• File Storage: Cloudinary
• Email: Nodemailer (Gmail)
• AI Integration: Gemini API
• Testing: Jest
• CI/CD: GitHub Actions

---

👥 Team

• Habiba Rafique -> (HABIBARAFIQ) (Team Leader)
• Ekramul Haque Amin -> (Amin-2005022)
• Tamim Hasan Saad -> (Tamim-saad)

Mentor: Moshiuzzaman Shozon Raj

---

📦 Getting Started

Prerequisites

• Node.js (v16+)
• npm (v8+)
• MongoDB (v6+)
• Git

1. Clone the repository

git clone https://github.com/Learnathon-By-Geeky-Solutions/bytefixers.git
cd bytefixers

2. Backend Setup

cd backend
cp .env.example .env # Edit with your credentials
npm install
npm run dev

• See docs/setup.md for environment variables.

3. Frontend Setup

cd ../frontend
cp .env.example .env # Edit with your backend URL
npm install
npm run dev

• Frontend: http://localhost:3000
• Backend: ${process.env.REACT_APP_BASE_URL}

---

🧪 Testing

• Backend:

  cd backend && npm test

• Frontend:

  cd frontend && npm test

---

📝 Development Guidelines

1. Create feature branches
2. Make small, focused commits
3. Write descriptive commit messages
4. Create pull requests for review
5. Follow Contributing Guidelines

---

📡 API Overview

• User: /api/user/*
• Projects: /projects/*
• Tasks: /tasks/*
• Teams: /teams/*
• Files: /files/*
• Notifications: /api/notifications/*
• Calendar: /api/calendar/*
• Chat: /api/chat/*

See API Documentation for full details.

---

🗄️ Database Models

• User, Project, Task, Subtask, Team, Notification, Attachment
  See docs/documentation.md#database-models

---

☁️ Services Setup

• Cloudinary: For file uploads (setup)
• Gmail: For email notifications (setup)
• Gemini API: For AI features (setup)

---

📚 Documentation & Resources

• UI Figma Design
• Project Documentation
• Development Setup Guide
• Tech Stack Overview

---