• React 18 — Component-based UI with hooks
• Vite 5 — Lightning-fast HMR and build
• React Router v6 — Client-side routing
• Axios — HTTP client with interceptors
• SockJS + STOMP — WebSocket real-time communication
• React Toastify — Toast notifications
• TailwindCSS — Utility-first CSS framework
• Custom CSS — Glassmorphism, gradients, micro-animations

• Spring Boot 3 — RESTful API framework
• Spring Security + JWT — Authentication & authorization
• MongoDB — NoSQL document database
• WebSocket (STOMP) — Real-time event broadcasting
• Lombok — Boilerplate reduction

EventProject/
├── event-frontend/             # React + Vite frontend
│   ├── src/
│   │   ├── components/         # Reusable components (Navbar, etc.)
│   │   ├── context/            # Auth context provider
│   │   ├── pages/              # Route pages (Dashboard, Profile, Quiz…)
│   │   ├── services/           # API service layer
│   │   └── styles/             # Custom CSS modules
│   ├── index.html
│   └── vite.config.js
│
├── src/main/java/com/company/event/   # Spring Boot Backend
│   ├── user/                   # User entity, controller, service
│   ├── quiz/                   # MCQ quiz engine
│   ├── contestPackage/         # Coding contest system
│   ├── organization/           # Organization management
│   ├── security/               # JWT auth, filters, config
│   └── websocket/              # Real-time WebSocket service
│
├── pom.xml                     # Maven dependencies
└── README.md

Ensure you have the following installed:

git clone https://github.com/krishna3163/EventProject.git
cd EventProject

# Set environment variables (or add to application.properties)
# SPRING_DATA_MONGODB_URI=mongodb://localhost:27017/eventdb
# JWT_SECRET=your-secret-key

# Build & run the Spring Boot server
mvn clean install -DskipTests
mvn spring-boot:run

The backend will start on http://localhost:8080.

cd event-frontend

# Install dependencies
npm install

# Create .env file (optional — defaults to localhost:8080)
echo "VITE_API_BASE_URL=http://localhost:8080" > .env

# Start the dev server
npm run dev

The frontend will start on http://localhost:5173.

⚠️ Change the default admin password in production!

Users can edit the following fields from their profile page:

1. Log in to your account
2. Click on your avatar or navigate to /profile
3. Click the ✏️ Edit Profile button
4. Modify any editable field
5. Click Save Changes — updates are sent to the backend via PATCH /api/users/me/profile

We welcome contributions! Here's how to get started:

1. Fork the repository
2. Create a feature branch: git checkout -b feature/amazing-feature
3. Commit your changes: git commit -m 'Add amazing feature'
4. Push to the branch: git push origin feature/amazing-feature
5. Open a Pull Request

• Frontend hot-reload is enabled via Vite — just save your files
• Backend changes require a restart (or use Spring DevTools for auto-reload)
• The API service layer (src/services/api.js) centralizes all API calls — add new endpoints there
• CSS styles follow a glassmorphism design system — check styles/LandingPage.css for patterns

The frontend is Vercel-ready:

cd event-frontend
npm run build
# Deploy the 'dist' folder to Vercel

Deploy the Spring Boot JAR to any cloud provider:

mvn clean package -DskipTests
java -jar target/event-0.0.1-SNAPSHOT.jar

Set these environment variables in production:

• SPRING_DATA_MONGODB_URI — MongoDB connection string
• JWT_SECRET — Secret key for JWT tokens
• SPRING_PROFILES_ACTIVE=prod

This project is licensed under the MIT License — see the LICENSE file for details.