# netlify-moneytronic/rolandcreate architecture

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

- Interactive diagram: https://gitdiagram.com/netlify-moneytronic/rolandcreate
- Repository: https://github.com/netlify-moneytronic/rolandcreate

## Overview

##### Project type and purpose
- This is a headless-CMS–driven static site built with Next.js (React) that uses Contentful for content management, Stackbit for visual editing integration, and Netlify for hosting/deployment. It provides a repeatable demo workflow: import demo content into a Contentful space, run a local dev server for both the Next.js site and the Stackbit visual editor, then deploy to Netlify.

##### File structure
- Top-level config files: .env.example (environment variables), netlify.toml (build/deploy settings), next.config.js, stackbit.config.js, and various lint/prettier configs.
- contentful/ folder: import-export scripts and JSON asset dumps—used for seeding a Contentful space.
- src/ folder: Next.js “app” directory with dynamic routing ([...slug]), layout/page components, and a components/ subfolder (Button, Hero, Stats).
- src/utils/content.js: abstractions for fetching content from Contentful’s Delivery API.
- public/ and styles/: static assets and global CSS.
- package.json scripts: “import” (npm run import), “dev” (npm run dev), and “stackbit” for running the Stackbit visual editor locally.

##### README for additional insights
- Describes cloning, installing, setting up Contentful API tokens, seeding the Contentful space, and running local dev servers for Next.js and Stackbit.
- Mentions Netlify Create (Visual Editor) using data-sb-object-id annotations for in-page editing.
- Production site deployed on Netlify.

a. Main components:
- Developer Workstation
- Contentful Import Script (node script in contentful/import.js)
- Next.js Development Server (npm run dev)
- Stackbit Visual Editor Server (npm run stackbit)
- Contentful CMS (Content Delivery API + Content Management API)
- Next.js Application (React SSR/SSG)
- Static Assets (public/, images served via Contentful CDN and Netlify CDN)
- Netlify Build & Hosting
b. Relationships & data flow:
1. Developer triggers “npm run import” → import.js reads export JSON → Contentful Management API → seeds Contentful space.
2. Next.js at build time or runtime fetches content via Delivery API (src/utils/content.js) using environment variables.
3. Next.js build produces static HTML/CSS/JS (SSG) or server-rendered pages; assets are bundled.
4. Netlify CI/CD picks up the repo → runs build → deploys the static site + serverless functions if any.
5. End user’s browser requests pages & assets from Netlify CDN.
6. Stackbit Visual Editor injects editing overlays into the running Next.js site by leveraging data-sb-object-id attributes and communicating with Contentful.
c. Architectural patterns & design principles:
- Headless-CMS pattern: decoupled content layer (Contentful) vs. presentation layer (Next.js).
- JAMstack: pre-built markup, CDN distribution, client-side hydration.
- Import script as a one-time or repeatable seeding tool (infrastructure as code for CMS).
- Environment-driven configuration (.env).
d. Key technologies & frameworks:
- Next.js (React, SSG/SSR)
- Contentful (Delivery API, Management API)
- Stackbit (visual editor integration)
- Netlify (CI/CD, CDN hosting)
- Node.js scripts for import

##### Detail
- Environment variables (.env) driving API configuration.
- Location of key files (stackbit.config.js, next.config.js, contentful/import.js).
- Call out static asset hosting (public/, Contentful image CDN).

## Diagram (Mermaid)

```mermaid
flowchart TD
    %% Developer Workstation
    subgraph "Developer Workstation"
        ImportScript["Contentful Import Script"]:::tooling
        Env[".env.example"]:::tooling
        Package["package.json"]:::tooling
        NextConfig["next.config.js"]:::tooling
        StackbitConfig["stackbit.config.js"]:::tooling
        NetlifyConf["netlify.toml"]:::infra
    end

    %% Contentful Import Assets
    subgraph "contentful/"
        ImportConfig["import-config.json"]:::tooling
        ExportConfig["export-config.json"]:::tooling
        ExportData["export.json"]:::tooling
        Assets["ctfassets.net"]:::infra
    end

    %% Contentful CMS
    subgraph "Contentful CMS"
        CMAPI["Management API"]:::backend
        CDAPI["Delivery API"]:::backend
        SeedSpace["Contentful Space"]:::backend
    end

    %% Next.js Application
    subgraph "Next.js Application"
        PageRoot["src/app/page.jsx"]:::frontend
        Layout["src/app/layout.jsx"]:::frontend
        SlugPage["src/app/[...slug]/page.jsx"]:::frontend
        Button["src/components/Button.jsx"]:::frontend
        Hero["src/components/Hero.jsx"]:::frontend
        Stats["src/components/Stats.jsx"]:::frontend
        ContentUtil["src/utils/content.js"]:::frontend
        Public["public/"]:::frontend
        Styles["styles/globals.css"]:::frontend
    end

    %% Netlify CI/CD & CDN
    subgraph "Netlify CI/CD & CDN"
        Build["Netlify Build"]:::infra
        CDN["Netlify CDN"]:::infra
    end

    %% Stackbit Visual Editor
    subgraph "Stackbit Visual Editor"
        SBServer["Stackbit Editor Server"]:::tooling
    end

    %% End User
    Browser["User Browser"]:::frontend

    %% Connections
    ImportScript -->|reads configs| ImportConfig
    ImportScript --> ImportConfig
    ImportScript --> ExportConfig
    ImportScript --> ExportData
    ImportScript --> Assets
    ImportScript -->|seeds space via REST| CMAPI
    CMAPI -->|creates content| SeedSpace
    SeedSpace -->|serves content| CDAPI

    ContentUtil -->|fetches via HTTP REST| CDAPI
    Env --> ContentUtil
    Env --> NextConfig

    PageRoot --> ContentUtil
    SlugPage --> ContentUtil
    Layout --> ContentUtil
    PageRoot --> Public
    PageRoot --> Styles

    Package -->|push repo triggers| Build
    NextConfig -->|build settings| Build
    NetlifyConf -->|deploy config| Build
    Build -->|deploy static assets| CDN
    Public --> CDN
    Styles --> CDN

    CDN -->|serves pages & assets| Browser

    Package -->|npm run stackbit| SBServer
    StackbitConfig --> SBServer
    SBServer -->|injects overlays| Browser
    SBServer -->|edits via| CDAPI

    %% Click Events
    click ImportScript "https://github.com/netlify-moneytronic/rolandcreate/blob/main/contentful/import.js"
    click ImportConfig "https://github.com/netlify-moneytronic/rolandcreate/blob/main/contentful/import-config.json"
    click ExportConfig "https://github.com/netlify-moneytronic/rolandcreate/blob/main/contentful/export-config.json"
    click ExportData "https://github.com/netlify-moneytronic/rolandcreate/blob/main/contentful/export.json"
    click Assets "https://github.com/netlify-moneytronic/rolandcreate/tree/main/contentful/images.ctfassets.net/…"
    click Env "https://github.com/netlify-moneytronic/rolandcreate/blob/main/.env.example"
    click NextConfig "https://github.com/netlify-moneytronic/rolandcreate/blob/main/next.config.js"
    click StackbitConfig "https://github.com/netlify-moneytronic/rolandcreate/blob/main/stackbit.config.js"
    click NetlifyConf "https://github.com/netlify-moneytronic/rolandcreate/blob/main/netlify.toml"
    click PageRoot "https://github.com/netlify-moneytronic/rolandcreate/blob/main/src/app/page.jsx"
    click Layout "https://github.com/netlify-moneytronic/rolandcreate/blob/main/src/app/layout.jsx"
    click SlugPage "https://github.com/netlify-moneytronic/rolandcreate/blob/main/src/app/[...slug]/page.jsx"
    click Button "https://github.com/netlify-moneytronic/rolandcreate/blob/main/src/components/Button.jsx"
    click Hero "https://github.com/netlify-moneytronic/rolandcreate/blob/main/src/components/Hero.jsx"
    click Stats "https://github.com/netlify-moneytronic/rolandcreate/blob/main/src/components/Stats.jsx"
    click ContentUtil "https://github.com/netlify-moneytronic/rolandcreate/blob/main/src/utils/content.js"
    click Public "https://github.com/netlify-moneytronic/rolandcreate/tree/main/public/"
    click Styles "https://github.com/netlify-moneytronic/rolandcreate/blob/main/styles/globals.css"
    click Package "https://github.com/netlify-moneytronic/rolandcreate/blob/main/package.json"

    %% Styles
    classDef backend fill:#cce5ff,stroke:#003366,color:#003366
    classDef frontend fill:#d4edda,stroke:#155724,color:#155724
    classDef infra fill:#fff3cd,stroke:#856404,color:#856404
    classDef tooling fill:#e2e3e5,stroke:#636464,color:#636464
```
