Skip to content

avadhutmali/wlug-osd-2k26-frontend

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

20 Commits
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

OSD 2k26 – Frontend (Event Registration Platform)

This is the frontend application for the OSD 2k26 Event Registration Platform, built for Open Source Day 2k26 organized by the Walchand Linux Users' Group (WLUG).

The frontend is a fast, responsive React + Vite application that allows participants to register, generates event tickets with QR codes in real time, and triggers backend APIs for confirmation emails.


Features

  • Fully Responsive UI using Tailwind CSS
  • Fast Performance powered by Vite
  • Instant Ticket Generation (PNG format)
  • Unique QR Code per Ticket
  • Smooth Animations using Framer Motion
  • API Integration with backend registration service

Tech Stack

  • React
  • Vite
  • Tailwind CSS
  • Framer Motion
  • html-to-image
  • QR Code Generator

Project Structure

client/
├── src/
│   ├── components/
│   │   ├── Register.jsx
│   │   ├── Ticket.jsx
│   ├── assets/
│   ├── App.jsx
│   └── main.jsx
├── index.html
├── tailwind.config.js
├── vite.config.js
└── package.json

Getting Started

Prerequisites

  • Node.js v18+
  • npm or yarn
  • Backend API URL (local or deployed)

Installation

1️ Navigate to Frontend Directory

cd client

2️ Install Dependencies

npm install

Configuration

Update the backend API endpoint inside
src/components/Register.jsx

// Local backend
const API_URL = "http://localhost:5000/api/register";

// Production backend
const API_URL = "https://your-backend-url.onrender.com/api/register";

Run Development Server

npm run dev

The app will be available at:

http://localhost:5173


Build for Production

npm run build

The optimized build will be generated in the dist/ folder.

To preview the production build locally:

npm run preview

Environment Notes

  • Ensure the backend has CORS enabled
  • API URL must be reachable from the frontend
  • Ticket generation is done client-side, no backend load

Maintained By

Walchand Linux Users' Group (WLUG)
Open Source • Community Driven • Innovation

About

Resources

Stars

Watchers

Forks

Releases

No releases published

Packages

 
 
 

Contributors