# kingsdigitallab/kings-past architecture

> Architecture diagram of the GitHub repository kingsdigitallab/kings-past, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2025-01-13). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/kingsdigitallab/kings-past
- Repository: https://github.com/kingsdigitallab/kings-past

## Overview

##### Main System Components

a) Frontend Layer
- SvelteKit Application
- Routes & Pages
- Components
- Static Assets
- Search Functionality (Pagefind)

b) Data Layer
- Supabase (PostgreSQL)
- Content Management
- Markdown Files
- Frontmatter
- Schema.org Data Models

c) Integration Layer
- API Endpoints
- Database Clients
- External Services

##### Component Relationships

a) Frontend Architecture (Top Layer):
**[Client Browser] → [SvelteKit App]**
- [Static Pages]
- [Dynamic Routes]
- [Components]
- [Search Index]

b) Data Flow Architecture (Middle Layer):
**[Markdown Content] ←→ [SvelteKit SSG] ←→ [Supabase]**
- ↓
- [Static Assets]

c) Database Architecture (Bottom Layer):
**[Supabase PostgreSQL]**
- [People]
- [Organizations]
- [Places]
- [Events]
- [Donations]
- [Moments]
- [Themes]

##### Specific Implementation Details

- Blue Rectangles: Core Components
- Green Rectangles: Data Stores
- Yellow Diamonds: Integration Points
- Red Hexagons: External Services
- Purple Circles: Static Assets

##### Key Relationships to Highlight

- Static site generation process
- Demonstrate the search functionality flow
- How the MapLibre GL integration works with place data

##### Technical Stack Indicators

Technology badges or labels for:
- SvelteKit
- Supabase
- MapLibre GL
- Pagefind
- Schema.org
- Mdsvex

##### Data Flow Patterns

- Content generation flow
- API request patterns
- Search query flow
- Data integration
- Static asset delivery

## Diagram (Mermaid)

```mermaid
graph TB
    subgraph Client
        Browser["Web Browser"]
    end

    subgraph Frontend
        SK["SvelteKit App"]:::core
        Routes["Routes & Pages"]:::frontend
        Components["UI Components"]:::frontend
        Assets["Static Assets"]:::assets
        Search["Search System"]:::frontend
        Map["Map Component"]:::frontend
        Entity["Entity Components"]:::frontend
        Layout["Layout Components"]:::frontend
        Styles["Core Styling"]:::frontend
    end

    subgraph Data
        DB[(Supabase DB)]:::database
        Schema["Database Schema"]:::database
        Types["Database Types"]:::database
        Migrations["DB Migrations"]:::database
        DBClient["Database Client"]:::integration
    end

    subgraph Content
        CMS["Content Management"]:::cms
        Templates["Content Templates"]:::cms
        Markdown["Markdown Files"]:::cms
    end

    subgraph API
        Endpoints["/api Endpoints"]:::api
    end

    %% Relationships
    Browser --> SK
    SK --> Routes
    SK --> Components
    SK --> Assets
    SK --> Search
    SK --> Map
    SK --> Entity
    SK --> Layout
    SK --> Styles

    Components --> DBClient
    Routes --> DBClient
    DBClient --> DB
    DB --> Schema
    DB --> Types
    DB --> Migrations

    SK --> Endpoints
    Endpoints --> DBClient

    CMS --> Templates
    CMS --> Markdown
    Markdown --> SK

    %% Click Events
    click Routes "https://github.com/kingsdigitallab/kings-past/tree/main/src/routes/"
    click Components "https://github.com/kingsdigitallab/kings-past/tree/main/src/lib/components/"
    click Assets "https://github.com/kingsdigitallab/kings-past/tree/main/src/lib/assets/"
    click Search "https://github.com/kingsdigitallab/kings-past/tree/main/src/routes/search/"
    click Schema "https://github.com/kingsdigitallab/kings-past/blob/main/supabase/schema.sql"
    click DBClient "https://github.com/kingsdigitallab/kings-past/tree/main/src/lib/supabase/"
    click Endpoints "https://github.com/kingsdigitallab/kings-past/tree/main/src/routes/api/"
    click Markdown "https://github.com/kingsdigitallab/kings-past/tree/main/src/moments/"
    click Layout "https://github.com/kingsdigitallab/kings-past/tree/main/src/lib/layouts/"
    click Types "https://github.com/kingsdigitallab/kings-past/blob/main/src/lib/supabase/types.ts"
    click Map "https://github.com/kingsdigitallab/kings-past/blob/main/src/lib/components/PlacesMap.svelte"
    click Entity "https://github.com/kingsdigitallab/kings-past/blob/main/src/lib/components/EntityDetails.svelte"
    click Templates "https://github.com/kingsdigitallab/kings-past/tree/main/.frontmatter/templates/"
    click Migrations "https://github.com/kingsdigitallab/kings-past/blob/main/supabase/seed.sql"
    click Styles "https://github.com/kingsdigitallab/kings-past/blob/main/src/lib/assets/stylesheets/app.css"

    %% Styles
    classDef core fill:#2563eb,color:white
    classDef frontend fill:#3b82f6,color:white
    classDef database fill:#059669,color:white
    classDef integration fill:#ca8a04,color:white
    classDef api fill:#dc2626,color:white
    classDef cms fill:#7c3aed,color:white
    classDef assets fill:#0891b2,color:white

    %% Legend
    subgraph Legend
        L1["Core System"]:::core
        L2["Frontend Components"]:::frontend
        L3["Database"]:::database
        L4["Integration"]:::integration
        L5["API"]:::api
        L6["CMS"]:::cms
        L7["Assets"]:::assets
    end
```
