Event Mint is a dynamic web application built for managing events in educational institutions such as schools, colleges, and universities. Inspired by platforms like BookMyShow, it simplifies event discovery, registration, payments, and management for organizers and attendees alike.
- Live Application: Event Mint
- Frontend: React.js, HTML5, CSS3, JavaScript
- Backend: Node.js, Express.js
- Database: MongoDB
- Payment Gateway: Stripe API
- π« Event Listings: View events categorized by type, date, and location.
- π User Registration: Secure and seamless registration for attendees.
- πͺ Seat Reservation: Real-time seat availability and reservations.
- π³ Payment Integration: Secure payment gateways (e.g., Stripe) for event registration.
- π₯ Attendee Management: Event organizers can track and manage attendee details.
- π± Responsive Design: Fully responsive design for all devices (mobile, tablet, desktop).
- π Event Discovery: Search and filter options for quick event discovery.
- π₯ Dynamic Content: Image sliders and event cards for enhanced UX.
We welcome contributions to improve EventMint! Whether you're adding features or fixing bugs, your contribution will make this project better. Follow the steps below to get started:
-
Fork the Repository:
-
Go to the repository on GitHub and click the "Fork" button.
- Dropdown menu-- "+ Create a new Fork"
- Dont change the suggested repo name and just click on "Create Fork" button.
- Congo! π you have successfully done the 1st step!
-
-
Now, from your forked repo, click on the "<> code" button and copy the url:
- the forked url looks like this--
https://github.com/<your username>/eventmint.git
- Open your IDE(Visual studio code or other), paste the above url in vs code terminal or git bash and navigate into the directory:
git clone https://github.com/<your username>/eventmint.git cd eventmint
- Add a Remote upstream to original repo for reference:
git remote add upstream https://github.com/samyakmaitre/eventmint.git
- Verify remote origin and upstream:
git remote -v
- the following response appear:
origin https://github.com/<your username>/eventmint.git (fetch)
origin https://github.com/<your username>/eventmint.git (push)
upstream https://github.com/samyakmaitre/eventmint.git (fetch)
upstream https://github.com/samyakmaitre/eventmint.git (push)
- Always make a pull from the upstream repository to your main branch to keep it updated with the original repository.
git pull upstream main
- Install the dependencies:
- Ensure you execute this cmd in the eventmint directory
npm install yarn start
- Create a new branch:
git checkout -b <feature-branch>
- Work on the issue:
- Perform the proposed changes in your new branch and ensure everything works.
- Track your changes:
git status git diff
- Stage and Commit your changes:
git add .
git commit -m "Add feature: <description>"
- Ensure you push the committed changes in your feature branch to your own remote repository
git push -u origin <feature-branch>
- Next, create a pull request, click on compare and pull requests
- Go to your forked repository on GitHub, click "Compare & pull request."
- Provide a descriptive title and summary for your PR.
- Click on "Create pull request" to submit your PR for review!
π Congratulationsπ, you have made a PR to the Eventmint. Wait for your submission to be accepted and your PR to be merged by a maintainer.
- Ensure that the code you write follows best practices and is well documented.
- Test your changes before submitting a pull request.
- Keep your branch updated with the main branch to avoid conflicts.
- Be clear and concise in your pull request titles and descriptions.
Feel free to reach out with questions or suggestions!
- π¨βπ»Project Maintainer: Samyak Maitre
- π©Email: samyakmaitre@gmail.com
- πNeed Project Ideas?: Go through SamyakBlogs
Give this project a β if you find it engaging! Feel Free to reach out. Happy Coding!ππ