# jubayerhusain/tutor-sphere-client-site architecture

> Architecture diagram of the GitHub repository jubayerhusain/tutor-sphere-client-site, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2025-06-09). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/jubayerhusain/tutor-sphere-client-site
- Repository: https://github.com/jubayerhusain/tutor-sphere-client-site

## Overview

##### Project type and purpose
- This is a full-stack, single-page web application: an **Online Tutor Booking Platform**.
- It connects learners with tutors, enables secure authentication, tutor listing, booking, reviews, and theming.

##### File structure
Top-level folders & files:
- public/ — static JSON data (languages, testimonials, tutors)
- src/ — React application code (AuthProvider, Components, Hooks, Layout, Pages, PrivateRoutes, Routes)
- src/firebase — Firebase initialization
- js config files (eslint, tailwind, vite)
- firebase.json & .firebaserc — Firebase Hosting config
- index.html, main.jsx — application entry

Patterns:
- Component-based UI (React)
- Context provider for auth (AuthProvider.jsx)
- Custom hook for secure Axios (useAxiosSecure.jsx)
- Route segregation (public vs. private)
- Data driven from Firebase Auth + Express/Mongo backend

##### README
- Frontend: React, Tailwind CSS + DaisyUI, AOS for animations
- Backend: Node.js + Express, MongoDB via Mongoose
- Auth & Hosting: Firebase Auth & Hosting for client, Render for server
- Features: tutor search, booking, profile management, reviews, dark/light mode

## Diagram (Mermaid)

```mermaid
flowchart TD
    %% Client Tier
    Browser["Browser"]:::client
    CDN["Firebase Hosting & CDN"]:::service
    FirebaseAuth["Firebase Authentication"]:::service

    subgraph "React Application" 
        direction TB
        INDEX["index.html"]:::client
        MAIN["src/main.jsx"]:::client
        COMPONENTS["UI Components Container"]:::client
        AUTHCTX["AuthProvider (src/AuthProvider/AuthProvider.jsx)"]:::client
        AXIOS["useAxiosSecure Hook"]:::client
        LAYOUT["Layout Wrapper"]:::client
        ROUTES["Public Routes (src/Routes/Routes.jsx)"]:::client
        PRROUTES["Private Routes (src/PrivateRoutes/PrivateRoutes.jsx)"]:::client
        subgraph "Pages"
            direction TB
            HOME["Home Page"]:::client
            FIND["Find Tutors Page"]:::client
            BOOKED["My Booked Tutors Page"]:::client
            MYTUTOR["My Tutorials Page"]:::client
            ADDTUTO["Add Tutorial Page"]:::client
            SIGNIN["Sign In Page"]:::client
            SIGNUP["Sign Up Page"]:::client
            ERROR["Error Handling Page"]:::client
        end
        FIREBASEINIT["Firebase Init (src/firebase/firebase.init.js)"]:::client
        STATIC["Static JSON Data"]:::client
    end

    %% Server Tier
    subgraph "Backend API Server (Node.js + Express)" 
        direction TB
        AUTHMOD["Auth Module"]:::backend
        TUTORMOD["Tutor Module"]:::backend
        BOOKMOD["Booking Module"]:::backend
        STATMOD["Search & Stats Module"]:::backend
    end

    DB["MongoDB"]:::db

    %% Static JSON Data details
    subgraph "Public Data Files"
        LANG["languages.json"]:::client
        TEST["testimonials.json"]:::client
        TUTORSJSON["tutors.json"]:::client
    end

    %% Config files
    ESLINT["eslint.config.js"]:::client
    TAILWIND["tailwind.config.js"]:::client
    VITE["vite.config.js"]:::client
    FIRECONFIG["firebase.json & .firebaserc"]:::service

    %% Connections
    Browser -->|"GET SPA assets\n(index.html, JS, CSS)"| CDN
    CDN -->|serves| INDEX
    INDEX --> MAIN
    MAIN --> COMPONENTS
    MAIN --> AUTHCTX
    MAIN --> AXIOS
    MAIN --> LAYOUT
    MAIN --> ROUTES
    MAIN --> PRROUTES
    ROUTES --> HOME
    ROUTES --> FIND
    PRROUTES --> BOOKED
    PRROUTES --> MYTUTOR
    PRROUTES --> ADDTUTO
    ROUTES --> SIGNIN
    ROUTES --> SIGNUP
    ROUTES --> ERROR
    MAIN --> FIREBASEINIT
    MAIN --> STATIC

    Browser -->|"Auth requests\n(sign-in, token)"| FirebaseAuth
    Browser -->|"Fetch public JSON"| LANG
    Browser -->|"Fetch public JSON"| TEST
    Browser -->|"Fetch public JSON"| TUTORSJSON
    COMPONENTS -->|"uses"| STATIC

    MAIN -->|"REST calls w/Firebase JWT"| AUTHMOD
    MAIN -->|"REST calls w/Firebase JWT"| TUTORMOD
    MAIN -->|"REST calls w/Firebase JWT"| BOOKMOD
    MAIN -->|"REST calls w/Firebase JWT"| STATMOD

    AUTHMOD -->|"Verify JWT\n(HTTPS JSON)"| FirebaseAuth
    AUTHMOD -->|"CRUD operations"| DB
    TUTORMOD -->|"CRUD /tutors"| DB
    BOOKMOD -->|"POST /bookings"| DB
    STATMOD -->|"GET /stats"| DB

    %% Config connections
    MAIN --> ESLINT
    MAIN --> TAILWIND
    MAIN --> VITE
    CDN --> FIRECONFIG

    %% Click Events
    click INDEX "https://github.com/jubayerhusain/tutor-sphere-client-site/blob/main/index.html"
    click MAIN "https://github.com/jubayerhusain/tutor-sphere-client-site/blob/main/src/main.jsx"
    click COMPONENTS "https://github.com/jubayerhusain/tutor-sphere-client-site/tree/main/src/Components"
    click AUTHCTX "https://github.com/jubayerhusain/tutor-sphere-client-site/blob/main/src/AuthProvider/AuthProvider.jsx"
    click AXIOS "https://github.com/jubayerhusain/tutor-sphere-client-site/blob/main/src/Hooks/useAxiosSecure.jsx"
    click LAYOUT "https://github.com/jubayerhusain/tutor-sphere-client-site/blob/main/src/Layout/Layout.jsx"
    click ROUTES "https://github.com/jubayerhusain/tutor-sphere-client-site/blob/main/src/Routes/Routes.jsx"
    click PRROUTES "https://github.com/jubayerhusain/tutor-sphere-client-site/blob/main/src/PrivateRoutes/PrivateRoutes.jsx"
    click HOME "https://github.com/jubayerhusain/tutor-sphere-client-site/blob/main/src/Pages/Home/Home.jsx"
    click FIND "https://github.com/jubayerhusain/tutor-sphere-client-site/blob/main/src/Pages/FindTutors/FindTutors.jsx"
    click BOOKED "https://github.com/jubayerhusain/tutor-sphere-client-site/blob/main/src/Pages/MyBookedTutors/MyBookedTutors.jsx"
    click MYTUTOR "https://github.com/jubayerhusain/tutor-sphere-client-site/blob/main/src/Pages/MyTutorials/MyTutorials.jsx"
    click ADDTUTO "https://github.com/jubayerhusain/tutor-sphere-client-site/blob/main/src/Pages/AddTutorial/AddTutorial.jsx"
    click SIGNIN "https://github.com/jubayerhusain/tutor-sphere-client-site/blob/main/src/Pages/Acounts/SignIn.jsx"
    click SIGNUP "https://github.com/jubayerhusain/tutor-sphere-client-site/blob/main/src/Pages/Acounts/SignUp.jsx"
    click ERROR "https://github.com/jubayerhusain/tutor-sphere-client-site/blob/main/src/Pages/ErrorPage/ErrorPage.jsx"
    click FIREBASEINIT "https://github.com/jubayerhusain/tutor-sphere-client-site/blob/main/src/firebase/firebase.init.js"
    click LANG "https://github.com/jubayerhusain/tutor-sphere-client-site/blob/main/public/languege.json"
    click TEST "https://github.com/jubayerhusain/tutor-sphere-client-site/blob/main/public/testimonials.json"
    click TUTORSJSON "https://github.com/jubayerhusain/tutor-sphere-client-site/blob/main/public/tutors.json"
    click ESLINT "https://github.com/jubayerhusain/tutor-sphere-client-site/blob/main/eslint.config.js"
    click TAILWIND "https://github.com/jubayerhusain/tutor-sphere-client-site/blob/main/tailwind.config.js"
    click VITE "https://github.com/jubayerhusain/tutor-sphere-client-site/blob/main/vite.config.js"
    click FIRECONFIG "https://github.com/jubayerhusain/tutor-sphere-client-site/blob/main/firebase.json"
    click FIRECONFIG "https://github.com/jubayerhusain/tutor-sphere-client-site/blob/main/.firebaserc"

    %% Styles
    classDef client fill:#D0E8FF,stroke:#333,stroke-width:1px
    classDef service fill:#D0FFD6,stroke:#333,stroke-width:1px
    classDef backend fill:#FFD8A8,stroke:#333,stroke-width:1px
    classDef db fill:#E0E0E0,stroke:#333,stroke-width:1px
```
