Skip to content

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

83 Commits
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

Campus Connect Header

Campus Connect

A Centralized Digital Ecosystem for Kenyan University Students


📖 1. Project Mission & Value Proposition

Campus Connect is the one platform for everything in campus — trade textbooks, find hostels, join study groups, access M-Pesa payments, and stay safe with emergency SOS. Built by students, for students.


🏛 2. System Architecture

The platform utilizes a Modular Service-Oriented Architecture designed for high availability and low-latency performance in mobile-first environments.

  • Frontend: React.js / Next.js (Optimized for PWA performance).
  • Backend: Node.js & Express (Scalable API Gateway).
  • Authentication: Firebase Authentication (Email/Password, Google, and Phone sign-in).
  • Database & Storage: Supabase (PostgreSQL database + Cloud Storage for file uploads and media).
  • Payments: M-Pesa Daraja API Integration (Lipa na M-Pesa).
  • Safety: Real-time WebSocket signaling for emergency triggers.

📋 3. High-Impact Feature Roadmap

A. The "Comrade Market" & Commerce

Feature Description Implementation
Book Swap/Resale A dedicated hub to buy and sell textbooks and revision materials. CRUD + Supabase Storage
Hostel Finder Peer-reviewed directory of private hostels with pricing and security ratings. Ratings + Maps API
Side-Hustle Hub A portal for student services like coding, laundry, and photography. Service Profiles
Dining Guide Instant access to information on Mess, STC, and other dining areas. Location Services

B. Academic & Career Synergy

  • Resource Library: Cloud-based folder system organized by course code for sharing past papers and notes.
  • Virtual Tutoring: A marketplace where senior students offer paid tutoring sessions.
  • Study Group Finder: Matching students by course, year, and specific academic needs.
  • Internship Alerts: A curated list of attachments and graduate programs for Kenyan undergrads.
  • Skill Exchange: A "teach-to-learn" platform for peer-to-peer skill sharing.

C. Safety, Wellness & Governance

  • Emergency SOS: A one-tap button that alerts campus security or nearby student volunteers.
  • Anonymous "Sema" Portal: A secure space for mental health discussions and reporting grievances.
  • Issue Reporting: A tracker for campus facility problems and administrative feedback.
  • Election Portal: A digital platform for student leadership voting and official polling.

D. Campus Life Enhancement

  • Event Aggregator: Centralized ticketing for sports, plays, and "inter-uni" bashes via M-Pesa.
  • Lost & Found: A digital portal with a photo verification system for recovered items.
  • Campus Navigation: Interactive maps for building locations and essential campus services.
  • Student Deals: Exclusive discounts from local businesses for verified students.

🛡 4. Security, Trust & Verification

To maintain a professional and safe environment, the platform implements:

  • University Email Verification: Mandatory for all account creations to ensure authenticity.
  • Moderation Framework: Student moderators assigned from each respective institution.
  • Data Privacy Controls: Granular user control over personal information and visibility.
  • Reputation System: Rating systems for all business advertisers and service providers.

🚀 5. Getting Started

Installation

  1. Clone the Source:
    git clone [https://github.com/vertigo0628/CampusConnect.git](https://github.com/vertigo0628/CampusConnect.git)
    cd CampusConnect
  2. Environment Configuration: Create a .env file and input the following keys:
    • SUPABASE_URL — Your Supabase project URL.
    • SUPABASE_ANON_KEY — Your Supabase anonymous/public key.
    • NEXT_PUBLIC_FIREBASE_API_KEY — Your Firebase API key.
    • NEXT_PUBLIC_FIREBASE_AUTH_DOMAIN — Your Firebase Auth domain.
    • NEXT_PUBLIC_FIREBASE_PROJECT_ID — Your Firebase Project ID.
    • NEXT_PUBLIC_FIREBASE_STORAGE_BUCKET — Your Firebase Storage Bucket.
    • NEXT_PUBLIC_FIREBASE_MESSAGING_SENDER_ID — Your Firebase Messaging Sender ID.
    • NEXT_PUBLIC_FIREBASE_APP_ID — Your Firebase App ID.
    • MPESA_DARAJA_CREDENTIALS — Your M-Pesa Daraja API credentials.
  3. Boot the System:
    npm install && npm run dev

Contributing

We welcome all student developers. Please follow the Fork-and-Pull model. All feature additions must align with the security protocols outlined in Section 4.


Developed for the Kenyan Student Community. © 2026 Campus Connect Kenya.

About

No description, website, or topics provided.

Resources

Stars

Watchers

Forks

Releases

Packages

Contributors

Languages