https://github.com/pinsaraperera/vivent

This is complete event management software application. Manage participants, mark attendance, Easy Email Campaigns, Bulk participants adding, bulk email sending, Email template management, role base access, security features and many more.
https://github.com/pinsaraperera/vivent

authentication bulk-operation event-management-system role-based-access-control

Last synced: 12 months ago
JSON representation

This is complete event management software application. Manage participants, mark attendance, Easy Email Campaigns, Bulk participants adding, bulk email sending, Email template management, role base access, security features and many more.

• Host: GitHub
• URL: https://github.com/pinsaraperera/vivent
• Owner: PinsaraPerera
• Created: 2025-04-27T03:00:16.000Z (about 1 year ago)
• Default Branch: main
• Last Pushed: 2025-05-07T13:16:52.000Z (about 1 year ago)
• Last Synced: 2025-05-07T17:21:34.431Z (about 1 year ago)
• Topics: authentication, bulk-operation, event-management-system, role-based-access-control
• Language: JavaScript
• Homepage: https://vivent.pawanperera.com
• Size: 31.9 MB
• Stars: 1
• Watchers: 1
• Forks: 0
• Open Issues: 0
• Metadata Files:
  • Readme: README.md

Awesome Lists containing this project

README

          
# Vivent Event Management System

A comprehensive event management system for tracking attendance, managing participants, and sending personalized email campaigns for workshops and events.

## Features

- **Student Management**: Add, edit, and delete student records with unique ticket IDs

- **Workshop Organization**: Manage multiple workshops with separate student collections

- **Attendance Tracking**: Mark and track attendance for each event

- **Bulk Import**: Upload CSV files to add multiple students at once

- **Email Campaigns**: Send personalized emails to selected participants

- **Batch Processing**: Send emails in batches of 10 to avoid rate limits

- **Dashboard Analytics**: View attendance statistics and event metrics

- **Modern UI**: Clean, responsive interface with real-time notifications

## Screenshots

### Login

![Login Screenshot](./resources/login.png)

### Dashboard

![Dashboard Screenshot](./resources/dashboard.png)

### Attendance Tracking

![Attendance Tracking Screenshot](./resources/participant_management.png)

### Email Campaigns

![Email Campaigns Screenshot](./resources/email_campaign.png)

### Workshop Management

![Workshop Management Screenshot](./resources/new_event.png)

### Email Logs

![Email Logs Screenshot](./resources/email_logs.png)

### Template Selection

![Template Screenshot](./resources/templates.png)

## Technology Stack

- **Frontend**: Next.js 15 with React 19

- **UI Framework**: Tailwind CSS

- **State Management**: Redux with Redux Persist

- **Database**: Supabase PostgreSQL

- **Authentication**: JWT-based authentication

- **Email Service**: Mailjet API integration

- **Deployment**: Cloud Run (frontend) / Supabase (DB)/ Cloud Run (backend)

## Getting Started

### Prerequisites

- Node.js 18.0 or higher

- Supabase account

- Mailjet API credentials

### Installation

1. Clone the repository:

   ```bash

   git clone https://github.com/PinsaraPerera/Vivent.git

   cd Vivent

   ```

2. Install dependencies:

   ```bash

   npm install

   ```

3. Create a `.env.local` file with the following variables:

   ```

   NEXT_BACKEND_URL=add_your_backend_base_url

   ```

4. Run the development server:

   ```bash

   npm run dev

   ```

5. Open [http://localhost:3000](http://localhost:3000) in your browser

## Usage

### Managing Students

- Add students individually or import in bulk via CSV

- Each student is assigned a unique ticket ID

- Filter and search students by name or email

- Mark attendance with a simple toggle

### Email Campaigns

1. Select a workshop to load its participants

2. Choose an email template

3. Select recipients individually or use "Select All"

4. Preview the email before sending

5. Send emails in batches of 10 for optimal delivery

### Monitoring

- Track email campaign progress in real-time

- View detailed logs of email sending status

- Monitor attendance rates across workshops

## Future Plans

- Advanced analytics and reporting features

- Mobile app for on-site attendance marking

- QR code generation for contactless check-in

- Real-time collaboration features

## License

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