Skip to content

prabesh6907/Eventflow

Repository files navigation

🎯 Eventflow - Comprehensive Event Management Platform

A modern, feature-rich event management platform built with Next.js 15, React 19, and TypeScript. Eventflow streamlines the entire event lifecycle from registration to certificate distribution with role-based access control and real-time analytics.

Eventflow Banner React TypeScript Tailwind CSS

✨ Features

πŸŽͺ Core Event Management

  • Smart Registration System - Intelligent forms with custom fields and automated workflows
  • QR Code Check-in - Contactless attendance tracking with real-time scanning
  • Automated Certificates - Generate and distribute certificates automatically to attendees
  • Real-time Analytics - Live attendance monitoring and comprehensive event insights

πŸ‘₯ Multi-Role Support

  • Admin Portal - System-wide organization and user management
  • Organizer Dashboard - Event creation, management, and analytics
  • Participant Interface - Event browsing, registration, and certificate access

πŸ”’ Security & Management

  • Role-based Access Control - Granular permissions for different user types
  • Organization Management - Multi-tenant architecture with isolated data
  • Secure Authentication - Protected routes and session management

🎨 Modern UI/UX

  • Responsive Design - Optimized for desktop, tablet, and mobile devices
  • Dark/Light Mode - Theme switching with system preference detection
  • Accessibility First - WCAG compliant with keyboard navigation support
  • Component Library - Built with Radix UI and shadcn/ui components

πŸš€ Quick Start

Prerequisites

  • Node.js 18+
  • pnpm (recommended) or npm
  • Git

Installation

  1. Clone the repository

    git clone https://github.com/prabesh6907/eventflow.git
    cd eventflow-app
  2. Install dependencies

    pnpm install
    # or
    npm install
  3. Start the development server

    pnpm dev
    # or
    npm run dev
  4. Open your browser Navigate to http://localhost:3000

πŸ“ Project Structure

eventflow-app/
β”œβ”€β”€ app/                          # Next.js App Router
β”‚   β”œβ”€β”€ (auth)/                   # Authentication routes
β”‚   β”‚   β”œβ”€β”€ login/               # User login
β”‚   β”‚   └── register/            # User registration
β”‚   β”œβ”€β”€ admin/                   # Admin dashboard
β”‚   β”œβ”€β”€ admin-portal/            # Admin access portal
β”‚   β”œβ”€β”€ organizer/               # Organizer dashboard
β”‚   β”œβ”€β”€ organizer-auth/          # Organizer authentication
β”‚   β”œβ”€β”€ participant/             # Participant dashboard
β”‚   β”œβ”€β”€ participant-auth/        # Participant authentication
β”‚   β”œβ”€β”€ portal/                  # Main portal with role selection
β”‚   β”‚   β”œβ”€β”€ login/              # Portal login
β”‚   β”‚   β”œβ”€β”€ organization-selection/ # Org selection for multi-tenant
β”‚   β”‚   └── role-selection/      # Role-based routing
β”‚   β”œβ”€β”€ globals.css             # Global styles
β”‚   β”œβ”€β”€ layout.tsx              # Root layout
β”‚   └── page.tsx                # Landing page
β”œβ”€β”€ components/                  # Reusable React components
β”‚   β”œβ”€β”€ ui/                     # shadcn/ui components
β”‚   β”œβ”€β”€ create-event-dialog.tsx # Event creation modal
β”‚   β”œβ”€β”€ navbar.tsx              # Navigation component
β”‚   β”œβ”€β”€ qr-code-dialog.tsx      # QR code generation
β”‚   β”œβ”€β”€ qr-scanner-dialog.tsx   # QR code scanning
β”‚   └── request-service-modal.tsx # Service request form
β”œβ”€β”€ hooks/                       # Custom React hooks
β”œβ”€β”€ lib/                        # Utility functions and configurations
β”œβ”€β”€ public/                     # Static assets
β”œβ”€β”€ styles/                     # Additional stylesheets
β”œβ”€β”€ components.json             # shadcn/ui configuration
β”œβ”€β”€ next.config.mjs            # Next.js configuration
β”œβ”€β”€ package.json               # Dependencies and scripts
β”œβ”€β”€ tailwind.config.ts         # Tailwind CSS configuration
└── tsconfig.json              # TypeScript configuration

πŸ› οΈ Tech Stack

Frontend Framework

  • Next.js 15.2.4 - React framework with App Router
  • React 19 - Latest React with concurrent features
  • TypeScript 5 - Type-safe JavaScript

UI & Styling

  • Tailwind CSS 3.4.17 - Utility-first CSS framework
  • Radix UI - Unstyled, accessible UI primitives
  • shadcn/ui - Beautiful component library
  • Lucide React - Modern icon library
  • next-themes - Theme switching functionality

Form Handling & Validation

  • React Hook Form 7.54.1 - Performant forms with validation
  • Zod 3.24.1 - TypeScript-first schema validation
  • @hookform/resolvers - Form validation resolvers

Additional Libraries

  • date-fns - Modern JavaScript date utility library
  • Sonner - Toast notifications
  • Recharts - Composable charting library
  • cmdk - Command palette component
  • Vaul - Drawer component for mobile

πŸ“‹ Available Scripts

# Development
pnpm dev          # Start development server
pnpm build        # Build for production
pnpm start        # Start production server
pnpm lint         # Run ESLint

# Package management
pnpm install      # Install dependencies
pnpm add <pkg>    # Add new package

🎭 User Roles & Access

πŸ”‘ Admin

  • System Management - Manage organizations and system settings
  • User Oversight - View and manage all users across organizations
  • Analytics Access - System-wide performance metrics
  • Organization Creation - Add new organizations with auto-generated credentials

πŸŽͺ Organizer

  • Event Management - Create, edit, and manage events
  • Participant Tracking - Monitor registrations and attendance
  • Certificate Distribution - Generate and send certificates
  • Event Analytics - Detailed event performance insights

πŸ‘€ Participant

  • Event Discovery - Browse and search available events
  • Registration - Sign up for events with custom forms
  • Certificate Access - Download earned certificates
  • Personal Dashboard - Track attended events and achievements

🌟 Key Components

Authentication System

  • Multi-role authentication with organization-based access
  • Secure session management
  • Role-based route protection

Event Management

  • Dynamic event creation with custom fields
  • Real-time participant tracking
  • Automated workflow management

QR Code Integration

  • Generate unique QR codes for events
  • Real-time scanning for check-ins
  • Attendance verification system

Analytics Dashboard

  • Real-time event metrics
  • Participant engagement tracking
  • Comprehensive reporting tools

πŸš€ Deployment

Vercel (Recommended)

  1. Push your code to GitHub
  2. Connect your repository to Vercel
  3. Configure environment variables
  4. Deploy automatically

Other Platforms

The app can be deployed on any platform supporting Node.js:

  • Netlify
  • AWS Amplify
  • Railway
  • Render

🀝 Contributing

We welcome contributions.

  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

πŸ“ License

This project is licensed under the MIT License.

πŸ™ Acknowledgments


Built by the Eventflow Team

Making event management effortless, one event at a time.

About

Eventflow: Event Management App

Resources

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published

Contributors 2

  •  
  •  

Languages