🚀 SparkCU

A comprehensive website made to manage hackathons with team registration, admin controls, and real-time updates.

---

📖 Description

SparkCU is a hackathon management platform built to handle event registrations, team management, and administrative tasks. It features Firebase integration for real-time data synchronization, admin authentication, and a clean, modern interface for both participants and organizers.

What makes it unique:

• Complete hackathon lifecycle management
• Admin panel with authentication
• Real-time team updates
• Firebase backend integration
• Responsive design for all devices

---

✨ Features

• Team Registration – Easy signup and team formation
• Admin Dashboard – Comprehensive management controls
• Real-time Updates – Live event information
• Firebase Integration – Secure data storage and authentication
• Responsive UI – Works perfectly on all devices
• Admin Setup Utility – Automated admin configuration

---

🧠 Tech Stack

Frontend

• React
• JavaScript
• CSS3

Backend

• Firebase Firestore
• Firebase Authentication

Deployment

• GitHub Pages
• Custom Domain

---

🏗️ Architecture / Workflow

User Registration → Team Formation → Admin Approval → Event Updates → Results

---

⚙️ Installation & Setup

# Clone the repository
git clone https://github.com/DevRanbir/sparkcu.git

# Navigate to project
cd sparkcu

# Install dependencies
npm install

# Start the project
npm start

---

🔐 Environment Variables

Create a .env file and add:

REACT_APP_FIREBASE_API_KEY=your_firebase_api_key
REACT_APP_FIREBASE_PROJECT_ID=your_project_id
REACT_APP_FIREBASE_AUTH_DOMAIN=your_auth_domain

---

🧪 Usage

• Step 1: Visit the hackathon website
• Step 2: Register your team
• Step 3: Admins approve registrations
• Step 4: Track event progress
• Step 5: View results and announcements

---

🎥 Demo

• Live Demo: https://cuspark.live/

---

📂 Project Structure

sparkcu/
├── src/
│   ├── components/
│   ├── utils/
│   │   └── adminSetup.js
│   ├── index.js
│   └── App.css
├── public/
├── package.json
└── README. md

---

🚧 Future Improvements

• Add live judging system
• Implement team chat feature
• Add project submission portal
• Create mentor matching system
• Add analytics dashboard

---

👥 Team / Author

• Name: DevRanbir
• GitHub: https://github.com/DevRanbir

---

📜 License

This project is licensed under the MIT License.