# dantino-solutions/ignite-creative-journey architecture

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

- Interactive diagram: https://gitdiagram.com/dantino-solutions/ignite-creative-journey
- Repository: https://github.com/dantino-solutions/ignite-creative-journey

## Overview

##### Project Type and Purpose
- This is a single-page React application (a static landing page generator) built with Vite, TypeScript, React, shadcn-ui (atomic UI primitives), and Tailwind CSS.
- It is scaffolded and managed via the Lovable platform and produces a fully static site—no backend or runtime API server.

##### File Structure
- Top Level: config files (package.json, tsconfig*.json, vite.config.ts, tailwind.config.ts, eslint.config.js), public assets, and README.
- src/:
- main.tsx – entry point that bootstraps React.
- App.tsx – root component.
- pages/ – route components (Index.tsx, NotFound.tsx, ZenBolsterLandingPage.tsx).
- components/ – reusable sections (HeroSection.tsx, ProblemSection.tsx, etc.) and a ui/ folder of low-level shadcn-ui primitives (buttons, cards, modals, etc.).
- hooks/ – custom hooks (use-mobile, use-toast).
- lib/ – utility functions.
- setupTests.ts – test environment setup; __tests__ folders under components.

##### README for Insights
- Describes development workflow (npm i; npm run dev) using Vite’s dev server.
- Lists core technologies: Vite, TypeScript, React, shadcn-ui, Tailwind CSS.
- Deployment via Lovable or Netlify.
- No backend dependencies or runtime APIs.

a. Main Components
- Developer Environment (IDE / Terminal)
- Git Repository (GitHub)
- Lovable Platform (Web UI, auto-commit integration)
- NPM Registry (dependency source)
- Build Process (Vite dev server & bundler; TypeScript compiler; PostCSS/Tailwind)
- Static Asset Store (dist/ folder)
- Hosting/CDN (Lovable hosting or Netlify)
- End-User Browser (loads static assets; runs the React SPA)

b. Relationships & Interactions
1. Developer edits code locally (IDE) or via Lovable → commits to GitHub repo
2. GitHub ↔ Lovable for live editing interface
3. On commit or “Publish” in Lovable → CI triggers Vite build
4. Build Process fetches code + dependencies (NPM) → outputs static HTML, CSS, JS
5. Deployment step pushes static assets to Hosting/CDN
6. Browser issues HTTP GET to CDN → downloads bundles → React app hydrates & renders pages/components

c. Architectural Patterns & Principles
- SPA with client-side routing (pages)
- Component-driven architecture: page sections and atomic UI primitives
- ESM module bundling with Vite for fast HMR/dev feedback
- Utility-first styling (Tailwind) and design system (shadcn-ui)

d. Key Technologies & Frameworks
- Vite (dev server & bundler)
- React + React Router (or file-based routing in pages/)
- TypeScript (type safety)
- Tailwind CSS + PostCSS (styles)
- shadcn-ui (UI component primitives)
- Jest + React Testing Library (unit tests in __tests__)
- Node.js & npm (runtime & package management)
- GitHub & Lovable (source control & live editing)
- Netlify (optional static hosting)

##### Capturing Essential Elements
- Entry (main.tsx) → App.tsx
- Route pages (src/pages)
- Section components (src/components)
- Atomic UI primitives (src/components/ui)
- Test pipeline: setupTests.ts → Jest runner → __tests__
- Tailwind/PostCSS styling pipeline feeding into the CSS bundle

## Diagram (Mermaid)

```mermaid
flowchart TB
    %% Developer Workflow
    subgraph "Developer Workflow"
        IDE["IDE / Terminal"]:::process
        GitHubRepo[(GitHub Repo)]:::repo
        Lovable["Lovable Platform"]:::external
        NPM["NPM Registry"]:::external
        IDE -->|commits| GitHubRepo
        IDE -->|edits via| Lovable
        Lovable -->|sync| GitHubRepo
        Lovable -->|fetches deps| NPM
    end

    %% Build Pipeline
    subgraph "Build Pipeline"
        Vite["Vite Build Process"]:::process
        TS["TypeScript Compiler"]:::process
        Tailwind["PostCSS / Tailwind CSS"]:::process
        GitHubRepo -->|trigger| Vite
        Vite -->|compile| TS
        Vite -->|style| Tailwind
        Vite -->|install deps| NPM
        Vite -->|output| Dist["dist/ (Static Assets)"]:::repo
    end

    %% Deployment
    subgraph "Deployment"
        CDN["Hosting / CDN"]:::external
        Dist -->|deploy| CDN
    end

    %% Runtime
    Browser["End-User Browser"]:::runtime
    CDN -->|HTTPGET bundles| Browser

    %% Client-side Application
    subgraph "Client-side App"
        entry["src/main.tsx"]:::process
        root["src/App.tsx"]:::process
        entry -->|bootstrap| root

        subgraph "Pages (Routing)"
            index["Home Page\nsrc/pages/Index.tsx"]:::process
            notfound["404 Page\nsrc/pages/NotFound.tsx"]:::process
            zenpage["ZenBolster Page\nsrc/pages/ZenBolsterLandingPage.tsx"]:::process
            root --> index
            root --> notfound
            root --> zenpage
        end

        subgraph "Sections"
            hero["HeroSection\nsrc/components/HeroSection.tsx"]:::process
            problem["ProblemSection\nsrc/components/ProblemSection.tsx"]:::process
            plan["PlanSection\nsrc/components/PlanSection.tsx"]:::process
            solution["SolutionSection\nsrc/components/SolutionSection.tsx"]:::process
            success["SuccessSection\nsrc/components/SuccessSection.tsx"]:::process
            root --> hero
            root --> problem
            root --> plan
            root --> solution
            root --> success

            subgraph "ZenBolster Sections"
                zb_benefits["Benefits\nsrc/components/ZenBolsterBenefitsSection.tsx"]:::process
                zb_cta["CTA\nsrc/components/ZenBolsterCTASection.tsx"]:::process
                zb_hero["Hero\nsrc/components/ZenBolsterHeroSection.tsx"]:::process
                zb_how["How It Works\nsrc/components/ZenBolsterHowItWorksSection.tsx"]:::process
                zb_problem["Problem\nsrc/components/ZenBolsterProblemSection.tsx"]:::process
                zb_solution["Solution\nsrc/components/ZenBolsterSolutionSection.tsx"]:::process
                zenpage --> zb_benefits
                zenpage --> zb_cta
                zenpage --> zb_hero
                zenpage --> zb_how
                zenpage --> zb_problem
                zenpage --> zb_solution
            end
        end
    end

    %% UI Primitives
    subgraph "UI Primitives (shadcn-ui)"
        ui_button["button.tsx"]:::process
        ui_card["card.tsx"]:::process
        ui_dialog["dialog.tsx"]:::process
        ui_tooltip["tooltip.tsx"]:::process
        ui_toast["toast.tsx"]:::process
        ui_toaster["toaster.tsx"]:::process
        root --> ui_button
        root --> ui_card
        root --> ui_dialog
        root --> ui_tooltip
        root --> ui_toast
        root --> ui_toaster
    end

    %% Click Events
    click entry "https://github.com/dantino-solutions/ignite-creative-journey/blob/main/src/main.tsx"
    click root "https://github.com/dantino-solutions/ignite-creative-journey/blob/main/src/App.tsx"
    click index "https://github.com/dantino-solutions/ignite-creative-journey/blob/main/src/pages/Index.tsx"
    click notfound "https://github.com/dantino-solutions/ignite-creative-journey/blob/main/src/pages/NotFound.tsx"
    click zenpage "https://github.com/dantino-solutions/ignite-creative-journey/blob/main/src/pages/ZenBolsterLandingPage.tsx"
    click hero "https://github.com/dantino-solutions/ignite-creative-journey/blob/main/src/components/HeroSection.tsx"
    click problem "https://github.com/dantino-solutions/ignite-creative-journey/blob/main/src/components/ProblemSection.tsx"
    click plan "https://github.com/dantino-solutions/ignite-creative-journey/blob/main/src/components/PlanSection.tsx"
    click solution "https://github.com/dantino-solutions/ignite-creative-journey/blob/main/src/components/SolutionSection.tsx"
    click success "https://github.com/dantino-solutions/ignite-creative-journey/blob/main/src/components/SuccessSection.tsx"
    click zb_benefits "https://github.com/dantino-solutions/ignite-creative-journey/blob/main/src/components/ZenBolsterBenefitsSection.tsx"
    click zb_cta "https://github.com/dantino-solutions/ignite-creative-journey/blob/main/src/components/ZenBolsterCTASection.tsx"
    click zb_hero "https://github.com/dantino-solutions/ignite-creative-journey/blob/main/src/components/ZenBolsterHeroSection.tsx"
    click zb_how "https://github.com/dantino-solutions/ignite-creative-journey/blob/main/src/components/ZenBolsterHowItWorksSection.tsx"
    click zb_problem "https://github.com/dantino-solutions/ignite-creative-journey/blob/main/src/components/ZenBolsterProblemSection.tsx"
    click zb_solution "https://github.com/dantino-solutions/ignite-creative-journey/blob/main/src/components/ZenBolsterSolutionSection.tsx"
    click ui_button "https://github.com/dantino-solutions/ignite-creative-journey/blob/main/src/components/ui/button.tsx"
    click ui_card "https://github.com/dantino-solutions/ignite-creative-journey/blob/main/src/components/ui/card.tsx"
    click ui_dialog "https://github.com/dantino-solutions/ignite-creative-journey/blob/main/src/components/ui/dialog.tsx"
    click ui_tooltip "https://github.com/dantino-solutions/ignite-creative-journey/blob/main/src/components/ui/tooltip.tsx"
    click ui_toast "https://github.com/dantino-solutions/ignite-creative-journey/blob/main/src/components/ui/toast.tsx"
    click ui_toaster "https://github.com/dantino-solutions/ignite-creative-journey/blob/main/src/components/ui/toaster.tsx"

    %% Styles
    classDef process fill:#ADD8E6,stroke:#333,stroke-width:1px
    classDef repo fill:#90EE90,stroke:#333,stroke-width:1px
    classDef external fill:#FFA500,stroke:#333,stroke-width:1px
    classDef runtime fill:#D3D3D3,stroke:#333,stroke-width:1px
```
