Skip to content

Sumeet-Y1/Sphere-Frontend

Folders and files

NameName
Last commit message
Last commit date

Latest commit

Β 

History

7 Commits
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 

Repository files navigation

🌐 Sphere Frontend

The official frontend for Sphere a modern community and news platform built with React, Vite, and Tailwind CSS.

✨ Features

  • πŸ” JWT Authentication (Login & Register)
  • 🏠 Home Feed β€” posts from all communities
  • 🏘️ Communities β€” create, join, browse
  • πŸ“ Posts β€” create, vote, comment
  • πŸ’¬ Nested Comments
  • πŸ“° News Feed β€” categories & search
  • πŸ€– AI Insights powered by Groq
  • πŸ”” Real-time Notifications via WebSocket
  • πŸ’Œ Direct Messages β€” real-time DMs
  • πŸ‘€ User Profiles β€” follow, block
  • πŸŒ™ Dark UI β€” black & white theme

πŸ› οΈ Tech Stack

Technology Purpose
React 19 UI Framework
Vite 7 Build Tool
Tailwind CSS Styling
Axios API Calls
React Router v7 Navigation
SockJS + StompJS WebSocket / Real-time

πŸš€ Getting Started

Prerequisites

  • Node.js 18+
  • Sphere Backend running on http://localhost:8080

Installation

# Clone the repo
git clone https://github.com/Sumeet-Y1/Sphere-Frontend.git
cd Sphere-Frontend

# Install dependencies
npm install

# Start dev server
npm run dev

Open http://localhost:5173 in your browser.

πŸ“ Project Structure

src/
β”œβ”€β”€ api/            ← Axios instance & API calls
β”œβ”€β”€ components/     ← Reusable components (Navbar, etc.)
β”œβ”€β”€ context/        ← Auth context
β”œβ”€β”€ hooks/          ← Custom hooks
β”œβ”€β”€ pages/
β”‚   β”œβ”€β”€ Auth/       ← Login & Register
β”‚   β”œβ”€β”€ Home/       ← Main feed
β”‚   β”œβ”€β”€ Community/  ← Communities
β”‚   β”œβ”€β”€ Post/       ← Post detail & create
β”‚   β”œβ”€β”€ Profile/    ← User profile
β”‚   ← News feed
β”‚   └── DM/         ← Direct messages
└── utils/          ← Helper functions

πŸ”Œ Backend

This frontend connects to the Sphere Spring Boot backend.

Backend repo: Sphere

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

Built with ❀️ by Sumeet

About

🌐 Sphere Frontend A modern community & news platform built with React + Vite + Tailwind CSS. Features real-time notifications, DMs via WebSocket, AI-powered insights, and a clean dark UI.

Resources

Stars

Watchers

Forks

Releases

No releases published

Packages

 
 
 

Contributors