Meethub

Abstract

1. Introduction

MeetHub is an open-source event management system built with Python and the Django Web Framework. It's designed to help people create, discover, and manage events, fostering community and connection. Whether you're organizing a tech meetup, a book club, or a hiking trip, MeetHub provides the tools to bring people together. As a learning platform, it offers a practical, real-world codebase for developers looking to gain experience with Django, containerization, and modern web development practices.

2. Objective

This is a Python/Django based event management system.

This project demonstrates how JavaScript, Django can be applied to a real-world Full Stack Web Development problem.

3. Key Features / Modules

• Event Creation & Management: Easily create, update, and manage your own events.
• Event Discovery: Explore a list of upcoming events to join.
• User Profiles: Create a personal profile and see who's attending events.
• Event Discussions: Comment on events to ask questions and connect with attendees.
• Real-time Notifications: Get notified about relevant activities.
• Responsive Design: A clean, modern UI that works on any device.

4. Technology Stack

• Backend: Python, Django
• Database: PostgreSQL (production), SQLite3 (development)
• Frontend: HTML, CSS, Bootstrap 5, JavaScript
• Deployment: Docker, Gunicorn, Whitenoise
• Package Management: uv
• Cloud Services: Cloudinary (for media), NeonDB (for database), Render (for hosting)

5. System Requirements

General requirements for this technology stack — check the README for exact versions.

• Node.js (LTS) and npm
• A modern web browser
• VS Code or any code editor
• Git (to clone the repository)

6. Installation & Setup

git clone https://github.com/iyanuashiri/meethub.git
cd meethub

1. Clone the repository git clone https://github.com/iyanuashiri/meethub.git
2. Sync the dependencies uv sync
3. Run migrations uv run python manage.py migrate
4. Run the server uv run python manage.py runserver
5. Create a superuser (for admin access): uv run python manage.py createsuperuser
6. Clone the repository git clone https://github.com/iyanuashiri/meethub.git
7. Create a virtual environment python -m venv venv
8. Activate the virtual environment venv\Scripts\activate on windows or source venv/bin/activate on linux

Full setup instructions are in the project README.

7. Future Enhancements

Suggested extensions you can add to make this your own project.

• Add role-based access control
• Deploy on a VPS or cPanel hosting with a custom domain
• Add automated tests and a CI pipeline

8. Viva / Review Questions

Common questions examiners ask for projects in this domain.

1. Explain the frontend, backend and database layers of this application.
2. How is user authentication and authorisation implemented?
3. Describe the main database tables / collections and their relationships.
4. Which REST APIs or routes are exposed and what do they return?
5. How would you deploy this application to production?

9. Source Code & License

This project is developed by iyanuashiri and published on GitHub under the MIT License. Please follow the license terms and credit the original author when you use or modify this code.