# viktorsvertoka/tattoo-studio architecture

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

- Interactive diagram: https://gitdiagram.com/viktorsvertoka/tattoo-studio
- Repository: https://github.com/viktorsvertoka/tattoo-studio

## Overview

##### Project type and purpose
- This is a Next.js–based, front‑end‑only web application for a Tattoo Studio. It’s built with React (TSX), Tailwind CSS, and static data under src/data. There is no dedicated backend or database; everything is rendered via Next.js (SSG/SSR) and served as a collection of static/SSR pages.

##### File structure
- Top‑level config files: ESLint, Prettier, TypeScript (tsconfig), PostCSS, Tailwind, Next.js config.
- src/app/: Next.js “app router” pages—layout.tsx, page.tsx, plus subpaths for “blog” and “gallery.”
- src/components/: UI broken into two folders:
- sections/: high‑level page sections (Hero, About, Services, etc.)
- ui/: reusable UI primitives (Navbar, Modal, GridList, etc.)
- src/data/: JSON‑style data modules to feed the UI.
- src/styles/: global CSS.

##### README for additional insights

a. Main components
- Client (Browser)
- Next.js renderer (SSG/SSR engine)
- Page modules (src/app)
- Layout component (shared wrapper)
- Section components (src/components/sections)
- UI components (src/components/ui)
- Data modules (src/data)
- Static assets (public/)
- Tooling & build layer (Next.js, Webpack/Turbopack, PostCSS, Tailwind)
- Hosting/CDN (Vercel, Netlify, etc.)

b. Relationships & interactions
1. Browser requests a URL → hits Hosting/CDN → deleg ates to Next.js server (or serves pre‑rendered HTML).
2. Next.js router (src/app) picks the correct page.tsx.
3. Page.tsx imports Layout and feeds it data from src/data.
4. Layout composes various section components, which in turn pull in UI primitives.
5. UI primitives may reference public assets or SVGs (via svgr).
6. Tailwind/PostCSS transforms CSS at build time; TypeScript and ESLint ensure code quality.
7. The final bundle (JavaScript, CSS, HTML) is deployed to the CDN.

c. Architectural patterns & design principles
- Component‑based (atomic design): small UI primitives compose larger sections.
- File‑system routing (Next.js app router).
- Static data provisioning (no runtime API).
- Separation of concerns: pages ↔ layout ↔ sections ↔ UI primitives ↔ data.
- Build‑time rendering: SSG/SSR for performance.

d. Relevant technologies, frameworks, libraries
- Next.js (app router, SSG/SSR)
- React + TypeScript
- Tailwind CSS + PostCSS
- SVGR for SVG imports
- ESLint, Prettier for linting/formatting

##### Final advice
- Every layer from the developer‑facing code (src/*) to the end‑user experience.
- Where SSG vs. SSR occurs, if any.
- Build pipeline as a separate flow that transforms code/config into deployable artifacts.

## Diagram (Mermaid)

```mermaid
flowchart TB
    %% External client
    Browser["Client Browser"]:::external
    Hosting["Hosting/CDN (Vercel/Netlify)"]:::external
    NextServer["Next.js Server (SSG/SSR)"]:::runtime

    %% Pages layer
    subgraph "Pages (src/app)" 
        direction TB
        PageHome["page.tsx"]:::runtime
        PageBlog["blog/page.tsx"]:::runtime
        PageGallery["gallery/page.tsx"]:::runtime
        PageNotFound["not-found.tsx"]:::runtime
    end

    %% Layout
    Layout["layout.tsx"]:::runtime

    %% Sections layer
    subgraph "Sections (src/components/sections)" 
        direction TB
        Hero["Hero.tsx"]:::ui
        AboutSection["About.tsx"]:::ui
        ServicesSection["Services.tsx"]:::ui
        TeamSection["Team.tsx"]:::ui
        ChooseSection["Choose.tsx"]:::ui
        ContactsSection["Contacts.tsx"]:::ui
        FooterSection["Footer.tsx"]:::ui
    end

    %% UI Primitives
    subgraph "UI Primitives (src/components/ui)" 
        direction TB
        Navbar["Navbar.tsx"]:::ui
        MobileMenu["MobileMenu.tsx"]:::ui
        Modal["Modal.tsx"]:::ui
        GridList["GridList.tsx"]:::ui
        Slider["Slider.tsx"]:::ui
        TextComponent["TextComponent.tsx"]:::ui
        ServiceCard["ServiceCard.tsx"]:::ui
        AboutImage["AboutImage.tsx"]:::ui
        ContactForm["ContactForm.tsx"]:::ui
    end

    %% Data modules
    subgraph "Data Modules (src/data)" 
        direction TB
        DataForm["dataForm.ts"]:::static
        DataGallery["dataGallery.ts"]:::static
        DataLinks["dataLinks.ts"]:::static
        DataServices["dataServices.ts"]:::static
        DataTeam["dataTeam.ts"]:::static
    end

    %% Static assets
    Assets["public/assets/, icons/, images/"]:::static
    Styles["globals.css"]:::static

    %% Tooling & Config
    subgraph "Tooling & Build" 
        direction TB
        ESLint[".eslintrc.json"]:::tooling
        Prettier[".prettierrc"]:::tooling
        TSConfig["tsconfig.json"]:::tooling
        PostCSS["postcss.config.js"]:::tooling
        TailwindCfg["tailwind.config.ts"]:::tooling
        NextConfig["next.config.mjs"]:::tooling
    end

    %% Build pipeline to deployment
    ESLint & Prettier & TSConfig & PostCSS & TailwindCfg & NextConfig -->|"build & bundle"| Hosting

    %% Request/Render flow
    Browser -->|"HTTP Request"| Hosting
    Hosting -->|"SSG/SSR or Static"| NextServer
    NextServer -->|"Route to Page"| PageHome
    NextServer --> PageBlog
    NextServer --> PageGallery
    NextServer --> PageNotFound

    %% Composition flow
    PageHome -->|"uses Layout"| Layout
    PageBlog --> Layout
    PageGallery --> Layout
    PageNotFound --> Layout

    Layout -->|"composes Sections"| Hero
    Layout --> AboutSection
    Layout --> ServicesSection
    Layout --> TeamSection
    Layout --> ChooseSection
    Layout --> ContactsSection
    Layout --> FooterSection

    Hero --> Navbar
    Hero --> AboutImage

    AboutSection --> AboutImage
    ServicesSection --> ServiceCard
    ServicesSection --> GridList
    TeamSection --> GridList
    ChooseSection --> Slider
    ContactsSection --> ContactForm
    FooterSection --> TextComponent

    %% Data flow
    DataForm --> ContactForm
    DataGallery --> GridList
    DataLinks --> Navbar
    DataLinks --> FooterSection
    DataServices --> ServiceCard
    DataTeam --> TeamSection

    %% Assets and styles
    Assets -->|"served directly"| Browser
    Assets --> UI_Primitives
    Styles -->|"CSS Imported"| Layout

    %% Deployment
    NextServer -->|"deploy bundle"| Hosting
    Hosting --> Browser

    %% Click events
    click PageHome "https://github.com/viktorsvertoka/tattoo-studio/blob/main/src/app/page.tsx"
    click PageBlog "https://github.com/viktorsvertoka/tattoo-studio/blob/main/src/app/blog/page.tsx"
    click PageGallery "https://github.com/viktorsvertoka/tattoo-studio/blob/main/src/app/gallery/page.tsx"
    click PageNotFound "https://github.com/viktorsvertoka/tattoo-studio/blob/main/src/app/not-found.tsx"
    click Layout "https://github.com/viktorsvertoka/tattoo-studio/blob/main/src/app/layout.tsx"
    click Hero "https://github.com/viktorsvertoka/tattoo-studio/blob/main/src/components/sections/Hero.tsx"
    click AboutSection "https://github.com/viktorsvertoka/tattoo-studio/blob/main/src/components/sections/About.tsx"
    click ServicesSection "https://github.com/viktorsvertoka/tattoo-studio/blob/main/src/components/sections/Services.tsx"
    click TeamSection "https://github.com/viktorsvertoka/tattoo-studio/blob/main/src/components/sections/Team.tsx"
    click ChooseSection "https://github.com/viktorsvertoka/tattoo-studio/blob/main/src/components/sections/Choose.tsx"
    click ContactsSection "https://github.com/viktorsvertoka/tattoo-studio/blob/main/src/components/sections/Contacts.tsx"
    click FooterSection "https://github.com/viktorsvertoka/tattoo-studio/blob/main/src/components/sections/Footer.tsx"
    click Navbar "https://github.com/viktorsvertoka/tattoo-studio/blob/main/src/components/ui/Navbar.tsx"
    click MobileMenu "https://github.com/viktorsvertoka/tattoo-studio/blob/main/src/components/ui/MobileMenu.tsx"
    click Modal "https://github.com/viktorsvertoka/tattoo-studio/blob/main/src/components/ui/Modal.tsx"
    click GridList "https://github.com/viktorsvertoka/tattoo-studio/blob/main/src/components/ui/GridList.tsx"
    click Slider "https://github.com/viktorsvertoka/tattoo-studio/blob/main/src/components/ui/Slider.tsx"
    click TextComponent "https://github.com/viktorsvertoka/tattoo-studio/blob/main/src/components/ui/TextComponent.tsx"
    click ServiceCard "https://github.com/viktorsvertoka/tattoo-studio/blob/main/src/components/ui/ServiceCard.tsx"
    click AboutImage "https://github.com/viktorsvertoka/tattoo-studio/blob/main/src/components/ui/AboutImage.tsx"
    click ContactForm "https://github.com/viktorsvertoka/tattoo-studio/blob/main/src/components/ui/ContactForm.tsx"
    click DataForm "https://github.com/viktorsvertoka/tattoo-studio/blob/main/src/data/dataForm.ts"
    click DataGallery "https://github.com/viktorsvertoka/tattoo-studio/blob/main/src/data/dataGallery.ts"
    click DataLinks "https://github.com/viktorsvertoka/tattoo-studio/blob/main/src/data/dataLinks.ts"
    click DataServices "https://github.com/viktorsvertoka/tattoo-studio/blob/main/src/data/dataServices.ts"
    click DataTeam "https://github.com/viktorsvertoka/tattoo-studio/blob/main/src/data/dataTeam.ts"
    click Assets "https://github.com/viktorsvertoka/tattoo-studio/tree/main/public/assets/"
    click Styles "https://github.com/viktorsvertoka/tattoo-studio/blob/main/src/styles/globals.css"
    click ESLint "https://github.com/viktorsvertoka/tattoo-studio/blob/main/.eslintrc.json"
    click Prettier "https://github.com/viktorsvertoka/tattoo-studio/blob/main/.prettierrc"
    click TSConfig "https://github.com/viktorsvertoka/tattoo-studio/blob/main/tsconfig.json"
    click PostCSS "https://github.com/viktorsvertoka/tattoo-studio/blob/main/postcss.config.js"
    click TailwindCfg "https://github.com/viktorsvertoka/tattoo-studio/blob/main/tailwind.config.ts"
    click NextConfig "https://github.com/viktorsvertoka/tattoo-studio/blob/main/next.config.mjs"

    %% Styles
    classDef runtime fill:#D0E8FF,stroke:#333,stroke-width:1px
    classDef ui fill:#D4F8D4,stroke:#333,stroke-width:1px
    classDef static fill:#FFF4C1,stroke:#333,stroke-width:1px
    classDef tooling fill:#E0E0E0,stroke:#333,stroke-width:1px
    classDef external fill:#F0F0F0,stroke:#333,stroke-width:1px
```
