Skip to content

Learnathon-By-Geeky-Solutions/noobsquad

Folders and files

NameName
Last commit message
Last commit date

Latest commit

Β 

History

449 Commits
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 

Repository files navigation

UConnect πŸŽ“- University Community Platform

FastAPI React Vite TailwindCSS PostgreSQL Hugging Face Google Gemini API License: MIT

UConnect Banner

Connecting Minds, Building Futures.

UConnect is a university-exclusive social media platform, empowering students to share knowledge, collaborate on research, and connect with like-minded peers.

Quick Start Β· Features Β· API Documentation Β· Development Guidelines Β· Report Bug Β· Request Feature

Maintenance License Issues
Quality Gate Coverage Bugs Code Smells

🏫 About UConnect

UConnect brings the university community closer together by offering a dedicated platform for students to share posts, collaborate on educational resources, join field-based communities, and build academic networks.

Why UConnect?

  • 🧠 Knowledge Sharing: Share posts, ideas, and academic resources easily
  • 🏫 University-specific Communities: Connect within your university and department
  • πŸ‘₯ Field-based Collaboration: Join and explore communities in your field of interest
  • πŸ’¬ Interactive Communication: Chat, comment, and engage with fellow students
  • πŸ“š Research Paper Sharing: Showcase and discover research work among peers
  • πŸ“ˆ Professional Growth: Build your academic profile for future opportunities

Key Metrics

100% Verified

University-Authenticated Users

AskU

AI-Powered Chatbot Assistant

Academic Feed

Connect, Share, and Learn

Research Hub

Collaborate and Publish Work

Messenger

Instant, Real-Time Messaging

πŸ“‹ Table of Contents

πŸ‘₯ Team

Role Name GitHub
Team Leader Raad Shahamat Alif GitHub
Team Member Anish Roy GitHub
Team Member H.M. Fahad GitHub

Mentor

πŸš€ Project Overview

UConnect is a university-exclusive social platform designed to promote academic collaboration and social interaction among students. The platform integrates post sharing, research collaboration, AI-integrated chat support, community building, and real-time messaging β€” all under one roof, strictly for verified university students.

Key Goals

  • Connect students within and across universities
  • Build vibrant communities based on departments and fields of interest
  • Share educational resources and research papers effortlessly
  • Stay updated with university events and academic activities
  • Experience real-time communication through an integrated chat system
  • Get instant support and insights with an AI-powered chatbot

🌐 Live Demo

Experience UConnect live:

Live Demo

✨ Key Features

For Students πŸŽ“

  • Profile Creation: Complete multi-step profile (university, department, fields of interest, profile picture)
  • Post Sharing:General post feed and educational resource feed
  • University & Department Filter: Browse posts by university and department
  • Friends System: Add, remove, and interact with friends
  • Messenger System: Real-time chat with peers
  • Commenting System: Comment and reply (up to 2 levels depth)
  • Research Collaboration: Share and explore academic papers
  • Notifications: Stay updated with latest interactions
  • Events Hub: Stay updated with university events, workshops, and academic activities

For Communities πŸ“š

  • University Pages: Explore posts and events related to specific universities
  • Departmental Pages: Find and filter departmental content

πŸ›οΈ System Architecture

Backend: FastAPI (Python)
Frontend: React (Vite) + TailwindCSS
Database: PostgreSQL
Authentication: JWT-based system
Real-time Features: WebSocket (Chat System)

πŸ—„οΈ Database Design

  • collaboration_requests
  • comments
  • connections
  • event_attendees
  • events
  • hashtags
  • likes
  • messages
  • notifications
  • post_documents
  • post_hashtags
  • post_media
  • posts
  • research_collaborations
  • research_collaborators
  • research_papers
  • shares
  • universities
  • users

πŸ–ΌοΈ Database Design Preview

πŸ”— Click here to view the full database design

πŸ“š API Documentation

Explore the API using Swagger:

Swagger Docs

Tech Stack

  • Frontend: React, Vite, Tailwind CSS
  • Backend: FastAPI, PostgreSQL, SQLAlchemy, WebSockets
  • Database: PostgreSQL
  • Authentication: JWT
  • State Management: Context API

πŸ› οΈ Development Guidelines

πŸ§ͺ Testing

  • Backend Unit Tests: pytest
  • Frontend Component Tests: vitest, react-testing-library

πŸ“š Resources

🀝 Contributing

Contributions are welcome!
Please check CONTRIBUTING.md for guidelines.

πŸ“„ License

Distributed under the MIT License.
See LICENSE for more information.


Getting Started

  1. Clone the repository
    git clone https://github.com/noobsquad/uconnect.git
    cd uconnect
  2. Install frontend & backend dependencies
    cd frontend && npm install
    cd ../backend && pip install -r requirements.txt
  3. Setup environment variables (.env) in both frontend and backend
  4. Start development servers
    # Backend
    uvicorn main:app --reload
    
    # Frontend (in another terminal)
    npm run dev

Development Guidelines

  1. Create feature-specific branches
  2. Make small, atomic commits
  3. Use descriptive commit messages
  4. Push changes and create a pull request for code review

Resources


Made with πŸ’™ by Team NoobSquad

About

Repository for team NoobSquad

Resources

License

Stars

Watchers

Forks

Releases

No releases published

Packages

 
 
 

Contributors