CampusSync is a premium, AI-powered platform designed for university clubs and developer communities. Built for hackathons and scalability, it leverages the power of OpenAI and Firebase to provide deep insights into community health, automate member networking, and streamline event planning.
Get real-time analysis of your community's engagement levels. CampusSync analyzes member activity, attendance trends, and qualitative feedback to provide a "Health Score" and actionable recommendations to prevent churn.
Break the ice with intelligent member networking. Our AI engine analyzes interests, skills, and goals to suggest high-value connections between your members, fostering a more tight-knit community.
Describe your event goals in plain English, and our AI will generate a comprehensive event plan, including timelines, task lists, and marketing copy tailored to your community's voice.
A seamless, real-time experience powered by Firebase Firestore. Switch between multiple communities instantly with our standardized Club Switcher and see live updates across all modules.
- Backend: Node.js, Express.js
- Database: Firebase Firestore
- AI Engine: OpenAI GPT-4o
- Frontend: Vanilla HTML5, Modern CSS3 (Glassmorphism), Vanilla JavaScript
- Security: Firebase Admin SDK
To ensure a clean and scalable codebase, QuantumStack is organized as follows:
| Directory | Description |
|---|---|
backend/src |
Core implementation (Express + TypeScript) |
frontend/public |
Frontend assets and HTML templates |
tests/ |
Automated test suites |
public/ |
Shared assets and static files |
For detailed information on the project's technical aspects, please refer to the following documents:
- 🏗️ Architecture: Deep dive into the backend, integrations, and data flow.
- 🗺️ Roadmap: Product vision and upcoming features.
- 🚀 Deployment: Instructions for deploying to Vercel and Firebase.
- 🔥 Firebase: Configuration, security rules, and data schema.
- Node.js (v18.x or higher)
- A Firebase Project (Firestore enabled)
- An OpenAI API Key
-
Clone the repository:
git clone https://github.com/Davuddevelop/QuantumStack.git cd QuantumStack -
Install dependencies:
npm install
-
Setup Environment Variables: Create a
.envfile in the root directory:PORT=3000 OPENAI_API_KEY=your_openai_api_key_here FIREBASE_PROJECT_ID=your_firebase_project_id FIREBASE_CLIENT_EMAIL=your_firebase_client_email FIREBASE_PRIVATE_KEY="your_firebase_private_key"
-
Fire up the engine:
npm start
Visit
http://localhost:3000to start sync'ing.
CampusSync features a State-of-the-Art design system focused on:
- Glassmorphism: Elegant, translucent layers that provide depth and modern feel.
- Micro-animations: Smooth transitions and hover effects that make the interface feel alive.
- Accessibility: Standardized ARIA roles and landmark structures for an inclusive experience.
- Premium Aesthetics: A curated "Ink & Accent" color palette designed to WOW at first glance.
Distributed under the MIT License. See LICENSE for more information.
Built with ❤️ for the Hackathon.