Skip to content

cyfan2024/BeeTogether

Repository files navigation

🐝 BeeTogether

BeeTogether is your passport to a buzzing campus life!

Discover, join, and never miss another event with our unified, school-wide events calendar. It is built to prevent scheduling clashes and bring every CCA or campus happening under one vibrant roof. With a stunning map-based interface and personalized event recommendations, BeeTogether ensures you’ll always know what’s on, where it’s happening, and how to get involved. No more hunting through scattered platforms: everything you need for campus connection, fun, and well-being is right at your fingertips.

🌟 Features

  • Interactive Campus Map:
    View all event locations, CCAs, and your own position on a beautiful map of your school. Clickable and dynamic markers make navigation effortless.

  • Buzzing Events Calendar:
    Browse upcoming events, filter by interests and perks, bookmark favorites, and register with ease.

  • Personalized Dashboard & Profile:
    Track your registrations, bookmarks, CCAs, and achievements with a clean and engaging UI.

  • Real-Time Announcements:
    Stay up to date with club and campus-wide news in one centralized feed.

  • Beautiful, Friendly UI:
    Pastel themes, emoji-powered icons, and responsive designs for students on-the-go.

🏗️ Tech Stack

  • Frontend: React (TypeScript), Tailwind CSS
  • Icons & UI: Lucide Icons
  • State Management: React Hooks & Context
  • Styling: Tailwind CSS with custom gradients
  • Visualization: SVG and CSS overlays for interactive maps
  • Build Tool: Vite

🚀 Getting Started

Prerequisites

  • Node.js (v18 or newer)
  • npm or yarn

Installation

git clone https://github.com/yourusername/BeeTogether.git
cd BeeTogether
npm install

Run the Development Server

npm run dev

Open your browser at http://localhost:5173 to see the app in action.

🗺️ Customizing the Campus Map

Replace the background map image to personalize your campus view:

  1. Add your image (e.g., public/smu-campus.jpg)
  2. Modify the image source in CampusMap.tsx:

🙌 Contributing

Contributions are welcome! Please open issues for bug reports or feature requests. Pull requests for improvements or enhancements are highly appreciated.

📄 License

This project is licensed under the MIT License.

✨ Acknowledgements

  • Bee iconography inspired by openemoji & Lucide

BeeTogether – fostering community, connection, and well-being at your fingertips.

About

No description, website, or topics provided.

Resources

Stars

Watchers

Forks

Releases

No releases published

Packages

 
 
 

Contributors

Languages