# adrianhajdin/ecommerce_sanity_stripe architecture

> Architecture diagram of the GitHub repository adrianhajdin/ecommerce_sanity_stripe, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2025-05-26). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/adrianhajdin/ecommerce_sanity_stripe
- Repository: https://github.com/adrianhajdin/ecommerce_sanity_stripe

## Overview

##### Project Type and Purpose
- This is a modern full-stack e-commerce web application built on Next.js (React) with server-side rendering/static generation, React Context for state, Stripe for payments, and Sanity as a headless CMS.
- The “sanity_ecommerce” folder is the separate Sanity project that provides content (products, banners) via its APIs.

##### High-Level File Structure Analysis
- Top-level files: .env (API keys), next.config.js, package.json, build/lint config.
- “pages/”: Next.js page routes (UI and serverless backend endpoints under pages/api).
- “components/”: React presentation components (Navbar, Cart, Product, etc.).
- “context/StateContext.js”: React Context managing cart state.
- “lib/”: helper modules for Sanity client, Stripe integration, utilities.
- “public/”: static assets served at root.
- “styles/”: global and module CSS.
- “sanity_ecommerce/”: standalone Sanity studio code with schemas, config, and built static admin UI.

##### Key Architecture Insights from README
- Uses Next.js data-fetching methods (getStaticProps, getServerSideProps) to retrieve product/banners from Sanity.
- Implements serverless API routes for initiating Stripe checkout sessions.
- Leverages React Context API for cart management on the client.
- Sanity handles content management (no custom database).

##### Main Components
a. Frontend (Next.js Application)
– UI Components (components/…)
– State Management (React Context)
– Data-fetching layer (getStaticProps / getServerSideProps)
b. Serverless Backend (Next.js API)
– /api/stripe.js (creates Stripe checkout sessions)
– /api/hello.js (demo endpoint)
c. Headless CMS (Sanity)
– Sanity Studio (admin UI in sanity_ecommerce/dist)
– Sanity Content API (product/banner data)
d. External Service (Stripe)
– Payments, checkout, shipping rates
e. Static Assets & CDN
– Public folder assets, built pages, and CMS static (Sanity studio build)

##### Relationships and Data Flows
- Browser → Next.js frontend: navigates pages, React renders UI.
- Next.js frontend ↔ Sanity Content API: fetch product lists/details via client.js in lib.
- Next.js frontend ↔ React Context: add/remove items in cart.
- When user checks out: Next.js API route (/api/stripe) → Stripe API to create session → returns session URL → front end redirects user.
- Sanity Studio (admin) → Sanity Content API: editors update product content, which Next.js fetches on next build or request.

##### Architectural Patterns and Principles
- Jamstack / hybrid: static generation + serverless functions.
- Headless CMS integration: decoupled content management.
- Single Page App UX with server-rendered pages for performance.
- Client-side state via Context to avoid prop drilling.
- Secure secret handling in .env and API routes.

##### Final Recommendations
- Be exhaustive: break down each folder’s role.
- Build/deploy flow: Next.js app → Vercel/Cdn, Sanity Studio → netlify/docker, Stripe always external.
- Bearer token/env usage confined to serverless functions.

## Diagram (Mermaid)

```mermaid
flowchart TD
    %% User
    User["Browser / User"]:::external

    %% Frontend Layer
    subgraph "Next.js Frontend" 
        direction TB
        UI["UI Components"]:::frontend
        Context["React Context (StateContext)"]:::frontend
        DataFetch["Data-Fetching Layer"]:::frontend
    end

    %% Backend Layer
    subgraph "Serverless Backend (Next.js API)" 
        direction TB
        StripeAPI["/api/stripe.js"]:::backend
        HelloAPI["/api/hello.js"]:::backend
    end

    %% CMS Layer
    subgraph "Sanity Headless CMS" 
        direction TB
        Studio["Sanity Studio (Admin UI)"]:::cms
        ContentAPI["Sanity Content API"]:::cms
        Datastore[(Sanity Datastore)]:::storage
    end

    %% External Services and Assets
    subgraph "External & Assets"
        direction TB
        StripeService["Stripe API"]:::external
        CDN["Static Assets & CDN"]:::assets
        Config["Env & Config"]:::config
    end

    %% Relationships
    User -->|"HTTP GET / fetch"| UI
    UI -->|"uses Context API"| Context
    UI -->|"getStaticProps / getServerSideProps"| DataFetch
    DataFetch -->|"HTTP GET (Sanity API)"| ContentAPI
    DataFetch -->|"uses getStripe helper"| StripeAPI
    StripeAPI -->|"Stripe SDK / API"| StripeService
    HelloAPI -->|"demo endpoint"| UI
    Studio -->|"update content"| ContentAPI
    ContentAPI -->|"stores data"| Datastore
    UI -->|"serves assets"| CDN
    UI -->|"env vars read at build"| Config
    StripeAPI -->|"reads secrets"| Config

    %% Click Events - Frontend
    click UI "https://github.com/adrianhajdin/ecommerce_sanity_stripe/tree/main/components/"
    click Context "https://github.com/adrianhajdin/ecommerce_sanity_stripe/blob/main/context/StateContext.js"
    click DataFetch "https://github.com/adrianhajdin/ecommerce_sanity_stripe/blob/main/lib/client.js"
    click DataFetch "https://github.com/adrianhajdin/ecommerce_sanity_stripe/blob/main/lib/utils.js"
    click DataFetch "https://github.com/adrianhajdin/ecommerce_sanity_stripe/blob/main/lib/getStripe.js"

    %% Click Events - Pages
    click UI "https://github.com/adrianhajdin/ecommerce_sanity_stripe/blob/main/pages/index.js"
    click UI "https://github.com/adrianhajdin/ecommerce_sanity_stripe/blob/main/pages/product/[slug].js"
    click UI "https://github.com/adrianhajdin/ecommerce_sanity_stripe/blob/main/pages/success.js"

    %% Click Events - API
    click StripeAPI "https://github.com/adrianhajdin/ecommerce_sanity_stripe/blob/main/pages/api/stripe.js"
    click HelloAPI "https://github.com/adrianhajdin/ecommerce_sanity_stripe/blob/main/pages/api/hello.js"

    %% Click Events - Assets & Styles
    click CDN "https://github.com/adrianhajdin/ecommerce_sanity_stripe/tree/main/public/assets/"
    click Config "https://github.com/adrianhajdin/ecommerce_sanity_stripe/blob/main/.env"
    click Config "https://github.com/adrianhajdin/ecommerce_sanity_stripe/blob/main/next.config.js"

    %% Click Events - CMS
    click Studio "https://github.com/adrianhajdin/ecommerce_sanity_stripe/tree/main/sanity_ecommerce/dist/"
    click Studio "https://github.com/adrianhajdin/ecommerce_sanity_stripe/tree/main/sanity_ecommerce/config/"
    click Studio "https://github.com/adrianhajdin/ecommerce_sanity_stripe/blob/main/sanity_ecommerce/sanity.json"
    click ContentAPI "https://github.com/adrianhajdin/ecommerce_sanity_stripe/blob/main/sanity_ecommerce/schemas/product.js"
    click ContentAPI "https://github.com/adrianhajdin/ecommerce_sanity_stripe/blob/main/sanity_ecommerce/schemas/banner.js"
    click ContentAPI "https://github.com/adrianhajdin/ecommerce_sanity_stripe/blob/main/sanity_ecommerce/schemas/schema.js"

    %% Styles
    classDef frontend fill:#D0E8FF,stroke:#0366d6,color:#0366d6
    classDef backend fill:#E6F4EA,stroke:#28a745,color:#28a745
    classDef cms fill:#FFF4E5,stroke:#d9822b,color:#d9822b
    classDef external fill:#F3E5FF,stroke:#6f42c1,color:#6f42c1
    classDef storage fill:#FFE5E5,stroke:#d73a49,color:#d73a49
    classDef assets fill:#E8F6FF,stroke:#005cc5,color:#005cc5
    classDef config fill:#F0F0F0,stroke:#586069,color:#586069
```
