# anaderwan/ctk-shop architecture

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

- Interactive diagram: https://gitdiagram.com/anaderwan/ctk-shop
- Repository: https://github.com/anaderwan/ctk-shop

## Overview

##### Project type and purpose
- CTK SHOP is a single-page, full-stack web application (React + TypeScript) that manages user authentication, stores, and items.
- It uses json-server (db.json) as a mock REST API backend and Vite as the build/dev tool.

##### File structure
- Top-level:
- index.html, package.json, vite.config.ts, tsconfig.* → build & config
- db.json → mock data store for json-server
- public/ → static assets
- src/ → application code
- src/main.tsx and src/App.tsx → entrypoint, routing, global layout
- src/components/ → domain feature subfolders:
- authentication/ → Login, Register
- items/ (and Items-folder) → CreateItem, ItemCard, ItemForm, ItemsList, ItemsType
- store/ → CreateStore, StoreCard, StoreForm, StoresList
- navbar-and-footer/ → navbar, footer
- toaster/ → error messages
- SCSS/CSS assets alongside components; Axios and React Router imported in code.

##### README for additional insights
- Tech stack: React, TypeScript, Bulma, SCSS, Axios, React Router, json-server.
- Features: user register/login, CRUD for stores&items.

##### Detail
- React Router as an overlay around the feature modules.

## Diagram (Mermaid)

```mermaid
flowchart TD
    %% Browser and Dev Server
    Browser["Browser"]:::external
    Vite["Vite Dev Server"]:::tool
    Browser -->|"GET index.html & bundles"| Vite

    %% Frontend SPA
    subgraph "Frontend SPA"
        %% Entry & Routing
        subgraph "Entry & Routing"
            Main["main.tsx"]:::frontend
            App["App.tsx"]:::frontend
        end

        %% React Router Shell
        subgraph "Routing (React Router)"
            %% Authentication Module
            subgraph "Authentication Module"
                Login["Login.tsx"]:::frontend
                Login2["Login2.tsx"]:::frontend
                Register["Register.tsx"]:::frontend
                LoginSCSS["login.scss"]:::frontend
            end
            %% Store Module
            subgraph "Store Module"
                CreateStore["Create-store.tsx"]:::frontend
                StoreCard["Store-card.tsx"]:::frontend
                StoreForm["Store-form.tsx"]:::frontend
                StoresList["Stores-list.tsx"]:::frontend
            end
            %% Item Module
            subgraph "Item Module"
                CreateItem["Create-item.tsx"]:::frontend
                ItemCard["Item-card.tsx"]:::frontend
                ItemForm["Item-form.tsx"]:::frontend
                ItemsList["Items-list.tsx"]:::frontend
                ItemsType["Items-type.tsx"]:::frontend
            end
            %% Layout Module
            subgraph "Layout (Navbar & Footer)"
                Navbar["Navbar.tsx"]:::frontend
                NavbarSCSS["navbar.scss"]:::frontend
                Footer["Footer.tsx"]:::frontend
                FooterSCSS["footer.scss"]:::frontend
            end
            %% Toaster Module
            subgraph "Toaster"
                ErrorMessage["ErrorMessage.tsx"]:::frontend
                ErrorSCSS["errorMessage.scss"]:::frontend
            end
        end

        %% HTTP Client
        Axios["Axios HTTP Client"]:::backend
    end

    %% Mock Backend
    subgraph "Mock API Backend"
        JSONServer["json-server (REST API)"]:::backend
        DB["db.json"]:::storage
    end

    %% Data Flow
    Login -->|"/login"| Axios
    CreateStore -->|"POST /stores"| Axios
    CreateItem -->|"POST /items"| Axios
    Navbar -->|"GET /users"| Axios
    ErrorMessage -->|"Error Handling"| Axios
    Axios -->|Calls REST endpoints| JSONServer
    JSONServer -->|Reads/Writes| DB

    %% Click Events
    click Main "https://github.com/anaderwan/ctk-shop/blob/main/src/main.tsx"
    click App "https://github.com/anaderwan/ctk-shop/blob/main/src/App.tsx"
    click Login "https://github.com/anaderwan/ctk-shop/blob/main/src/components/authentication/Login.tsx"
    click Login2 "https://github.com/anaderwan/ctk-shop/blob/main/src/components/authentication/Login2.tsx"
    click Register "https://github.com/anaderwan/ctk-shop/blob/main/src/components/authentication/Register.tsx"
    click LoginSCSS "https://github.com/anaderwan/ctk-shop/blob/main/src/components/authentication/login.scss"
    click CreateStore "https://github.com/anaderwan/ctk-shop/blob/main/src/components/store/Create-store.tsx"
    click StoreCard "https://github.com/anaderwan/ctk-shop/blob/main/src/components/store/Store-card.tsx"
    click StoreForm "https://github.com/anaderwan/ctk-shop/blob/main/src/components/store/Store-form.tsx"
    click StoresList "https://github.com/anaderwan/ctk-shop/blob/main/src/components/store/Stores-list.tsx"
    click CreateItem "https://github.com/anaderwan/ctk-shop/blob/main/src/components/items/Create-item.tsx"
    click ItemCard "https://github.com/anaderwan/ctk-shop/blob/main/src/components/items/Item-card.tsx"
    click ItemForm "https://github.com/anaderwan/ctk-shop/blob/main/src/components/items/Item-form.tsx"
    click ItemsList "https://github.com/anaderwan/ctk-shop/blob/main/src/components/items/Items-list.tsx"
    click ItemsType "https://github.com/anaderwan/ctk-shop/blob/main/src/components/items/Items-type.tsx"
    click Navbar "https://github.com/anaderwan/ctk-shop/blob/main/src/components/navbar-and-footer/Navbar.tsx"
    click NavbarSCSS "https://github.com/anaderwan/ctk-shop/blob/main/src/components/navbar-and-footer/navbar.scss"
    click Footer "https://github.com/anaderwan/ctk-shop/blob/main/src/components/navbar-and-footer/Footer.tsx"
    click FooterSCSS "https://github.com/anaderwan/ctk-shop/blob/main/src/components/navbar-and-footer/footer.scss"
    click ErrorMessage "https://github.com/anaderwan/ctk-shop/blob/main/src/components/toaster/ErrorMessage.tsx"
    click ErrorSCSS "https://github.com/anaderwan/ctk-shop/blob/main/src/components/toaster/errorMessage.scss"
    click JSONServer "https://github.com/anaderwan/ctk-shop/blob/main/db.json"
    click Vite "https://github.com/anaderwan/ctk-shop/blob/main/vite.config.ts"
    click Browser "https://github.com/anaderwan/ctk-shop/blob/main/index.html"

    %% Styles
    classDef frontend fill:#D0E8FF,stroke:#0366d6,color:#0366d6
    classDef backend fill:#E6FFEA,stroke:#28A745,color:#28A745
    classDef storage fill:#FFF4E5,stroke:#D97706,color:#D97706
    classDef tool fill:#F0F0F0,stroke:#6c757d,color:#6c757d
    classDef external fill:#F5F5F5,stroke:#333, color:#333
```
