Skip to content

About

Resources

Stars

0 stars

Watchers

1 watching

Forks

Repository files navigation

🚲 Cycle-Sphere — Full Stack Bicycle Management Platform

A complete full-stack bicycle showcase and management application designed to deliver a dynamic user experience using raw React on the frontend and a robust backend setup.

🌐 Live Site: bicycle-sphere.vercel.app

📁 backend Repo: bicycle-sphere-backend

(This project was mainly a team project)

🌐 Live Site: cycle-sphere.vercel.app

📁 frontend Repo: cycle-sphere-client 📁 backend Repo: cycle-sphere-backend


🧠 Project Overview

Cycle-Sphere is a feature-rich web app for bicycle enthusiasts, shop managers, or online vendors. It includes full CRUD operations, user management, and dynamic rendering without using a framework like Next.js — just plain React.js with a powerful backend stack.


🚀 Tech Stack

🔹 Frontend

  • Library: React.js (no framework)
  • Language: JavaScript
  • Styling: Tailwind CSS / CSS Modules
  • State Management: Context API

🔹 Backend

  • Runtime: Node.js + Express
  • Language: TypeScript
  • Database: MongoDB with Mongoose
  • Authentication: JWT
  • Deployment: Vercel (frontend), Render/Heroku (backend)

📦 Features

🔍 Search and Browse

  • Advanced filtering for cycles
  • View detailed cycle information

🛒 E-commerce Functionality

  • Add to cart and manage cycle list
  • Order management & history

🛡️ Security & Authentication

  • Secure user authentication and protected routes
  • JWT-based authorization

🎨 User Experience

  • Form validation and error handling
  • Responsive and mobile-friendly design

⚙️ Admin Management

  • Admin CRUD interface for cycles
  • Admin tools to manage cycle inventory

👤 User Features

  • User profiles and dashboards
  • SSLCommerz integration for purchases

🛠 Getting Started

To run the project locally, follow these steps:

1. Clone the repository

git clone https://github.com/Faey2023/cycle-sphere

2. Navigate into the project directory

cd cycle-sphere

3. Install frontend & backend dependencies

npm install

4. Start the development server

npm run dev

The app should now be running at http://localhost:3000.


About

Resources

Stars

0 stars

Watchers

1 watching

Forks

Releases

Packages

Used by

Contributors

Languages