A Modern Event Management Platform for Builders and Communities

Eventra is a comprehensive event management system that empowers organizers to create, manage, and track events seamlessly. Built with a modern tech stack featuring React frontend and Spring Boot backend, Eventra provides everything needed to run successful events from creation to post-event analytics.

• Frontend: https://eventra-psi.vercel.app/
• Backend API: https://eventra-backend-dgcae3etebbag8ft.centralindia-01.azurewebsites.net
• API Documentation: Backend Swagger UI

🌟 Stars	🍴 Forks	🐛 Issues	🔔 Open PRs	🔕 Closed PRs	🛠️ Languages	👥 Contributors

• Features
• Tech Stack
• Architecture
• Quick Start
• Installation
• Environment Configuration
• Deployment
• API Documentation
• Frontend Components
• Troubleshooting
• Contributing
• License

• Event Creation & Management - Create and customize events with rich details
• User Authentication & Authorization - Secure JWT-based authentication system
• RSVP Management - Handle attendee registrations and responses
• QR Code Check-ins - Streamlined event check-in process
• Real-time Analytics - Track event performance and attendee engagement
• Admin Dashboard - Comprehensive administrative controls
• User Dashboard - Personalized user experience and event tracking

• Hackathon Hub - Specialized features for hackathon management
• Project Gallery - Showcase community projects and collaborations
• Collaboration Tools - Foster community engagement and networking
• Feedback System - Post-event surveys and feedback collection
• Leaderboards - Gamification and community recognition
• Responsive Design - Mobile-first, responsive user interface

• Framework: Spring Boot 3.3.1
• Language: Java 17
• Database: MySQL (Aiven) with H2 for development
• Security: Spring Security with JWT authentication
• Build Tool: Maven
• Documentation: OpenAPI 3.0 with Springdoc
• Key Dependencies:
  • Spring Data JPA
  • Spring Web
  • Spring Security
  • JJWT for JWT tokens
  • H2 Database (development)
  • MySQL Connector
  • Lombok
  • Spring Boot DevTools

• Framework: React 18.2.0
• Routing: React Router DOM 6.8.0
• Animations: Framer Motion 8.5.2
• Icons: Heroicons React 2.0.16
• Observers: React Intersection Observer 9.4.1
• Styling: CSS with modern responsive design
• Build Tool: Create React App

• Environment Profiles: Development, Production, Azure
• API Documentation: OpenAPI/Swagger specification
• Version Control: Git with comprehensive documentation

Eventra/
├── .github/                   # GitHub workflows and templates
├── .vscode/                   # VS Code settings
├── backend/                   # Spring Boot API Server
│   ├── src/main/java/com/eventra/
│   │   ├── config/            # Configuration classes
│   │   │   ├── CorsConfig.java           # CORS configuration
│   │   │   └── OpenApiConfig.java        # Swagger/OpenAPI setup
│   │   ├── controller/        # REST API controllers
│   │   │   ├── AdminController.java      # Admin management
│   │   │   ├── AuthController.java       # Authentication endpoints
│   │   │   ├── EventController.java      # Event management
│   │   │   ├── HealthController.java     # Health check endpoint
│   │   │   ├── HomeController.java       # Home page endpoint
│   │   │   └── UserController.java       # User management
│   │   ├── dto/               # Data Transfer Objects
│   │   ├── entity/            # JPA entities
│   │   │   ├── User.java                 # User entity
│   │   │   ├── Event.java                # Event entity
│   │   │   └── Project.java              # Project entity
│   │   ├── exception/         # Custom exceptions
│   │   ├── filter/            # Security filters
│   │   ├── repository/        # Data access layer (JPA repositories)
│   │   ├── service/           # Business logic services
│   │   ├── util/              # Utility classes (JWT, validation)
│   │   ├── BackendApplication.java       # Main Spring Boot application
│   │   ├── SecurityConfig.java          # Security configuration
│   │   └── StatusController.java        # Status endpoint
│   ├── src/main/resources/    # Configuration files
│   │   ├── application.properties        # Main configuration
│   │   ├── application-dev.properties    # Development settings
│   │   ├── application-mysql.properties  # MySQL configuration
│   │   ├── application-prod.properties   # Production settings
│   │   └── application-azure.properties  # Azure deployment config
│   ├── src/test/java/         # Test files
│   ├── target/                # Build output
│   ├── azure-cors-variables.json        # Azure CORS environment variables
│   ├── azure-environment-variables.json # Azure deployment variables
│   ├── CLEANUP_SUMMARY.md               # Database cleanup documentation
│   ├── DATABASE_MIGRATION.md            # Database migration guide
│   ├── DEPLOYMENT_GUIDE.md              # Backend deployment guide
│   ├── update-azure-cors.sh             # Azure CORS update script
│   ├── mvnw / mvnw.cmd                   # Maven wrapper
│   └── pom.xml                          # Maven configuration
├── frontend/                  # React Web Application
│   ├── public/                # Static assets
│   │   ├── favicon.ico
│   │   ├── index.html
│   │   └── manifest.json
│   ├── src/
│   │   ├── components/        # React components
│   │   │   ├── admin/         # Admin dashboard components
│   │   │   │   ├── AdminDashboard.js
│   │   │   │   └── AdminDashboard.css
│   │   │   ├── auth/          # Authentication components
│   │   │   │   ├── Auth.css
│   │   │   │   ├── Login.js
│   │   │   │   ├── PasswordReset.js
│   │   │   │   ├── ProtectedRoute.js
│   │   │   │   ├── Signup.js
│   │   │   │   └── Unauthorized.js
│   │   │   ├── common/        # Shared components
│   │   │   │   ├── common-components.css
│   │   │   │   ├── ErrorMessage.js
│   │   │   │   ├── EventCreation.js
│   │   │   │   ├── EventCreation.css
│   │   │   │   └── Loading.js
│   │   │   ├── Layout/        # Layout components
│   │   │   │   ├── Footer.js
│   │   │   │   └── Navbar.js
│   │   │   ├── styles/        # Component-specific styles
│   │   │   │   ├── components.css
│   │   │   │   ├── Contributors.css
│   │   │   │   ├── notFound.css
│   │   │   │   └── scrolltotopButton.css
│   │   │   ├── user/          # User-specific components
│   │   │   ├── CollaborationHub.js       # Collaboration features
│   │   │   ├── Contributors.js           # Contributors display
│   │   │   ├── Dashboard.js              # Main dashboard
│   │   │   ├── GitHubStats.jsx           # GitHub statistics
│   │   │   ├── Leaderboard.js            # User leaderboard
│   │   │   ├── NotFound.js               # 404 page
│   │   │   ├── ScrollToTop.js            # Scroll to top button
│   │   │   └── SearchFilter.js           # Search and filter
│   │   ├── config/            # Configuration files
│   │   │   └── api.js                    # API endpoints and utilities
│   │   ├── context/           # React context providers
│   │   │   └── AuthContext.js            # Authentication context
│   │   ├── Pages/             # Page components
│   │   │   ├── About/                    # About page
│   │   │   ├── Events/                   # Events pages
│   │   │   ├── Hackathons/               # Hackathons section
│   │   │   ├── Home/                     # Home page
│   │   │   └── Projects/                 # Projects section
│   │   ├── App.js             # Main App component
│   │   ├── App.css            # Global app styles
│   │   ├── index.js           # React entry point
│   │   └── index.css          # Global CSS styles
│   ├── .env.example           # Environment variables template
│   ├── .env.production        # Production environment config
│   ├── CSS-CONSOLIDATION-SUMMARY.md     # CSS consolidation notes
│   ├── package.json           # npm dependencies
│   └── README.md              # Frontend documentation
├── docs/                      # Project documentation
│   ├── admin.md               # Admin functionality docs
│   ├── authentication.md     # Authentication documentation
│   ├── CHANGELOG.md           # Version history
│   ├── checkin.md             # Check-in process docs
│   ├── dashboards.md          # Dashboard documentation
│   ├── errors.md              # Error handling docs
│   ├── events.md              # Events API documentation
│   ├── feedback.md            # Feedback system docs
│   ├── frontend-integration.md # Frontend integration guide
│   ├── index.md               # Documentation index
│   ├── openapi.yaml           # OpenAPI specification
│   ├── README.md              # Documentation README
│   └── rsvp-attendees.md      # RSVP and attendee management
├── .gitignore                 # Git ignore rules
├── CODE_OF_CONDUCT.md         # Code of conduct
├── CONTRIBUTING.md            # Contributing guidelines
├── DEPLOYMENT_TROUBLESHOOTING.md # Deployment troubleshooting guide
├── LICENSE                    # Apache 2.0 license
├── package.json               # Root package configuration
├── package-lock.json          # npm lock file
├── README.md                  # Main project documentation
└── vercel.json                # Vercel deployment configuration

• Java 17 or higher
• Node.js 16 or higher
• npm or yarn
• Git
• MySQL (for production) or use built-in H2 database for development

git clone https://github.com/SandeepVashishtha/Eventra.git
cd Eventra

# Navigate to backend directory
cd backend

# Install dependencies and run (Windows)
.\mvnw.cmd spring-boot:run

# Install dependencies and run (Linux/Mac)
./mvnw spring-boot:run

# Or build and run the JAR
.\mvnw.cmd clean package
java -jar target/backend-0.0.1-SNAPSHOT.jar

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

• H2 in-memory database for development
• H2 Console available at http://localhost:8080/h2-console
• Swagger UI available at http://localhost:8080/swagger-ui.html
• API endpoints available at http://localhost:8080/api

# Navigate to frontend directory
cd frontend

# Install dependencies
npm install

# Start development server
npm start

The frontend will start on http://localhost:3000 and automatically connect to the backend API.

• Frontend: http://localhost:3000
• Backend API: http://localhost:8080
• API Documentation: http://localhost:8080/swagger-ui.html
• H2 Database Console: http://localhost:8080/h2-console (JDBC URL: jdbc:h2:mem:eventra)

For production deployment, configure these environment variables:

# Database Configuration (Aiven MySQL)
AIVEN_DATABASE_URL=jdbc:mysql://your-host:port/database?useSSL=true
AIVEN_DATABASE_USERNAME=your_username
AIVEN_DATABASE_PASSWORD=your_password
DATABASE_DRIVER=com.mysql.cj.jdbc.Driver
DATABASE_DIALECT=org.hibernate.dialect.MySQL8Dialect
DDL_AUTO=update

# Security Configuration
JWT_SECRET=your_secure_jwt_secret_key_here
JWT_EXPIRATION=86400000

# CORS Configuration
CORS_ALLOWED_ORIGINS=https://eventra-psi.vercel.app
CORS_ALLOWED_METHODS=GET,POST,PUT,DELETE,OPTIONS,PATCH
CORS_ALLOWED_HEADERS=*
CORS_ALLOW_CREDENTIALS=true

# Application Settings
SHOW_SQL=false
LOG_LEVEL=INFO

Create .env.production in the frontend directory:

# Production API Configuration
REACT_APP_API_URL=https://eventra-backend-dgcae3etebbag8ft.centralindia-01.azurewebsites.net/api
REACT_APP_APP_NAME=Eventra
REACT_APP_VERSION=1.0.0
GENERATE_SOURCEMAP=false

1. Build the application:

   cd backend
   ./mvnw clean package -DskipTests

2. Deploy to Azure:

   • Upload the JAR file from target/ directory
   • Configure environment variables in Azure App Service
   • Set the startup command: java -jar /home/site/wwwroot/backend-0.0.1-SNAPSHOT.jar

3. Environment Variables in Azure: Use the JSON format from backend/azure-cors-variables.json to configure CORS settings.

1. Connect to Vercel:

   • Import your GitHub repository to Vercel
   • Set build command: npm run build
   • Set output directory: build

2. Environment Variables in Vercel:

   REACT_APP_API_URL = https://eventra-backend-dgcae3etebbag8ft.centralindia-01.azurewebsites.net/api
   

The backend provides a comprehensive REST API documented with OpenAPI 3.0:

• Live API Documentation: Swagger UI
• OpenAPI Specification: API Docs

• POST /api/auth/login - User login
• POST /api/auth/signup - User registration
• POST /api/auth/logout - User logout
• GET /api/auth/verify - Token verification

• GET /api/events - List all events
• POST /api/events - Create new event
• GET /api/events/{id} - Get event details
• PUT /api/events/{id} - Update event
• DELETE /api/events/{id} - Delete event
• POST /api/events/{id}/join - Join event
• DELETE /api/events/{id}/leave - Leave event

• GET /api/user/profile - Get user profile
• PUT /api/user/update - Update user profile
• GET /api/user/events - Get user's events

• GET /api/admin/dashboard - Admin dashboard data
• GET /api/admin/users - Manage users
• GET /api/admin/events - Manage events

Problem: "Network error. Please check your connection and try again."

Solution:

1. Verify backend is running: Visit backend health endpoint
2. Check CORS configuration in Azure App Service
3. Verify REACT_APP_API_URL environment variable in Vercel

Problem: Browser console shows CORS errors

Solution:

1. Add these environment variables to Azure App Service:

   CORS_ALLOWED_ORIGINS = *
   CORS_ALLOWED_METHODS = GET,POST,PUT,DELETE,OPTIONS,PATCH
   CORS_ALLOWED_HEADERS = *
   CORS_ALLOW_CREDENTIALS = true
   

2. Restart the Azure App Service
3. Clear browser cache

Problem: Backend fails to start or connect to database

Solution:

1. Verify database environment variables in Azure
2. Check database connectivity and credentials
3. Ensure database server allows connections from Azure IP ranges

Problem: Vercel build fails with schema validation errors

Solution:

1. Check vercel.json configuration
2. Ensure all required environment variables are set
3. Verify package.json dependencies

1. Local Development: Use H2 database for quick setup
2. API Testing: Use the built-in Swagger UI for testing endpoints
3. Debugging: Enable SQL logging with SHOW_SQL=true
4. Frontend Development: Start backend first, then frontend

1. Check the Deployment Troubleshooting Guide
2. Review browser console for specific error messages
3. Check Azure App Service logs for backend errors
4. Verify environment variables in both Vercel and Azure

We welcome contributions to Eventra! Please follow these steps:

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

• Follow Java coding conventions for backend development
• Use React best practices for frontend development
• Write meaningful commit messages
• Update documentation for any new features
• Test thoroughly before submitting PRs

• Backend: Follow Spring Boot conventions and package structure
• Frontend: Use functional components with hooks
• API: Maintain RESTful design principles
• Documentation: Update OpenAPI specifications for new endpoints

This project is licensed under the Apache License 2.0 - see the LICENSE file for details.

• Spring Boot community for excellent framework and documentation
• React community for powerful frontend library
• Azure and Vercel for reliable cloud hosting
• Aiven for managed MySQL database service

Built with ❤️ by the Eventra Team

For more information, visit our live application or check out the API documentation.

3. Frontend Configuration The frontend automatically connects to http://localhost:8080/api. To change the API URL:

   # Set environment variable
   export REACT_APP_API_URL=http://your-api-url:port/api
   # Or edit src/config/api.js

Development (H2 - Default)

• No setup required - uses in-memory H2 database
• Access console at http://localhost:8080/h2-console
• JDBC URL: jdbc:h2:mem:eventra
• Username: sa
• Password: (empty)

Production (MySQL)

# application.properties
spring.datasource.url=jdbc:mysql://your-mysql-host:port/database_name
spring.datasource.username=your_username
spring.datasource.password=your_password
spring.datasource.driver-class-name=com.mysql.cj.jdbc.Driver
spring.jpa.properties.hibernate.dialect=org.hibernate.dialect.MySQL8Dialect

1. Backend Build

   cd backend
   .\mvnw.cmd clean package -Pprod

2. Frontend Build

   cd frontend
   npm run build

Comprehensive API documentation is available through multiple channels:

• Swagger UI: http://localhost:8080/swagger-ui.html
• OpenAPI JSON: http://localhost:8080/api-docs

• API Overview - Complete API guide
• Authentication - User auth and JWT
• Events - Event management endpoints
• RSVP & Attendees - Registration management
• Check-in - QR code and check-in system
• Dashboards - Analytics and reporting
• Feedback - Survey and feedback system
• Admin - Administrative operations
• OpenAPI Spec - Machine-readable API spec

• Development: http://localhost:8080/api
• Production: https://api.eventra.com/api

• Hero - Landing page hero section
• Navbar - Navigation and user menu with authentication state
• Dashboard - User dashboard with event overview and management
• AdminDashboard - Administrative control panel for user and event management
• EventCreation - Event creation and editing forms with validation

• EventsSection - Event listing with search and filtering capabilities
• HackathonHub - Specialized features for hackathon management
• ProjectGallery - Community project showcase and collaboration
• CollaborationHub - Team collaboration tools and communication
• Leaderboard - Community rankings and recognition system

• Login/Signup - User authentication forms with validation
• ProtectedRoute - Route protection middleware for authenticated routes
• AuthContext - Authentication state management and token handling
• Unauthorized - Access denied component for restricted routes

• Loading - Loading spinner for async operations
• ErrorMessage - Error display component
• SearchFilter - Reusable search and filter component

spring.datasource.url=jdbc:h2:mem:eventra
spring.datasource.driverClassName=org.h2.Driver
spring.datasource.username=sa
spring.datasource.password=
spring.h2.console.enabled=true
spring.jpa.show-sql=true

spring.datasource.url=jdbc:mysql://your-aiven-host:port/database_name?useSSL=true&requireSSL=true&verifyServerCertificate=false
spring.datasource.username=your_aiven_username
spring.datasource.password=your_aiven_password
spring.datasource.driver-class-name=com.mysql.cj.jdbc.Driver
spring.jpa.properties.hibernate.dialect=org.hibernate.dialect.MySQL8Dialect

# JWT Configuration
jwt.secret=your-secure-jwt-secret-key
jwt.expiration=86400000

# CORS Configuration
cors.allowed-origins=http://localhost:3000
cors.allowed-methods=GET,POST,PUT,DELETE,OPTIONS,PATCH
cors.allowed-headers=Origin,Content-Type,Accept,Authorization,Cache-Control,X-Requested-With
cors.allow-credentials=true

// src/config/api.js
const API_BASE_URL = process.env.REACT_APP_API_URL || 'http://localhost:8080/api';

// Environment variable usage:
// REACT_APP_API_URL=http://your-api-url:port/api npm start

• REACT_APP_API_URL: Backend API base URL
• REACT_APP_DEBUG: Enable debug mode

We welcome contributions! Please see our Contributing Guidelines for details.

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

• Backend: Follow Java conventions and Spring Boot best practices
• Frontend: Use ESLint and Prettier for consistent code style
• Testing: Write comprehensive tests for new features
• Documentation: Update API documentation for any changes
• Commit Messages: Use conventional commit messages

1. Set up the development environment as described in the Quick Start section
2. Explore the codebase structure
3. Check existing issues or propose new features
4. Follow the coding standards and testing requirements

This project is licensed under the Apache License 2.0 - see the LICENSE file for details.

• Repository: https://github.com/SandeepVashishtha/Eventra
• Issues: https://github.com/SandeepVashishtha/Eventra/issues
• Discussions: https://github.com/SandeepVashishtha/Eventra/discussions

We love our contributors! If you'd like to help, please check out our CONTRIBUTE.md file for guidelines.

Thank you once again to all our contributors who has contributed to AlgoVisualizer! Your efforts are truly appreciated. 💖👏

See the full list of contributors and their contributions on the GitHub Contributors Graph.

Contributor updates automatically every 24 hours

We'd love your help! Check out our Contributing Guidelines to get started.

• Sandeep Vashishtha - @SandeepVashishtha

Built with ❤️ for the community. Happy event organizing! 🎉