Skip to content

ItsAzura/Event_webapp

Repository files navigation

Event Management System

πŸš€ Overview

The Event Management System is a cutting-edge, full-stack application designed to streamline event creation, management, and attendance. Built with Next.js 14 on the frontend and a powerful backend API, this platform delivers a seamless event management experience with an intuitive user interface and robust features.


✨ Features

  • πŸ”Ž Event Discovery: Browse, search, and filter events effortlessly.
  • πŸ“ Event Details: View event descriptions, locations, dates, and available ticket options.
  • πŸ” User Authentication: Secure login and registration with JWT-based authentication and role-based access control.
  • 🎟 Ticket Management: Purchase tickets with multiple pricing options for different event areas.
  • πŸ›’ Shopping Cart: Add multiple tickets and adjust quantities before checkout.
  • πŸ‘€ User Profiles: Manage personal information and access ticket history.
  • ⭐ Feedback System: Rate and leave comments on attended events.
  • πŸ›  Admin Dashboard: Manage events, users, and registrations efficiently.
  • πŸ“± Responsive UI: Fully optimized for desktop and mobile devices.

πŸ›  Technology Stack

Frontend

Category Technology
Framework Next.js 14
Language TypeScript
Styling Tailwind CSS
Animations Framer Motion
State Management Zustand
API Communication Axios
Form Handling React Hook Form
Notifications React Toastify
Data Visualization Recharts

Backend

  • RESTful API: Provides secure and scalable backend services.
  • JWT Authentication: Ensures safe user authentication and session management.

⚑ Getting Started

1️⃣ Prerequisites

  • Node.js (v18.0.0 or higher)
  • npm or yarn package manager

2️⃣ Installation

  1. Clone the repository:

    git clone <repository-url>
    cd frontend
  2. Install dependencies:

    npm install
    # or
    yarn install
  3. Set up environment variables: Create a .env.local file and add:

    NEXT_PUBLIC_API_URL=https://your-api-url.com
  4. Start the development server:

    npm run dev
    # or
    yarn dev
  5. Open http://localhost:3000 in your browser.


🎭 User Roles & Permissions

Role Capabilities
Visitor Browse and view event details
Registered User Purchase tickets, provide feedback, manage profile
Event Organizer Create and manage their own events
Administrator Full system access, manage all entities

πŸ”„ Key Workflows

🎫 Attending an Event

  1. Browse/search for events.
  2. Select an event to view details.
  3. Choose an event area and purchase tickets.
  4. Complete the checkout process.
  5. Access purchased tickets in the Profile section.

πŸ“… Creating an Event (Organizer)

  1. Access the Event Creation Form.
  2. Provide event details and upload an event image.
  3. Configure event areas, capacities, and pricing.
  4. Publish the event.

πŸš€ Deployment

The application is optimized for deployment on Vercel or Netlify.

npm run build
# or
yarn build

πŸ“œ License

This project is licensed under the MIT License. See the LICENSE file for more details.


πŸŽ‰ Empowering event organizers and attendees with a seamless digital experience!

About

No description, website, or topics provided.

Resources

Stars

Watchers

Forks

Releases

No releases published

Packages

 
 
 

Contributors

Languages