StageSync Web App

StageSync is a web application for organizing and managing music event performances at BVRIT Hyderabad College. It gives students a central place to register performances and upload songs, while hosts can coordinate submissions, schedules, event details, and participant information.

Features

• Google OAuth authentication restricted to the @bvrithyderabad.edu.in domain
• Role-based experiences for participants and event hosts
• Pre-registration whitelist for authorized users
• MP3 upload support with a maximum file size of 5 MB
• Solo and group performance registration
• Performance number assignment and duplicate detection
• Event schedule and performance-order management
• Host-to-participant comments and deletion-request workflow
• Host management with synchronized permissions
• Registration deadline and upload-status controls
• Analytics dashboard for submissions, users, performance types, and pending requests
• Excel export for event and song data
• Automatic cleanup of event files one week after the event ends
• Session persistence for up to seven days

Technology Stack

• Frontend: HTML5, CSS3, and JavaScript (ES6+)
• Backend services: Supabase PostgreSQL database and Storage
• Authentication: Google OAuth
• Web server: Node.js
• Deployment: Compatible with Render and Vercel configuration

Project Structure

File	Purpose
index.html	Main StageSync application interface
index-simple.html	Simplified application interface
server-simple.js	Lightweight Node.js static file server
package.json	Project metadata and start script
render.yaml	Render deployment configuration
vercel.json	Vercel deployment configuration
DOC-revised-one.md	Detailed project overview and requirements

Getting Started

Prerequisites

• Node.js 14 or later
• npm
• Access to the configured Supabase project and authentication settings, if using the full application functionality

Run locally

1. Clone the repository:

   git clone https://github.com/praghnyau/StageSync_webapp.git
   cd StageSync_webapp

2. Install dependencies:

   npm install

3. Start the local server:

   npm start

4. Open http://localhost:8080 in a browser.

The server uses index.html as the default page and serves static assets from the repository root.

Deployment

The repository includes deployment configuration for:

• Render: render.yaml uses Node.js, runs npm install, and starts server-simple.js.
• Vercel: vercel.json provides Vercel deployment settings.

Before deploying, configure the required Supabase and Google OAuth settings for the target environment.

Scope and Limitations

• Only MP3 files up to 5 MB are supported.
• Access is intended for authorized BVRIT Hyderabad users and designated hosts.
• The application does not provide audio editing, waveform visualization, native mobile apps, or offline functionality.
• Multiple-file uploads and non-MP3 audio formats are not supported.

Documentation

For the complete project scope, objectives, feature descriptions, and technical context, see DOC-revised-one.md.

License

No license has been specified for this project yet.