# debanjansaha-git/react-blogging-site architecture

> Architecture diagram of the GitHub repository debanjansaha-git/react-blogging-site, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2025-01-27). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/debanjansaha-git/react-blogging-site
- Repository: https://github.com/debanjansaha-git/react-blogging-site

## Overview

##### Main Components Structure

Client Layer (Top):
- Inside this container, create sub-components for:
- Pages (Home, AboutMe, Projects, ProjectDetail)
- Components (Navigation, Header, Footer, etc.)
- Hooks (useTypingEffect)
- Services (blogService, userService, etc.)

Backend Layer (Middle):
- Following Firebase components:
- Authentication
- Firestore Database
- Firebase Storage
- Firebase Hosting

Data Layer (Bottom):
- Both structured (Firestore) and unstructured (Storage) data repositories

##### Specific Implementation Details

Frontend Architecture:
**React App**
- Components Layer
- Auth Components (Login, Register, ProtectedRoute)
- Content Components (ProjectCard, BlogPost, Timeline)
- UI Components (Header, Footer, Navigation)
- Pages Layer
- Home
- AboutMe
- Projects
- ProjectDetail
- Services Layer
- blogService
- userService
- newsletterService
- interactionService

Firebase Integration:
**Firebase Services**
- Authentication
- Firestore Database
- Projects Collection
- Users Collection
- Comments Collection
- Storage
- Media Assets
- Hosting

##### Additional Elements

Security Layer:
- Firebase Authentication flow
- Protected routes and admin-only areas

Data Flow:
- Demonstrate how user interactions trigger state changes
- How data moves between components and services

Build/Deploy Pipeline:
- GitHub Actions workflow
- Firebase deployment process

##### Important Notes

- Separation between authenticated and public areas
- How the blog/project content is managed and displayed
- Where user interactions (comments, newsletter signups) are handled
- Demonstrate the role of service files in managing Firebase interactions

## Diagram (Mermaid)

```mermaid
graph TB
    subgraph Client
        direction TB
        Pages --> |Renders| Components
        Pages --> |Uses| Services
        Components --> |Uses| Services
        Components --> |Uses| Hooks
        
        subgraph Pages
            direction TB
            Home["Home Page"]:::page
            About["About Me Page"]:::page
            Projects["Projects Page"]:::page
            ProjectDetail["Project Detail Page"]:::page
        end

        subgraph Components
            direction TB
            AuthComp["Authentication Components"]:::component
            ContentComp["Content Components"]:::component
            UIComp["UI Components"]:::component
            
            subgraph "Auth Components"
                Login["Login"]:::auth
                Register["Register"]:::auth
                ProtectedRoute["Protected Route"]:::auth
            end
            
            subgraph "Content Components"
                BlogPost["Blog Post"]:::content
                ProjectCard["Project Card"]:::content
                Timeline["Timeline"]:::content
                CommentSection["Comment Section"]:::content
            end
            
            subgraph "UI Components"
                Header["Header"]:::ui
                Footer["Footer"]:::ui
                Navigation["Navigation"]:::ui
                SkillBar["Skill Progress Bar"]:::ui
                SkillTag["Skill Tag"]:::ui
            end
        end

        subgraph Services
            direction TB
            BlogService["Blog Service"]:::service
            UserService["User Service"]:::service
            NewsletterService["Newsletter Service"]:::service
            InteractionService["Interaction Service"]:::service
        end

        subgraph Hooks
            TypingEffect["Typing Effect Hook"]:::hook
        end
    end

    subgraph Firebase
        direction TB
        FirebaseConfig["Firebase Config"]:::firebase
        Auth["Authentication"]:::firebase
        Firestore["Firestore Database"]:::firebase
        Storage["Storage"]:::firebase
        Hosting["Hosting"]:::firebase
    end

    subgraph "Project Content"
        direction TB
        ProjectMD["Project Markdown Files"]:::content
    end

    subgraph "Deployment"
        direction TB
        GithubActions["GitHub Actions"]:::deploy
        FirebaseConfig2["Firebase Config"]:::deploy
    end

    Services --> Firebase
    Auth --> Services
    Firestore --> Services
    Storage --> Services

    %% Click Events
    click Home "https://github.com/debanjansaha-git/react-blogging-site/blob/main/src/pages/Home.js"
    click About "https://github.com/debanjansaha-git/react-blogging-site/blob/main/src/pages/AboutMe.js"
    click Projects "https://github.com/debanjansaha-git/react-blogging-site/blob/main/src/pages/Projects.js"
    click ProjectDetail "https://github.com/debanjansaha-git/react-blogging-site/blob/main/src/pages/ProjectDetail.js"
    click Login "https://github.com/debanjansaha-git/react-blogging-site/blob/main/src/components/Login.js"
    click Register "https://github.com/debanjansaha-git/react-blogging-site/blob/main/src/components/Register.js"
    click ProtectedRoute "https://github.com/debanjansaha-git/react-blogging-site/blob/main/src/components/ProtectedRoute.js"
    click BlogPost "https://github.com/debanjansaha-git/react-blogging-site/blob/main/src/components/BlogPost.js"
    click ProjectCard "https://github.com/debanjansaha-git/react-blogging-site/blob/main/src/components/ProjectCard.js"
    click Timeline "https://github.com/debanjansaha-git/react-blogging-site/blob/main/src/components/Timeline.js"
    click CommentSection "https://github.com/debanjansaha-git/react-blogging-site/blob/main/src/components/CommentSection.js"
    click Header "https://github.com/debanjansaha-git/react-blogging-site/blob/main/src/components/Header.js"
    click Footer "https://github.com/debanjansaha-git/react-blogging-site/blob/main/src/components/Footer.js"
    click Navigation "https://github.com/debanjansaha-git/react-blogging-site/blob/main/src/components/Navigation.js"
    click SkillBar "https://github.com/debanjansaha-git/react-blogging-site/blob/main/src/components/SkillProgressBar.js"
    click SkillTag "https://github.com/debanjansaha-git/react-blogging-site/blob/main/src/components/SkillTag.js"
    click BlogService "https://github.com/debanjansaha-git/react-blogging-site/blob/main/src/services/blogService.js"
    click UserService "https://github.com/debanjansaha-git/react-blogging-site/blob/main/src/services/userService.js"
    click NewsletterService "https://github.com/debanjansaha-git/react-blogging-site/blob/main/src/services/newsletterService.js"
    click InteractionService "https://github.com/debanjansaha-git/react-blogging-site/blob/main/src/services/interactionService.js"
    click TypingEffect "https://github.com/debanjansaha-git/react-blogging-site/blob/main/src/hooks/useTypingEffect.js"
    click FirebaseConfig "https://github.com/debanjansaha-git/react-blogging-site/blob/main/src/firebase.js"
    click ProjectMD "https://github.com/debanjansaha-git/react-blogging-site/tree/main/public/posts"
    click GithubActions "https://github.com/debanjansaha-git/react-blogging-site/tree/main/.github/workflows"
    click FirebaseConfig2 "https://github.com/debanjansaha-git/react-blogging-site/blob/main/firebase.json"

    %% Styling
    classDef page fill:#e1f5fe,stroke:#01579b
    classDef component fill:#e8f5e9,stroke:#2e7d32
    classDef auth fill:#fff3e0,stroke:#ff6f00
    classDef content fill:#f3e5f5,stroke:#7b1fa2
    classDef ui fill:#e8eaf6,stroke:#3f51b5
    classDef service fill:#fce4ec,stroke:#c2185b
    classDef hook fill:#fff8e1,stroke:#ffa000
    classDef firebase fill:#ffebee,stroke:#c62828
    classDef deploy fill:#efebe9,stroke:#4e342e

    %% Legend
    subgraph Legend
        L1["Page"]:::page
        L2["Component"]:::component
        L3["Auth Component"]:::auth
        L4["Content Component"]:::content
        L5["UI Component"]:::ui
        L6["Service"]:::service
        L7["Hook"]:::hook
        L8["Firebase"]:::firebase
        L9["Deployment"]:::deploy
    end
```
