# marc0val/mypixelartsii architecture

> Architecture diagram of the GitHub repository marc0val/mypixelartsii, 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/marc0val/mypixelartsii
- Repository: https://github.com/marc0val/mypixelartsii

## Overview

##### Project type and purpose
- This is a full-stack single-page application called “MyPixelArtsII.”

##### File structure
- Top-level folders:
- backend – Express app (server.js, config, controllers, models, routes, middlewares, utils)
- frontend – Vite/React SPA (components, services (API calls), stores (state management), types)
- Build & config files:
- backend/.env.example, package.json, config/db.js
- frontend/vite.config.ts, tsconfig, postcss.config.js, tailwind.config.js
- Patterns:
- Backend follows MVC: Routes → Controllers (business logic) → Models (data layer)
- Frontend has a clear separation of UI components, service layer (canvasService, colorService, pixelService), and global state stores (canvasStore, colorsStore, pixelsStore, uiStore, userStore).

##### README for additional insights
- Minimal description: evolution of the prior My Pixel Arts system.

## Diagram (Mermaid)

```mermaid
flowchart TB
    User["User Browser"]:::external
    User -->|"loads"| FEApp["React SPA"]:::frontend

    subgraph "Frontend Application"
        direction TB
        FEApp --> UIComponents["UI Components"]:::frontend
        UIComponents --> StateStores["State Stores"]:::frontend
        StateStores --> Services["Service/API Layer"]:::frontend
    end

    subgraph "UI Components"
        direction TB
        Canvas["Canvas"]:::frontend
        ColorPalette["Color Palette"]:::frontend
        AdminPanel["Admin Panel"]:::frontend
        LoginPanel["Login Panel"]:::frontend
        HelpPanel["Help Panel"]:::frontend
        ScreenshotButton["Screenshot Button"]:::frontend
        ZoomControls["Zoom Controls"]:::frontend
        ThemeToggle["Theme Toggle"]:::frontend
        ContactButton["Contact Button"]:::frontend
        SocialLinks["Social Links"]:::frontend
    end
    UIComponents --> Canvas
    UIComponents --> ColorPalette
    UIComponents --> AdminPanel
    UIComponents --> LoginPanel
    UIComponents --> HelpPanel
    UIComponents --> ScreenshotButton
    UIComponents --> ZoomControls
    UIComponents --> ThemeToggle
    UIComponents --> ContactButton
    UIComponents --> SocialLinks

    subgraph "State Stores"
        direction TB
        CanvasStore["Canvas Store"]:::frontend
        ColorsStore["Colors Store"]:::frontend
        PixelsStore["Pixels Store"]:::frontend
        UIStore["UI Store"]:::frontend
        UserStore["User Store"]:::frontend
    end
    StateStores --> CanvasStore
    StateStores --> ColorsStore
    StateStores --> PixelsStore
    StateStores --> UIStore
    StateStores --> UserStore

    subgraph "Service/API Layer"
        direction TB
        APIBase["API Base (api.ts)"]:::frontend
        CanvasService["Canvas Service"]:::frontend
        ColorService["Color Service"]:::frontend
        PixelService["Pixel Service"]:::frontend
    end
    Services --> APIBase
    Services --> CanvasService
    Services --> ColorService
    Services --> PixelService

    Services -->|"HTTP Requests"| ExpressServer["Express API"]:::backend

    subgraph "Backend API Server"
        direction TB
        ExpressServer["Express Server (server.js)"]:::backend
        ExpressServer --> Routes["Routing Layer"]:::backend
        Routes --> AuthRoutes["Auth Routes"]:::backend
        Routes --> CanvasRoutes["Canvas Routes"]:::backend
        Routes --> ColorRoutes["Color Routes"]:::backend
        Routes --> PixelRoutes["Pixel Routes"]:::backend
        Routes --> AuthMW["Authentication Middleware"]:::backend
        AuthMW --> Controllers["Controller Layer"]:::backend
        Controllers --> AuthController["Auth Controller"]:::backend
        Controllers --> CanvasController["Canvas Controller"]:::backend
        Controllers --> ColorController["Color Controller"]:::backend
        Controllers --> PixelController["Pixel Controller"]:::backend
        Controllers --> Utils["Utilities (Initial Scripts)"]:::util
        Utils --> CreateAdmin["Create Admin Script"]:::util
        Utils --> PopulateColors["Populate Colors Script"]:::util
        Controllers --> Models["Data Layer (Mongoose Models)"]:::backend
        Models --> AdminModel["Admin Model"]:::backend
        Models --> CanvasConfigModel["CanvasConfig Model"]:::backend
        Models --> ColorModel["Color Model"]:::backend
        Models --> PixelModel["Pixel Model"]:::backend
    end

    Models --> DB["MongoDB"]:::data

    classDef frontend fill:#fdf6e3,stroke:#657b83,stroke-width:1px
    classDef backend fill:#eee8d5,stroke:#586e75,stroke-width:1px
    classDef data fill:#d33682,stroke:#b58900,stroke-width:1px,stroke-dasharray: 5 5
    classDef util fill:#cb4b16,stroke:#859900,stroke-width:1px,stroke-dasharray: 2 2
    classDef external fill:#93a1a1,stroke:#073642,stroke-width:1px

    click FEApp "https://github.com/marc0val/mypixelartsii/blob/main/frontend/src/main.tsx"
    click FEApp "https://github.com/marc0val/mypixelartsii/blob/main/frontend/src/App.tsx"
    click Canvas "https://github.com/marc0val/mypixelartsii/blob/main/frontend/src/components/Canvas.tsx"
    click ColorPalette "https://github.com/marc0val/mypixelartsii/blob/main/frontend/src/components/ColorPalette.tsx"
    click AdminPanel "https://github.com/marc0val/mypixelartsii/blob/main/frontend/src/components/AdminPanel.tsx"
    click LoginPanel "https://github.com/marc0val/mypixelartsii/blob/main/frontend/src/components/LoginPanel.tsx"
    click HelpPanel "https://github.com/marc0val/mypixelartsii/blob/main/frontend/src/components/HelpPanel.tsx"
    click ScreenshotButton "https://github.com/marc0val/mypixelartsii/blob/main/frontend/src/components/ScreenshotButton.tsx"
    click ZoomControls "https://github.com/marc0val/mypixelartsii/blob/main/frontend/src/components/ZoomControls.tsx"
    click ThemeToggle "https://github.com/marc0val/mypixelartsii/blob/main/frontend/src/components/ThemeToggle.tsx"
    click ContactButton "https://github.com/marc0val/mypixelartsii/blob/main/frontend/src/components/ContactButton.tsx"
    click SocialLinks "https://github.com/marc0val/mypixelartsii/blob/main/frontend/src/components/SocialLinks.tsx"
    click CanvasStore "https://github.com/marc0val/mypixelartsii/blob/main/frontend/src/stores/canvasSrore.ts"
    click ColorsStore "https://github.com/marc0val/mypixelartsii/blob/main/frontend/src/stores/colorsStore.ts"
    click PixelsStore "https://github.com/marc0val/mypixelartsii/blob/main/frontend/src/stores/pixelsStore.ts"
    click UIStore "https://github.com/marc0val/mypixelartsii/blob/main/frontend/src/stores/uiStore.ts"
    click UserStore "https://github.com/marc0val/mypixelartsii/blob/main/frontend/src/stores/userStore.ts"
    click APIBase "https://github.com/marc0val/mypixelartsii/blob/main/frontend/src/services/api.ts"
    click CanvasService "https://github.com/marc0val/mypixelartsii/blob/main/frontend/src/services/canvasServices.ts"
    click ColorService "https://github.com/marc0val/mypixelartsii/blob/main/frontend/src/services/colorService.ts"
    click PixelService "https://github.com/marc0val/mypixelartsii/blob/main/frontend/src/services/pixelService.ts"
    click ExpressServer "https://github.com/marc0val/mypixelartsii/blob/main/backend/server.js"
    click AuthRoutes "https://github.com/marc0val/mypixelartsii/blob/main/backend/routes/authRoutes.js"
    click CanvasRoutes "https://github.com/marc0val/mypixelartsii/blob/main/backend/routes/canvasRouter.js"
    click ColorRoutes "https://github.com/marc0val/mypixelartsii/blob/main/backend/routes/colorRoutes.js"
    click PixelRoutes "https://github.com/marc0val/mypixelartsii/blob/main/backend/routes/pixelRouter.js"
    click AuthMW "https://github.com/marc0val/mypixelartsii/blob/main/backend/middlewares/authMiddleware.js"
    click AuthController "https://github.com/marc0val/mypixelartsii/blob/main/backend/controllers/authController.js"
    click CanvasController "https://github.com/marc0val/mypixelartsii/blob/main/backend/controllers/canvasController.js"
    click ColorController "https://github.com/marc0val/mypixelartsii/blob/main/backend/controllers/colorController.js"
    click PixelController "https://github.com/marc0val/mypixelartsii/blob/main/backend/controllers/pixelController.js"
    click AdminModel "https://github.com/marc0val/mypixelartsii/blob/main/backend/models/Admin.js"
    click CanvasConfigModel "https://github.com/marc0val/mypixelartsii/blob/main/backend/models/CanvasConfig.js"
    click ColorModel "https://github.com/marc0val/mypixelartsii/blob/main/backend/models/Color.js"
    click PixelModel "https://github.com/marc0val/mypixelartsii/blob/main/backend/models/Pixel.js"
    click CreateAdmin "https://github.com/marc0val/mypixelartsii/blob/main/backend/utils/createAdmin.js"
    click PopulateColors "https://github.com/marc0val/mypixelartsii/blob/main/backend/utils/populateColors.js"
```
