INNOVEX AI

A modern hackathon management platform built for seamless team registration, project submission, evaluation, and event administration.

A full-stack platform for managing hackathons with secure authentication, project submissions, evaluator workflows, and administrative control.

React • TypeScript • Supabase • PostgreSQL • Tailwind CSS • Netlify

Live Demo • Local Setup • Issues

3 User Roles

15 Problem Statements

3 Authentication Methods

100 Maximum Score

---

Project Goals

• Simplify hackathon management
• Eliminate spreadsheet workflows
• Improve evaluation transparency
• Centralize submissions

---

Why INNOVEX AI?

• Centralized hackathon management
• Multi-role authentication
• Secure database-level authorization
• End-to-end submission workflow
• Panel-based evaluation
• Real-time leaderboard

---

Key Features

Student OAuth & Email Auth Team Registration PPT/PDF Upload Status Tracking

Evaluator Access Code Login Panel Dashboard Score Submission

Administrator Team Management Panel Assignment Live Leaderboard CSV Export

---

Core Modules

• Authentication
• Team Registration
• Problem Statements
• Project Submission
• Evaluation
• Leaderboard
• Administration

---

Architecture

Browser
     │
     ▼
React + TypeScript
     │
     ▼
Supabase Backend
     ├── Authentication
     ├── PostgreSQL
     ├── Storage
     └── Row Level Security

---

Project Workflow

Student
   │
   ▼
Team Registration
   │
   ▼
Problem Selection
   │
   ▼
Project Submission
   │
   ▼
Admin Review
   │
   ▼
Evaluator Scoring
   │
   ▼
Final Score
   │
   ▼
Leaderboard

---

Tech Stack

Category	Technology
Frontend	React 19
Language	TypeScript
Backend	Supabase
Database	PostgreSQL
Styling	Tailwind CSS
Build Tool	Vite
Deployment	Netlify

---

Repository Structure

• Configuration: Vite, TypeScript, and Tailwind configuration files
• Frontend: React pages, UI components, and global styles
• Backend: Supabase SDK services and API wrappers
• Database: PostgreSQL schema, seed data, and fix scripts
• Public Assets: Static files and offline service workers

---

Getting Started

For a detailed walkthrough, see LOCAL_SETUP.md.

Prerequisites

• Node.js 20+
• npm
• Supabase Project
• Netlify Account (optional)

Installation

git clone https://github.com/ShadyNights/Innovex-Ai.git
cd Innovex-Ai
cp .env.example .env
npm install

Environment Variables

Populate .env with:

VITE_SUPABASE_URL=your_supabase_url
VITE_SUPABASE_ANON_KEY=your_supabase_anon_key
VITE_GOOGLE_CLIENT_ID=your_google_client_id

---

Running

Development

npm run dev

Production Build

npm run build

Preview Build

npm run preview

---

Security

Feature	Status
JWT Authentication	✅
Google OAuth	✅
Role-Based Access	✅
PostgreSQL RLS	✅
Secure RPC	✅
Protected Routes	✅
Protected File Uploads	✅
Session Persistence	✅
Database Constraints	✅

---

Roadmap

• Email Notifications
• Docker Support
• CI/CD Pipeline
• Automated Testing
• Admin Analytics
• Audit Logs

---

Contributing

1. Fork the repository.
2. Create a feature branch (git checkout -b feature/your-feature).
3. Commit your changes (git commit -m 'Add some feature').
4. Push to the branch (git push origin feature/your-feature).
5. Open a Pull Request.

---

Disclaimer

This project was developed for educational and hackathon management purposes. It can be adapted for similar event management workflows with additional production hardening.

---

License

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

---

Made with ❤️ by Kashif Ansari

GitHub • LinkedIn