An open API service indexing awesome lists of open source software.

https://github.com/subbareddy2004/hackon

A full-stack event management application built with modern web technologies
https://github.com/subbareddy2004/hackon

event-management fullstack hackathon-management material-ui mongodb nodejs react

Last synced: 3 months ago
JSON representation

A full-stack event management application built with modern web technologies

Awesome Lists containing this project

README

          

# Event Management Software

A full-stack event management application built with modern web technologies. This project consists of a React-based frontend and a Node.js backend, providing a complete solution for managing events, registrations, and attendees.

🌐 **Live Demo:** [https://hackon1.vercel.app/](https://hackon1.vercel.app/)

## 📸 Screenshots & Demo

Here's a visual overview of the Event Management Software:

### Landing Page

![Landing Page](Demo/Screenshot%202025-03-03%20181458.png)

### Event Creation

![Event Creation](Demo/Screenshot%202025-03-03%20181521.png)

### Event Listing

![Event Listing](Demo/Screenshot%202025-03-03%20181541.png)

### Event Details

![Event Details](Demo/Screenshot%202025-03-03%20181556.png)

### Registration Process

![Registration](Demo/Screenshot%202025-03-03%20181614.png)

### User Dashboard

![Dashboard](Demo/Screenshot%202025-03-03%20181629.png)

### Admin Panel

![Admin Panel](Demo/Screenshot%202025-03-03%20181701.png)

## 🚀 Features

- User authentication and authorization
- Event creation and management
- Event registration and ticket management
- Attendee management
- Real-time updates
- Responsive design for all devices

## 🛠️ Tech Stack

### Frontend

- React.js
- Material-UI
- Redux for state management
- Axios for API calls
- React Router for navigation

### Backend

- Node.js
- Express.js
- MongoDB
- JWT for authentication
- RESTful API architecture

## 📦 Installation

### Prerequisites

- Node.js (v14 or higher)
- MongoDB
- npm or yarn

### Setting up the Backend

1. Navigate to the Backend directory:

```bash
cd Backend
```

2. Install dependencies:

```bash
npm install
```

3. Create a `.env` file and add your environment variables:

```
PORT=5000
MONGODB_URI=your_mongodb_uri
JWT_SECRET=your_jwt_secret
```

4. Start the server:
```bash
npm start
```

### Setting up the Frontend

1. Navigate to the Frontend directory:

```bash
cd Frontend
```

2. Install dependencies:

```bash
npm install
```

3. Start the development server:
```bash
npm start
```

The application will be available at `http://localhost:3000`

## 🔧 Configuration

### Backend Configuration

- Port: 5000 (default)
- Database: MongoDB
- Authentication: JWT

### Frontend Configuration

- Port: 3000 (default)
- API Base URL: http://localhost:5000/api

## 🤝 Contributing

Contributions are welcome! Please feel free to submit a Pull Request. For major changes, please open an issue first to discuss what you would like to change.

1. Fork the Project
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](LICENSE) file for details.

## 👥 Authors

- Subbareddy - Initial work

## 🙏 Acknowledgments

- Thanks to all contributors who have helped this project grow
- Special thanks to the open-source community

## 📞 Contact

If you have any questions, feel free to reach out or open an issue.

---

⭐️ If you found this project helpful, please give it a star on GitHub!