Skip to content

About

Repository for ByteForce for Syrus 7.0 - 2026

Resources

Stars

0 stars

Watchers

0 watching

Forks

Latest commit

Β 

History

23 Commits

Folders and files

Repository files navigation

πŸŽ“ Campusly

A student-run, Reddit-style web platform built for engineering campus life.

Juniors and seniors connect to ask, share and exchange.

Status SDG 4 SDG 12

React Tailwind CSS Node.js MongoDB Supabase Gemini

Built for SYRUS 7.0 Hackathon Β· CodeCell++, CMPN, VESIT Domain: Sustainability (PS-4) Β· Team: ByteForce


🚧 Project status: Campusly is currently a working prototype. Features marked βœ… are built; everything marked πŸ—“οΈ is planned. See Project Status for the full breakdown.

πŸ“Œ Table of Contents


🧩 Problem Statement

CampusConnect: Peer-to-Peer Engineering Learning & Resource Sharing Platform (working title: Campusly)

First-year engineering students feel overwhelmed by academics, tech domains and costly study materials, while seniors' tips and leftover resources sit unused or get lost in WhatsApp groups.

Problem What's happening
❓ No Safe Space to Ask Juniors lack a student-run space to ask doubts and get guidance without hesitation.
πŸ’¬ Fragmented Knowledge Roadmaps, exam strategies and experiences stay scattered across WhatsApp groups.
πŸ“¦ Idle Resources Textbooks and calculators go unused with seniors while juniors buy costly new material.

The missing link: a proper student-run platform where juniors can get guidance, ask openly or anonymously, and easily borrow, buy or exchange study materials.


πŸ’‘ Our Solution

Campusly is a student-run web platform for engineering students: Reddit-style, but built for campus life. Juniors and seniors connect to ask, share and exchange.


🧱 Modules

Module Name What it does
A πŸ‘₯ Technical Communities Hubs for Web3, AI/ML, Cloud and DSA to share roadmaps, project ideas and prep guides.
B πŸ’¬ Q&A and Mentorship Ask openly or anonymously, get threaded senior advice, and upvote the best answers.
C πŸ“£ Opportunity Hub Curated board of hackathons, coding contests and internships with deadlines and tips.
D πŸ” Academic Resource Exchange Buy, sell, donate or borrow calculators, textbooks, lab kits and notes.

πŸ† Profiles & Brownie Points

Every user has a profile with their study year, tech stack and Brownie (karma) points, plus bookmarks for useful posts. Users also pick a Bitmoji avatar for their campus profile and comments.

Action Brownies
Create a post +15
Your post gets an upvote +10
Write a comment +5
Your comment gets an upvote +5

πŸ›‘οΈ Moderation & Safety

  • Flag toxic content, scam listings and identity leaks.
  • Anonymous authors stay protected: real IDs are masked at the auth layer.
  • Scam or dead links are caught and hidden until a senior approves.
  • Past a report threshold, Supabase Realtime pulls the post and alerts moderators.
  • Moderators review flagged content from a dedicated view.

πŸ€– AI-Assisted Features

Powered by the free Google Gemini API:

Feature Powered by Description
πŸ” Answers Before You Ask Gemini Embeddings + Atlas Vector Search Semantic search that surfaces matching past threads as you type.
πŸ“ Threads to Checklists Gemini Flash One click turns a long thread into an actionable checklist or summary.
🚨 Scam & Toxicity Scans Gemini (NLP) Auto-moderation for scam listings, dead links and toxic content.
πŸ“Έ Photo to Listing Gemini Vision Auto-detects title, category and condition from an item photo.

✨ Showstopper: Snap a Photo, Listing Done

πŸ“· Upload a photo      β†’   Item photo goes to free cloud storage (Supabase Storage)
🧠 Gemini Vision reads β†’   Auto-detects title, category and condition
πŸ—„οΈ Listing is created  β†’   Saved as a MongoDB document, zero manual typing

Other highlights

  • πŸ•΅οΈ Anonymous, yet protected: real IDs are masked at the auth layer.
  • πŸ” Answers before you ask: vector search surfaces past threads as you type.
  • βœ… Threads to checklists: long threads become actionable checklists.
  • 🧹 Self-cleaning feed: scam or dead links are hidden until a senior approves.
  • 🍫 Brownie rewards: points for posts, upvotes and helpful comments.
  • ⚑ Live real-time chats: learn from seniors through live chats, not just threads.
  • πŸ’Έ Built to stay free: free Gemini API and cloud storage keep AI running without extra infrastructure cost.

πŸ—οΈ Architecture & Tech Stack

flowchart LR
    subgraph P[Presentation]
        A["React.js Frontend<br/>Home feed & communities<br/>Q&A threads and listings<br/>Profiles, upvotes, bookmarks"]
    end
    subgraph B[Application]
        N["Node.js Backend<br/>Posts, listings, search<br/>Reports & moderation checks<br/>Calls Gemini and MongoDB Atlas"]
    end
    subgraph D[Data & Services]
        M[("MongoDB Atlas<br/>Posts, listings, profiles<br/>Vector Search, moderation flags")]
        S[("Supabase<br/>Auth - masked IDs<br/>Storage - item photos<br/>Realtime / WebSockets")]
    end
    G{{"Google Gemini API<br/>Embeddings Β· Flash Β· NLP Β· Vision"}}

    A --> N
    N --> M
    N --> S
    N --> G
Loading
Layer Technology
Frontend HTML, CSS, JavaScript, React.js
UI Styling Tailwind CSS
Backend & DB Node.js, Supabase, MongoDB (Atlas)
AI Google Gemini API (Embeddings, Flash, NLP, Vision)
Dev Tools Figma, VS Code, AI coding tools (Claude, Codex, Grok, Gemini)

πŸ—ΊοΈ Implementation Plan

Platform flow: Sign-up & Profile β†’ Home Feed β†’ Modules A to D β†’ Engagement β†’ Moderation Review β†’ Outcome (SDG 4 & 12)

# Phase Scope
1 Foundation & Auth Supabase Auth with masked identities, profile setup, React + Tailwind shell, Node.js API and MongoDB Atlas data model.
2 Knowledge Modules (A & B) Technical Communities and Q&A & Mentorship: threaded answers, upvotes, Brownie points and bookmarks.
3 Opportunities & Exchange (C & D) Opportunity Hub board and Resource Exchange with Supabase Storage uploads and Gemini Vision auto-listing.
4 AI Intelligence Layer Embeddings with Atlas Vector Search, Flash thread summaries, and NLP scans for scams, dead links and toxicity.
5 Safety & Launch Report thresholds, Supabase Realtime takedowns and moderator view; then pilot with first-year students.

πŸ“ Project Status

βœ… Built so far (working prototype)

  • College-email sign-in, protected by Supabase Authentication
  • Profile page with Brownie score
  • Bitmoji avatar picker

πŸ—“οΈ Planned

  • Home feed
  • Module A: Technical Communities
  • Module B: Q&A and Mentorship (threads, upvotes, bookmarks)
  • Module C: Opportunity Hub
  • Module D: Academic Resource Exchange
  • Gemini Vision photo-to-listing
  • Semantic search with Atlas Vector Search
  • Thread summaries / checklists with Gemini Flash
  • Scam, dead-link and toxicity scans
  • Report thresholds, Realtime takedowns and moderator view
  • Live real-time chats
  • Pilot with first-year engineering students

πŸ’Ό Business Plan

πŸ‘₯ Who we serve First-year engineering students: guidance, answers and affordable materials. Seniors: share roadmaps, exam strategies and leftover resources. Moderators: review flagged content from a dedicated view.
🎯 Value proposition One student-run hub instead of scattered WhatsApp groups. Anonymous or open posting lowers the barrier to ask. Buy, sell, lend or donate materials, with opportunities in one place.
⚑ Lean cost model Free Google Gemini API for text, vision and embeddings. Supabase for auth and storage; MongoDB Atlas for data. AI features run without extra infrastructure costs.

Growth path (proposed): Pilot with first-year engineering students on one campus, refine from feedback, then extend to more campuses.


🌍 Sustainability Impact

  • SDG 4: Quality Education: peer mentoring and shared roadmaps.
  • SDG 12: Responsible Consumption & Production: reuse of books, calculators and lab kits over repurchase.
  • Brownie points reward helpful contributors.

πŸ‘¨β€πŸ’» Team

Team ByteForce

Name Role
Ayush Singh (add role)
(add teammate) (add role)

Built with β˜• for SYRUS 7.0 Hackathon Β· CodeCell++, CMPN, Vivekanand Education Society's Institute of Technology (VESIT)

About

Repository for ByteForce for Syrus 7.0 - 2026

Resources

Stars

0 stars

Watchers

0 watching

Forks

Releases

Packages

Used by

Contributors

Languages