🎯 SupportBro

A comprehensive AI-powered support ticket system with real-time chat and intelligent assistance

🚀 Quick Start

# Install all dependencies
npm run install:all

# Start both frontend and backend
npm run dev

That's it! Open http://localhost:3000 in your browser.

📖 Read the Quick Start Guide for detailed instructions.

📁 Monorepo Structure

SupportBro/
├── support-frontend/          # React frontend (Port 3000)
├── support-ticket-system/     # Express backend (Port 5000)
├── package.json               # Monorepo scripts
├── QUICKSTART.md              # Quick start guide
└── MONOREPO.md                # Detailed documentation

✨ Features

• 🎫 Ticket Management - Create, assign, and track support tickets
• 💬 Real-time Chat - Socket.IO powered instant messaging
• 🤖 AI Assistant - Groq AI integration for intelligent responses
• 👥 Role-based Access - Client and Engineer portals
• 🔐 JWT Authentication - Secure user authentication
• 📊 Dashboard - Real-time statistics and analytics
• 🔍 Smart Search - Tavily API integration
• 🎨 Modern UI - Tailwind CSS with responsive design

🛠️ Tech Stack

Frontend

• React 19 + React Router
• Tailwind CSS + Headless UI
• Socket.IO Client
• Axios

Backend

• Express.js + Socket.IO
• MongoDB + Mongoose
• JWT Authentication
• Groq AI + Tavily APIs

📋 Available Scripts

Command	Description
npm run dev	Run both servers with hot reload
npm run install:all	Install all dependencies
npm run build	Build frontend for production
./dev.sh	Quick dev start (Linux/Mac)
./setup.sh	One-time setup script

See MONOREPO.md for all available commands.

🔧 Environment Setup

Environment files are pre-configured in:

• support-ticket-system/.env - Backend configuration
• support-frontend/.env - Frontend configuration

Update the MongoDB URI and API keys with your credentials.

📖 Documentation

• QUICKSTART.md - Get started in 2 minutes
• MONOREPO.md - Complete monorepo documentation
• Frontend README - support-frontend/README.md
• Backend README - support-ticket-system/README.md

🤝 Contributing

1. Fork the repository
2. Create a feature branch (git checkout -b feature/amazing-feature)
3. Commit your changes (git commit -m 'Add amazing feature')
4. Push to the branch (git push origin feature/amazing-feature)
5. Open a Pull Request

📝 License

ISC

👨‍💻 Author

Sam123336

🙏 Acknowledgments

• Groq AI for intelligent responses
• Tavily for search capabilities
• MongoDB Atlas for database hosting

---

⭐ Star this repo if you find it helpful!

SupportBro

Cloud-Native-DevOps-Pipeline