# sashenjayathilaka/photo-sharing-application architecture

> Architecture diagram of the GitHub repository sashenjayathilaka/photo-sharing-application, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2025-04-28). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/sashenjayathilaka/photo-sharing-application
- Repository: https://github.com/sashenjayathilaka/photo-sharing-application

## Overview

##### Project Type and Purpose
- This is a full-stack, client-centric photo-sharing app (Pinterest-like).
- Frontend: React.js + TailwindCSS SPA (in /src).
- Backend: Sanity headless CMS (in /sanity) for storing “pins,” comments, users.
- Auth & supporting services: Firebase Authentication (Google sign-in) and (optionally) Firebase Storage.

##### File Structure
- Top-level:
- package.json, postcss.config.js, tailwind.config.js → build/config.
- public/ → static assets, index.html.
- src/ → React application source.
- sanity/ → custom Sanity Studio configuration and schema.
- src/client.js → initializes Sanity client for querying/mutations.
- src/firebase.js → configures Firebase Auth (and possibly Storage).
- src/components & src/container → React UI and container components.
- Environment variables under README → Sanity dataset & token, Firebase API keys, base URL.

##### Main Components
a. React SPA (Browser)
- UI Layer: Components (Feed, PinDetail, CreatePin, Navbar…)
- Data Layer: client.js (Sanity queries), firebase.js (Auth calls)
b. Sanity Headless CMS
- Sanity API (GROQ/GraphQL endpoints)
- Dataset (pins, users, comments, images)
c. Firebase Services
- Authentication (Google OAuth)
- (Optional) Storage (for image uploads if used)
d. Hosting/CDN
- Netlify (or similar) serving the SPA via CDN
e. External Dependencies
- TailwindCSS for styling
- PostCSS for processing

##### Relationships & Data Flows
- User (Browser) → (1) Firebase Auth → Google OAuth Provider → returns JWT
- React SPA uses JWT to guard routes and to attach to API calls as needed.
- React SPA → (2) Sanity Client API → CRUD on pins, comments, users, image assets.
- (Optional) React SPA → (3) Firebase Storage → upload/download raw images.
- Sanity Studio (Admin) → Sanity API → manage content outside of SPA.

##### Architectural Patterns & Principles
- Single Page Application (SPA) with clear UI/Data separation.
- Headless CMS pattern: decoupled content API (Sanity) from presentation.
- Externalizing secrets & config via environment variables.
- Container/Presentational pattern in React.
- Component-based UI with a central “client” abstraction for data fetching.

- Browser → React SPA (UI & Data Layer)
- Sanity Studio
- Firebase Auth (and Storage if used)
- Hosting/CDN
- User → Firebase Auth → React SPA (login flow)
- React SPA → Sanity API (data flow)
- React SPA → Firebase Storage (if applicable)
- Sanity Studio → Sanity API (admin flow)
- Rectangles for services/code.

## Diagram (Mermaid)

```mermaid
flowchart TD
    %% User and External
    User["End User (Browser)"]:::external
    OAuth["Google OAuth Provider"]:::external

    %% Hosting and Build
    subgraph "Build & Hosting"
        BuildConfig["Tailwind/PostCSS Build\n(tailwind.config.js,\npostcss.config.js)"]:::config
        click BuildConfig "https://github.com/sashenjayathilaka/photo-sharing-application/blob/master/tailwind.config.js"
        click BuildConfig "https://github.com/sashenjayathilaka/photo-sharing-application/blob/master/postcss.config.js"
        PublicAssets["Public Assets\n(index.html, manifest.json,\n_redirects)"]:::config
        click PublicAssets "https://github.com/sashenjayathilaka/photo-sharing-application/blob/master/public/index.html"
        click PublicAssets "https://github.com/sashenjayathilaka/photo-sharing-application/blob/master/public/manifest.json"
        click PublicAssets "https://github.com/sashenjayathilaka/photo-sharing-application/tree/master/public/_redirects"
        Netlify["Netlify CDN\n(Static Hosting)"]:::service
    end

    %% React SPA
    subgraph "React SPA" 
        Entry["Entry Points\n(src/index.js,\nsrc/App.js)"]:::frontend
        click Entry "https://github.com/sashenjayathilaka/photo-sharing-application/blob/master/src/index.js"
        click Entry "https://github.com/sashenjayathilaka/photo-sharing-application/blob/master/src/App.js"
        subgraph "UI Layer"
            Presentational["Presentational Components\n(src/components/)"]:::frontend
            click Presentational "https://github.com/sashenjayathilaka/photo-sharing-application/tree/master/src/components/"
            Container["Container Components\n(src/container/)"]:::frontend
            click Container "https://github.com/sashenjayathilaka/photo-sharing-application/tree/master/src/container/"
        end
        subgraph "Data Layer"
            SanityClient["Sanity Client\n(src/client.js)"]:::service
            click SanityClient "https://github.com/sashenjayathilaka/photo-sharing-application/blob/master/src/client.js"
            FirebaseAdapter["Firebase Adapter\n(src/firebase.js)"]:::service
            click FirebaseAdapter "https://github.com/sashenjayathilaka/photo-sharing-application/blob/master/src/firebase.js"
        end
    end

    %% Sanity Services
    subgraph "Sanity Studio" 
        StudioConfig["Studio Config\n(sanity/sanity.json,\nsanity/README.md,\nsanity/config/)"]:::service
        click StudioConfig "https://github.com/sashenjayathilaka/photo-sharing-application/blob/master/sanity/sanity.json"
        click StudioConfig "https://github.com/sashenjayathilaka/photo-sharing-application/blob/master/sanity/README.md"
        click StudioConfig "https://github.com/sashenjayathilaka/photo-sharing-application/tree/master/sanity/config/"
        StudioBuild["Studio Build Output\n(sanity/dist/)"]:::service
        click StudioBuild "https://github.com/sashenjayathilaka/photo-sharing-application/blob/master/sanity/dist/index.html"
        click StudioBuild "https://github.com/sashenjayathilaka/photo-sharing-application/tree/master/sanity/dist/static/"
    end

    subgraph "Sanity API & Dataset"
        API["Sanity API\n(GROQ/GraphQL)"]:::service
        Dataset[(Dataset\npins, users,\ncomments, images)]:::storage
        SchemaModels["Schema Models\n(sanity/schemas/schema.js)"]:::service
        click SchemaModels "https://github.com/sashenjayathilaka/photo-sharing-application/blob/master/sanity/schemas/schema.js"
    end

    %% Firebase Services
    subgraph "Firebase Services"
        Auth["Firebase Auth"]:::service
        Storage["Firebase Storage\n(optional)"]:::storage
    end

    %% Environment & Metadata
    Env["Environment & Metadata\n(README.md, package.json)"]:::config
    click Env "https://github.com/sashenjayathilaka/photo-sharing-application/blob/master/README.md"
    click Env "https://github.com/sashenjayathilaka/photo-sharing-application/blob/master/package.json"

    %% Flows
    User -->|"visit SPA"| Netlify
    BuildConfig -->|builds| Netlify
    PublicAssets -->|served| Netlify
    Netlify -->|"delivers SPA"| User
    User -->|login via SDK| Auth
    Auth -->|JWT token| Entry
    Entry -->|"renders UI"| Presentational
    Entry -->|"renders UI"| Container
    Presentational -->|"invoke data calls"| SanityClient
    Container -->|"invoke data calls"| FirebaseAdapter
    SanityClient -->|"GROQ over HTTPS"| API
    API -->|"reads/writes"| Dataset
    API -->|"uses schemas"| SchemaModels
    Storage -->|"upload/download"| FirebaseAdapter
    StudioConfig -->|"admin UI"| StudioBuild
    StudioBuild -->|"management calls"| API
    Env -->|provides| Entry

    %% Styles
    classDef frontend fill:#D0E6FF,stroke:#333,stroke-width:1px
    classDef service fill:#D5F5E3,stroke:#333,stroke-width:1px
    classDef storage fill:#E8F8F5,stroke:#333,stroke-width:1px
    classDef config fill:#F2F3F4,stroke:#333,stroke-width:1px
    classDef external fill:#FCF3CF,stroke:#333,stroke-width:1px
```
