Gathr - University Event Management Platform

Gathr is a centralized event management platform designed to bring all university events under one roof. It helps students discover, register for, and stay updated on events, while providing clubs and societies with an easy-to-use admin dashboard for event management.

🚀 Live: Gathr on Netlify

🛠 Source Code: GitHub Repository

---

🌟 Why Gathr?

University events are often announced through scattered WhatsApp groups and social media platforms, leading to missed opportunities. Gathr solves this problem by offering:

• Centralized Event Discovery: All events available in one place.
• Seamless Registration: Register directly through the platform with individual or team options.
• Real-time Updates: Get live event announcements.
• Enhanced Visibility: Clubs reach a wider student audience.
• Future-Ready Features: QR-based check-ins and attendance tracking coming soon.

---

🎯 Project Goals

• Provide a streamlined and organized way for students to explore university events.
• Help clubs and societies maximize their outreach and engagement.
• Offer a secure and reliable platform for event registration and management.

---

🧑‍💻 Tech Stack

• Frontend: React, Tailwind CSS
• Backend: PocketBase
• State Management: Redux Toolkit
• Authentication: Google OAuth2, Bcrypt Password Hashing

---

🚀 Features

For Students

• 📅 Event Discovery: View events by category, department, or club.
• 📝 Easy Registration: Register individually or form teams using a university ID.
• 🔔 Live Announcements: Stay updated with event changes.

For Clubs and Organizers

• 🎙 Admin Dashboard: Manage event details with ease.
• 🖋 Rich Text Editor: Craft beautiful event posts using formatted text, bullet points, and checkboxes.
• 📣 Event Calendar: Visualize and manage events efficiently.

Security

• 🔒 Secure Authentication: User credentials are securely managed using PocketBase with bcrypt hashing.
• 🔑 Google OAuth2: Seamless and secure login experience.

Upcoming Features

• 🎟 QR Code Entry Pass: Simplify event check-ins.
• 📊 Attendance Tracking: Record event attendance using QR scans.
• 📈 Event Analytics: Get insights into engagement and participation.

---

📥 Contributing

Gathr is open-source and contributions are welcome! Whether you’re interested in fixing bugs, adding features, or improving the UI, feel free to submit a pull request.

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

---

🛠 Setup and Installation

1. Clone the repository:

   git clone https://github.com/Sharjeel-Afridi/gathr.git

2. Navigate to the project directory:

   cd gathr

3. Install dependencies:

   npm install

4. Start the development server:

   npm run dev

5. Access the app at http://localhost:5173

---

📧 Contact

If you have any questions, feedback, or feature requests, feel free to reach out or contribute to the project.

Happy coding! 🚀