UniHive

Connect, Collaborate, and Earn Within Your Campus Community

🎯 Overview

UniHive is a specialized marketplace platform exclusively for Ghanaian university students. Born during the Hachive Hackathon 1.0 by WeWire, it enables students to:

• Buy and sell essential items (books, electronics, etc.)
• Find and offer academic help
• Request and provide logistics services
• Share campus events and activities
• Access academic resources
• Find side hustle opportunities

📸 Screenshots

Overview

platform overview

Authentication

Student registration with university email verification

Secure login with university credentials

Core Features

Student dashboard showing recent activities and stats

Different hive categories for various student needs

Marketplace Features

Buy and sell university essentials

Find and offer student services

Communication

Real-time messaging between students

Detailed student profiles with verification status

✨ Features

🔐 User Management

• University email verification system
• OTP-based email verification
• JWT authentication
• Profile customization

🎓 Hive Categories

1. Essentials Hive

   • Buy/sell university essentials
   • Item condition tracking
   • Price comparisons

2. Academia Hive

   • Tutoring services
   • Study groups
   • Assignment help

3. Logistics Hive

   • Campus delivery services
   • Errand running
   • Package pickups

4. Buzz Hive

   • Campus events
   • Activities
   • Announcements

5. Archive Hive

   • Study materials
   • Past questions
   • Course resources

6. SideHustle Hive

   • Part-time jobs
   • Freelance opportunities
   • Campus gigs

💬 Communication

• Real-time messaging
• Notifications system
• File sharing

💰 Payments

• Integration with local payment methods
• Transaction tracking
• Secure payment processing

🛠️ Tech Stack

Frontend	Backend	Database & Storage	DevOps
• React.js • Typescript • Tailwind CSS • Framer Motion • Formik & Yup	• Node.js • Express.js • TypeScript • Nodemailer • JWT Authentication	• PostgreSQL • Sequelize ORM • Cloudinary (media)	• Git/GitHub • Postman • Vercel (client) • Render (server) • ESLint/Prettier

🚀 Getting Started

Prerequisites

• Node.js (v16+)
• npm or yarn
• PostgreSQL database

Installation

1. Clone the repository

git clone https://github.com/AWESOME04/UniHive.git
cd UniHive

2. Install server dependencies

cd server
npm install

3. Install client dependencies

cd client
npm install

4. Set up environment variables

# In server directory
cp .env.example .env
# Edit .env with your database credentials

5. Start development servers

# Start server (from server directory)
npm run dev

# Start client (from client directory)
npm run dev

📚 Documentation

• API Documentation

👥 Team

Evans Acheampong Fullstack Developer

Andrews Mintah Frontend Developer

🤝 Contributing

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

📄 License

This project is licensed under the MIT License - see the LICENSE file for details.

🙏 Acknowledgments

• The WeWire team for organizing Hachive Hackathon 1.0
• All participating universities for their support
• Our mentors and advisors

---

Made with ❤️ for Ghanaian University Students