Event management for National University – Mall of Asia (NU MOA).
Every college, the Student Council and offices such as Career Services run their events here.

---

✨ Features

🎟️ For attendees Browse events by category or on the calendar Register and pick a seat on the seat map QR ticket for check-in and exit Certificates and feedback after the event	🗂️ For event managers Submit events for admin approval Venue booking with clash and capacity checks Session timeline, speakers and announcements Registrations, attendance and reports
🛡️ For admins Approve, reject or archive events Manage users, venues and platform settings Audit log of every change CSV reports across all events	📷 For door staff Scan tickets to check attendees in Rotating exit QR to verify who stayed Duplicate and too-early scans are refused

📸 The flow, step by step

1 · Home What's coming up on campus	2 · Explore events Filter by category, venue and status
3 · Manager submits an event Venue, time and capacity are checked for clashes	4 · Admin approves it Approving opens registration right away
5 · Student registers Pick a seat on the seat map	6 · QR ticket pass Shown at the door to check in
7 · Staff check-in desk Fake, cancelled and used tickets are refused	8 · Certificate Issued after the exit scan, with hours earned
9 · Reports Registrations, attendance and feedback per event

🔄 How an event flows

flowchart TD
    A([Manager creates event]) --> B{Admin review}
    B -- Rejected --> A
    B -- Approved --> C[Registration opens]
    C --> D[Attendee registers<br/>and picks a seat]
    D --> E[Staff scans QR ticket<br/>at check-in]
    E --> F[Exit QR verified]
    F --> G([Certificate + feedback])

Loading

🧰 Tech stack

Frontend

	Technology	Purpose
	React 19	UI library
	React Router 7	Client-side routing
	Create React App	Dev server, production build and tests
	Lucide React	Icons
	qrcode + jsQR	Ticket QR codes and in-browser scanning
	html-to-image	Downloadable tickets and certificates
	DiceBear	Generated profile avatars
	Vercel + Vercel Analytics	Hosting and page analytics

Backend

	Technology	Purpose
	Node.js	Runtime environment
	Express 5	REST API framework
	MongoDB + Mongoose 8	Database & ODM
	JSON Web Tokens	Authentication & role-based access
	bcryptjs	Password hashing
	Nodemailer	Password-reset emails

Tooling & testing

	Technology	Purpose
	Nodemon	Auto-restart dev server
	ESLint	Linting (react-app config)
	Jest + node:test	App and server tests

Note

A React app (this folder) talks to an Express + MongoDB server (server/). See SYSTEM_FLOW.md for how the parts work together.

🚀 Getting started

1. Clone and install

git clone https://github.com/Bibimbap101/eventify.git
cd eventify
npm install
npm --prefix server install

2. Set up the server

You need MongoDB, either installed locally or a free MongoDB Atlas database.

Create server/.env with at least these two lines:

MONGODB_URI=mongodb://127.0.0.1:27017/eventify
JWT_SECRET=any-long-random-text

Optional: PORT (default 5000), CLIENT_URL (default https://eventifys.vercel.app; set it to http://localhost:3000 locally), JWT_EXPIRES_IN (default 7d), and SMTP_HOST, SMTP_PORT, SMTP_USER, SMTP_PASS, MAIL_FROM for password-reset and announcement emails (without them the email prints in the server console). On hosts that block SMTP ports, such as Render's free plan, set BREVO_API_KEY and MAIL_FROM instead, and emails go through Brevo's HTTP API. MAIL_FROM must be a sender verified in Brevo.

3. Load demo data (optional)

Add SEED_ADMIN_EMAIL, SEED_ADMIN_PASSWORD and SEED_PASSWORD_SUFFIX to server/.env, then:

npm --prefix server run seed

[!WARNING] Seeding wipes every event, registration and non-admin account in that database first.

4. Run it

Start the server and the app in two terminals:

npm run server

npm start

The app runs at http://localhost:3000.

5. Run the tests

npm test

npm --prefix server test

[!TIP] The server's data-rule tests need a local MongoDB (or MONGODB_TEST_URI). They use a throwaway eventify_rules_test database and are skipped when no MongoDB is running.