# buttreygoodness/style-atelier-vista architecture

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

- Interactive diagram: https://gitdiagram.com/buttreygoodness/style-atelier-vista
- Repository: https://github.com/buttreygoodness/style-atelier-vista

## Overview

##### Project type and purpose
- This is a single‐page application (SPA) built with React (TypeScript) and Tailwind CSS, bundled by Vite.
- It has no custom backend in this repo; it’s intended to be deployed as a static frontend via the Lovable platform (Git‐backed, CI/CD driven).

##### File structure
- Top‐level config and metadata: package.json, vite.config.ts, tsconfig.json, tailwind.config.ts
- Public assets: public/robots.txt, index.html
- Source code under src/:
- main.tsx / index.css → application entrypoint, global styles
- App.tsx, pages/ => routing and view layer
- components/ => feature‐level UI pieces (HeroSection, Footer, etc.)
- components/ui/ => low‐level shadcn-ui wrappers and primitives (button, dialog, etc.)
- hooks/, lib/ => shared logic and utilities

##### Key insights from the README
- Technologies: Vite, TypeScript, React, shadcn-ui, Tailwind CSS
- Edit & deploy flow: Git push → Lovable → automated build & publish
- Optional custom domain via Lovable settings

## Diagram (Mermaid)

```mermaid
flowchart TD
    subgraph "Developer Environment"
        IDE["IDE (VSCode)"]:::devtools
        NodeJS["Node.js & NPM"]:::devtools
        GitLocal["Git (local clone)"]:::devtools
    end

    subgraph "Version Control & CI/CD"
        GitHub["GitHub / Lovable Git"]:::cicd
        LovableCI["Lovable CI/CD Pipeline"]:::cicd
    end

    subgraph "Config & Entry"
        Main["Entry Point: src/main.tsx"]:::config
        IndexCSS["Global Styles: src/index.css"]:::config
        AppCSS["Global Styles: src/App.css"]:::config
        AppShell["App Shell: src/App.tsx"]:::config
        ViteConfig["vite.config.ts"]:::config
        TailwindConfig["tailwind.config.ts"]:::config
        PostCSS["postcss.config.js"]:::config
        TSConfig["tsconfig.json"]:::config
        PackageJSON["package.json"]:::config
    end

    subgraph "Build System"
        ViteDev["Vite Dev Server"]:::build
        ViteBuild["Vite Build Process"]:::build
    end

    subgraph "Static Hosting & CDN"
        LovableHost["Lovable Hosting & CDN"]:::hosting
        CustomDomain["Custom Domain (optional)"]:::hosting
    end

    subgraph "Client Runtime"
        Browser["Browser"]:::runtime
        ReactApp["React App"]:::runtime
        Router["React Router"]:::runtime
        CSSBundle["CSS Bundle"]:::runtime
    end

    subgraph "UI Component Layers"
        subgraph "Pages"
            IndexPage["Home Page"]:::pages
            NotFoundPage["404 Page"]:::pages
        end
        subgraph "Feature Components"
            Hero["HeroSection"]:::feature
            CollectionGrid["CollectionGrid"]:::feature
            FeaturedCollection["FeaturedCollection"]:::feature
            Editorial["EditorialSection"]:::feature
            Navbar["Navbar"]:::feature
            Newsletter["NewsletterSignup"]:::feature
            Footer["Footer"]:::feature
        end
        subgraph "Primitive UI Components"
            UIPrimitives["UI Primitives (src/components/ui/)"]:::primitive
        end
        subgraph "Shared Logic"
            MobileHook["use-mobile Hook"]:::primitive
            ToastHook["use-toast Hook"]:::primitive
            Utils["Utility Library (utils.ts)"]:::primitive
        end
    end

    IDE & NodeJS & GitLocal -->|"write code"| Main
    Main -->|"imports"| AppShell
    AppShell -->|"loads styles"| IndexCSS & AppCSS
    GitLocal -->|"push code"| GitHub
    GitHub -->|"trigger build"| LovableCI
    LovableCI -->|"run build"| ViteBuild
    ViteBuild -->|"uses config"| ViteConfig & TailwindConfig & PostCSS & TSConfig & PackageJSON
    ViteBuild -->|"outputs"| Dist["dist/ (static assets)"]:::build
    Dist -->|"deploy"| LovableHost
    LovableHost -->|"serve assets"| Browser
    Browser -->|"loads"| ReactApp
    ReactApp -->|"uses router"| Router
    Router -->|"renders"| IndexPage & NotFoundPage
    IndexPage -->|"renders"| Hero & CollectionGrid & FeaturedCollection & Editorial & Navbar & Newsletter & Footer
    Hero & CollectionGrid & FeaturedCollection & Editorial & Navbar & Newsletter & Footer -->|"use primitives"| UIPrimitives
    ReactApp -->|"imports hooks & utils"| MobileHook & ToastHook & Utils
    UIPrimitives -->|"styled by Tailwind & shadcn-ui"| CSSBundle
    LovableHost -->|"optional"| CustomDomain

    click Main "https://github.com/buttreygoodness/style-atelier-vista/blob/main/src/main.tsx"
    click IndexCSS "https://github.com/buttreygoodness/style-atelier-vista/blob/main/src/index.css"
    click AppCSS "https://github.com/buttreygoodness/style-atelier-vista/blob/main/src/App.css"
    click AppShell "https://github.com/buttreygoodness/style-atelier-vista/blob/main/src/App.tsx"
    click IndexPage "https://github.com/buttreygoodness/style-atelier-vista/blob/main/src/pages/Index.tsx"
    click NotFoundPage "https://github.com/buttreygoodness/style-atelier-vista/blob/main/src/pages/NotFound.tsx"
    click Hero "https://github.com/buttreygoodness/style-atelier-vista/blob/main/src/components/HeroSection.tsx"
    click CollectionGrid "https://github.com/buttreygoodness/style-atelier-vista/blob/main/src/components/CollectionGrid.tsx"
    click FeaturedCollection "https://github.com/buttreygoodness/style-atelier-vista/blob/main/src/components/FeaturedCollection.tsx"
    click Editorial "https://github.com/buttreygoodness/style-atelier-vista/blob/main/src/components/EditorialSection.tsx"
    click Navbar "https://github.com/buttreygoodness/style-atelier-vista/blob/main/src/components/Navbar.tsx"
    click Newsletter "https://github.com/buttreygoodness/style-atelier-vista/blob/main/src/components/Newsletter.tsx"
    click Footer "https://github.com/buttreygoodness/style-atelier-vista/blob/main/src/components/Footer.tsx"
    click UIPrimitives "https://github.com/buttreygoodness/style-atelier-vista/tree/main/src/components/ui/"
    click MobileHook "https://github.com/buttreygoodness/style-atelier-vista/blob/main/src/hooks/use-mobile.tsx"
    click ToastHook "https://github.com/buttreygoodness/style-atelier-vista/blob/main/src/hooks/use-toast.ts"
    click Utils "https://github.com/buttreygoodness/style-atelier-vista/blob/main/src/lib/utils.ts"
    click ViteConfig "https://github.com/buttreygoodness/style-atelier-vista/blob/main/vite.config.ts"
    click TailwindConfig "https://github.com/buttreygoodness/style-atelier-vista/blob/main/tailwind.config.ts"
    click PostCSS "https://github.com/buttreygoodness/style-atelier-vista/blob/main/postcss.config.js"
    click TSConfig "https://github.com/buttreygoodness/style-atelier-vista/blob/main/tsconfig.json"
    click PackageJSON "https://github.com/buttreygoodness/style-atelier-vista/blob/main/package.json"

    classDef devtools fill:#E3F2FD,stroke:#2196F3,color:#0D47A1;
    classDef cicd fill:#FFF3E0,stroke:#FB8C00,color:#E65100;
    classDef config fill:#E8F5E9,stroke:#43A047,color:#1B5E20;
    classDef build fill:#F3E5F5,stroke:#8E24AA,color:#4A148C;
    classDef hosting fill:#E0F2F1,stroke:#009688,color:#004D40;
    classDef runtime fill:#FFEBEE,stroke:#E53935,color:#B71C1C;
    classDef pages fill:#FFECB3,stroke:#FB8C00,color:#E65100;
    classDef feature fill:#E1F5FE,stroke:#039BE5,color:#01579B;
    classDef primitive fill:#FCE4EC,stroke:#D81B60,color:#880E4F;
```
