# karen1554/gart-gallery architecture

> Architecture diagram of the GitHub repository karen1554/gart-gallery, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-08-11). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/karen1554/gart-gallery
- Repository: https://github.com/karen1554/gart-gallery

## Overview

#### Purpose and entry points
This is a static artist/gallery website with a small Node-backed administration surface for managing gallery content and uploaded assets. Public entry points are `index.html`, `galleries.html`, `works.html`, and category-specific work pages such as `works-dogs.html` and `works-landscape.html`. The server entry point is `server.js`.

#### Public site layer
Public pages are conventional HTML documents styled and enhanced client-side:
- Shared presentation and general behavior: `assets/css/style.css`, `assets/js/script.js`
- Works/gallery-specific behavior: `assets/js/works.js`
- Public content pages: `index.html`, `galleries.html`, `works.html`

The public UI likely reads gallery metadata from a local data source rather than a database, creating a clear browser-to-static/HTTP-content boundary.

#### Gallery content store
Gallery records are centralized in `data/gallery.json`. This file is the material content boundary between administration and the public gallery renderer. Uploaded media is held under `uploads`, so gallery entries likely reference server-hosted image paths rather than embedding media in HTML.

Core paths:
- `data/gallery.json`
- `uploads`
- `assets/js/works.js`

#### Administration surface
`admin-dashboard.html` provides a separate management interface, with dedicated styling and JavaScript in `assets/css/admin-dashboard.css` and `assets/js/admin-dashboard.js`. Its architectural role is to create, update, or remove gallery metadata and coordinate media uploads through server endpoints exposed by `server.js`.

Core paths:
- `admin-dashboard.html`
- `assets/js/admin-dashboard.js`
- `server.js`

#### Server and persistence boundary
`server.js` is the runtime boundary for dynamic capabilities absent from static HTML: serving the site, exposing data-management APIs, handling uploads, and persisting changes to `data/gallery.json` and `uploads`. The application’s persistence model appears filesystem-based, with no database directory or migration layer present.

Core paths:
- `server.js`
- `data/gallery.json`
- `uploads`

#### Deployment and runtime
Node.js is the primary runtime, indicated by `package.json` and `package-lock.json`. `render.yaml` defines deployment configuration for Render, making Render the expected hosting/infrastructure target. Environment-dependent values are documented through `.env.example`; these likely support server configuration or administrative access and should remain outside committed source.

Core paths:
- `package.json`
- `render.yaml`
- `.env.example`

Main entry points: [`server.js`](https://github.com/karen1554/gart-gallery/blob/main/server.js) (Node server), [`index.html`](https://github.com/karen1554/gart-gallery/blob/main/index.html) (Public HTML pages), [`assets/js/admin-dashboard.js`](https://github.com/karen1554/gart-gallery/blob/main/assets/js/admin-dashboard.js) (Admin client), [`admin-dashboard.html`](https://github.com/karen1554/gart-gallery/blob/main/admin-dashboard.html) (Admin dashboard)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_public["Public site"]
  node_public_pages["Public HTML pages<br/>static pages<br/>[index.html]"]
  node_site_styles["Shared styles<br/>CSS<br/>[style.css]"]
  node_site_script["Shared browser behavior<br/>browser JS<br/>[script.js]"]
  node_works_client["Gallery renderer<br/>browser JS<br/>[works.js]"]
end

subgraph group_admin["Administration"]
  node_admin_page["Admin dashboard<br/>management UI"]
  node_admin_styles["Admin styles<br/>CSS"]
  node_admin_client["Admin client<br/>browser JS<br/>[admin-dashboard.js]"]
end

subgraph group_runtime["Node runtime &amp; hosting"]
  node_server{{"Node server<br/>HTTP runtime<br/>[server.js]"}}
  node_gallery_api["Gallery management API<br/>server handlers<br/>[server.js]"]
  node_upload_handler["Upload handler<br/>server handler<br/>[server.js]"]
  node_package["Node dependencies<br/>package manifest<br/>[package.json]"]
  node_render["Render deployment<br/>hosting config<br/>[render.yaml]"]
  node_env_example["Environment contract<br/>environment template<br/>[.env.example]"]
end

node_gallery_data[("Gallery metadata<br/>JSON content store<br/>[gallery.json]")]
node_uploads[("Uploaded media<br/>file storage")]

node_public_pages -->|"styles"| node_site_styles
node_public_pages -->|"enhances"| node_site_script
node_public_pages -->|"gallery pages use"| node_works_client
node_works_client -->|"requests content"| node_server
node_server -->|"serves records"| node_gallery_data
node_server -->|"serves media"| node_uploads
node_admin_page -->|"styles"| node_admin_styles
node_admin_page -->|"runs"| node_admin_client
node_admin_client -->|"manages records"| node_gallery_api
node_admin_client -->|"uploads media"| node_upload_handler
node_gallery_api -->|"reads and writes"| node_gallery_data
node_upload_handler -->|"writes files"| node_uploads
node_server -->|"routes requests"| node_gallery_api
node_server -->|"routes uploads"| node_upload_handler
node_package -->|"runs"| node_server
node_render -->|"deploys"| node_server
node_env_example -.->|"configures"| node_server

click node_public_pages "https://github.com/karen1554/gart-gallery/blob/main/index.html"
click node_site_styles "https://github.com/karen1554/gart-gallery/blob/main/assets/css/style.css"
click node_site_script "https://github.com/karen1554/gart-gallery/blob/main/assets/js/script.js"
click node_works_client "https://github.com/karen1554/gart-gallery/blob/main/assets/js/works.js"
click node_admin_page "https://github.com/karen1554/gart-gallery/blob/main/admin-dashboard.html"
click node_admin_styles "https://github.com/karen1554/gart-gallery/blob/main/assets/css/admin-dashboard.css"
click node_admin_client "https://github.com/karen1554/gart-gallery/blob/main/assets/js/admin-dashboard.js"
click node_server "https://github.com/karen1554/gart-gallery/blob/main/server.js"
click node_gallery_api "https://github.com/karen1554/gart-gallery/blob/main/server.js"
click node_upload_handler "https://github.com/karen1554/gart-gallery/blob/main/server.js"
click node_gallery_data "https://github.com/karen1554/gart-gallery/blob/main/data/gallery.json"
click node_uploads "https://github.com/karen1554/gart-gallery/tree/main/uploads"
click node_package "https://github.com/karen1554/gart-gallery/blob/main/package.json"
click node_render "https://github.com/karen1554/gart-gallery/blob/main/render.yaml"
click node_env_example "https://github.com/karen1554/gart-gallery/blob/main/.env.example"

classDef toneNeutral fill:#f8fafc,stroke:#334155,stroke-width:1.5px,color:#0f172a
classDef toneBlue fill:#dbeafe,stroke:#2563eb,stroke-width:1.5px,color:#172554
classDef toneAmber fill:#fef3c7,stroke:#d97706,stroke-width:1.5px,color:#78350f
classDef toneMint fill:#dcfce7,stroke:#16a34a,stroke-width:1.5px,color:#14532d
classDef toneRose fill:#ffe4e6,stroke:#e11d48,stroke-width:1.5px,color:#881337
classDef toneIndigo fill:#e0e7ff,stroke:#4f46e5,stroke-width:1.5px,color:#312e81
classDef toneTeal fill:#ccfbf1,stroke:#0f766e,stroke-width:1.5px,color:#134e4a
class node_public_pages,node_site_styles,node_site_script,node_works_client toneBlue
class node_admin_page,node_admin_styles,node_admin_client toneAmber
class node_server,node_gallery_api,node_upload_handler,node_package,node_render,node_env_example toneMint
class node_gallery_data,node_uploads toneNeutral
```

## Components

### Public site

- [Public HTML pages](https://github.com/karen1554/gart-gallery/blob/main/index.html): static pages · Home, galleries, works, and category pages. · `index.html`
- [Shared styles](https://github.com/karen1554/gart-gallery/blob/main/assets/css/style.css): CSS · `assets/css/style.css`
- [Shared browser behavior](https://github.com/karen1554/gart-gallery/blob/main/assets/js/script.js): browser JS · `assets/js/script.js`
- [Gallery renderer](https://github.com/karen1554/gart-gallery/blob/main/assets/js/works.js): browser JS · Loads and renders gallery content. · `assets/js/works.js`

### Administration

- [Admin dashboard](https://github.com/karen1554/gart-gallery/blob/main/admin-dashboard.html): management UI · `admin-dashboard.html`
- [Admin styles](https://github.com/karen1554/gart-gallery/blob/main/assets/css/admin-dashboard.css): CSS · `assets/css/admin-dashboard.css`
- [Admin client](https://github.com/karen1554/gart-gallery/blob/main/assets/js/admin-dashboard.js): browser JS · Coordinates gallery edits and media uploads. · `assets/js/admin-dashboard.js`

### Node runtime & hosting

- [Node server](https://github.com/karen1554/gart-gallery/blob/main/server.js): HTTP runtime · Serves static content and dynamic management capabilities. · `server.js`
- [Gallery management API](https://github.com/karen1554/gart-gallery/blob/main/server.js): server handlers · Creates, updates, and removes gallery metadata. · `server.js`
- [Upload handler](https://github.com/karen1554/gart-gallery/blob/main/server.js): server handler · Accepts and stores uploaded media. · `server.js`
- [Node dependencies](https://github.com/karen1554/gart-gallery/blob/main/package.json): package manifest · `package.json`
- [Render deployment](https://github.com/karen1554/gart-gallery/blob/main/render.yaml): hosting config · `render.yaml`
- [Environment contract](https://github.com/karen1554/gart-gallery/blob/main/.env.example): environment template · Documents deployment-dependent server or admin values. · `.env.example`

### Other components

- [Gallery metadata](https://github.com/karen1554/gart-gallery/blob/main/data/gallery.json): JSON content store · Filesystem-backed gallery records shared by admin and public rendering. · `data/gallery.json`
- [Uploaded media](https://github.com/karen1554/gart-gallery/tree/main/uploads): file storage · Server-hosted image assets referenced by gallery records. · `uploads`

## Connections

- Public HTML pages → Shared styles: styles
- Public HTML pages → Shared browser behavior: enhances
- Public HTML pages → Gallery renderer: gallery pages use
- Gallery renderer → Node server: requests content
- Node server → Gallery metadata: serves records
- Node server → Uploaded media: serves media
- Admin dashboard → Admin styles: styles
- Admin dashboard → Admin client: runs
- Admin client → Gallery management API: manages records
- Admin client → Upload handler: uploads media
- Gallery management API → Gallery metadata: reads and writes
- Upload handler → Uploaded media: writes files
- Node server → Gallery management API: routes requests
- Node server → Upload handler: routes uploads
- Node dependencies → Node server: runs
- Render deployment → Node server: deploys
- Environment contract → Node server: configures
