# suspect147/compass architecture

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

- Interactive diagram: https://gitdiagram.com/suspect147/compass
- Repository: https://github.com/suspect147/compass

## Overview

Compass is a browser-based map editor and skin studio for creating, styling, exporting, and sharing community maps. The main workflow is to edit a layered map, render or export it, then save it or publish it for others to browse. Separate product branches support custom tile-pack creation and marketplace browsing, map discovery and account archives, and forum discussion. The graph reflects documented capabilities even where implementation excerpts were not provided; those subsystems and relationships are labeled only where evidence supports them.

Main entry points: [`src/editor/MapEditor.ts`](https://github.com/suspect147/compass/blob/main/src/editor/MapEditor.ts) (Editor Controller), [`src/core/supabase-client.ts`](https://github.com/suspect147/compass/blob/main/src/core/supabase-client.ts) (Supabase Client), [`src/utils/canvas-drawer.ts`](https://github.com/suspect147/compass/blob/main/src/utils/canvas-drawer.ts) (PNG Export), [`src/pages/view.ts`](https://github.com/suspect147/compass/blob/main/src/pages/view.ts) (Map Viewing & Sharing)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_editing["Map Editing"]
  node_map_editor["Editor Controller<br/>[MapEditor.ts]"]
  node_editor_config["Editor Definitions<br/>[editor-config.ts]"]
  node_map_data["Layered Map Data<br/>[MapData.ts]"]
  node_input["Editor Input<br/>[Input.ts]"]
  node_viewport["Viewport Controls<br/>[Viewport.ts]"]
  node_history["Edit History<br/>[History.ts]"]
  node_validator["Map Validation<br/>[Validator.ts]"]
  node_asset_loader["Asset Loading<br/>[AssetLoader.ts]"]
  node_renderer["Canvas Renderer<br/>[Renderer.ts]"]
  node_fence_tiler["Fence Auto-Tiling"]
  node_map_io["Map Persistence<br/>[IO.ts]"]
  node_exporter["PNG Export<br/>[canvas-drawer.ts]"]
  node_sharpness["Export Sharpening<br/>[sharpness-modal.ts]"]
end

subgraph group_community["Maps &amp; Community"]
  node_explore["Map Gallery<br/>[explore.ts]"]
  node_dashboard["Private Vault<br/>[dashboard.ts]"]
  node_view_share["Map Viewing &amp; Sharing<br/>[view.ts]"]
  node_forum["Community Forum<br/>[forum.ts]"]
end

subgraph group_skins["Tile Skins"]
  node_tile_studio["Custom Tile Studio<br/>[custom-tiles.ts]"]
end

subgraph group_platform["Shared Platform"]
  node_auth["Authentication &amp; Themes<br/>[auth-global.ts]"]
  node_supabase_client["Supabase Client<br/>[supabase-client.ts]"]
  node_map_assets["Map &amp; Tile Assets"]
end

node_creator(("Map Creator"))
node_supabase[("Supabase Services")]

node_creator -->|"edits maps"| node_map_editor
node_map_editor -->|"uses definitions"| node_editor_config
node_map_editor -->|"uses map data"| node_map_data
node_map_editor -->|"handles input"| node_input
node_map_editor -->|"controls viewport"| node_viewport
node_map_editor -->|"records edits"| node_history
node_map_editor -->|"validates maps"| node_validator
node_map_editor -->|"loads assets"| node_asset_loader
node_map_editor -->|"renders map"| node_renderer
node_map_editor -->|"auto-tiles fences"| node_fence_tiler
node_map_editor -->|"loads and saves"| node_map_io
node_map_editor -->|"uses client"| node_supabase_client
node_map_editor -.->|"loads map assets"| node_map_assets
node_map_editor -.->|"supports export"| node_exporter
node_exporter -->|"renders preview"| node_map_editor
node_map_io -->|"persists maps"| node_supabase_client
node_map_io -->|"offers sharpening"| node_sharpness
node_explore -->|"loads community maps"| node_supabase_client
node_explore -->|"renders previews"| node_exporter
node_dashboard -->|"loads map archive"| node_supabase_client
node_dashboard -->|"renders previews"| node_exporter
node_view_share -->|"loads shared maps"| node_supabase_client
node_view_share -->|"renders maps"| node_exporter
node_view_share -->|"offers sharpening"| node_sharpness
node_forum -->|"uses backend"| node_supabase_client
node_tile_studio -->|"publishes tile packs"| node_supabase_client
node_tile_studio -->|"uses tile presets"| node_map_assets
node_auth -->|"authenticates users"| node_supabase_client
node_auth -.->|"uses auth services"| node_supabase
node_supabase_client -->|"connects to"| node_supabase

click node_map_editor "https://github.com/suspect147/compass/blob/main/src/editor/MapEditor.ts"
click node_editor_config "https://github.com/suspect147/compass/blob/main/src/editor/editor-config.ts"
click node_map_data "https://github.com/suspect147/compass/blob/main/src/editor/engine/MapData.ts"
click node_input "https://github.com/suspect147/compass/blob/main/src/editor/engine/Input.ts"
click node_viewport "https://github.com/suspect147/compass/blob/main/src/editor/engine/Viewport.ts"
click node_history "https://github.com/suspect147/compass/blob/main/src/editor/engine/History.ts"
click node_validator "https://github.com/suspect147/compass/blob/main/src/editor/engine/Validator.ts"
click node_asset_loader "https://github.com/suspect147/compass/blob/main/src/editor/engine/AssetLoader.ts"
click node_renderer "https://github.com/suspect147/compass/blob/main/src/editor/engine/Renderer.ts"
click node_fence_tiler "https://github.com/suspect147/compass/blob/main/src/utils/fence-auto-tiler.ts"
click node_map_io "https://github.com/suspect147/compass/blob/main/src/editor/engine/IO.ts"
click node_exporter "https://github.com/suspect147/compass/blob/main/src/utils/canvas-drawer.ts"
click node_sharpness "https://github.com/suspect147/compass/blob/main/src/core/sharpness-modal.ts"
click node_explore "https://github.com/suspect147/compass/blob/main/src/pages/explore.ts"
click node_dashboard "https://github.com/suspect147/compass/blob/main/src/pages/dashboard.ts"
click node_view_share "https://github.com/suspect147/compass/blob/main/src/pages/view.ts"
click node_forum "https://github.com/suspect147/compass/blob/main/src/pages/forum.ts"
click node_tile_studio "https://github.com/suspect147/compass/blob/main/src/pages/custom-tiles.ts"
click node_auth "https://github.com/suspect147/compass/blob/main/src/core/auth-global.ts"
click node_supabase_client "https://github.com/suspect147/compass/blob/main/src/core/supabase-client.ts"
click node_map_assets "https://github.com/suspect147/compass/tree/main/Resources"

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_map_editor,node_editor_config,node_map_data,node_input,node_viewport,node_history,node_validator,node_asset_loader,node_renderer,node_fence_tiler,node_map_io,node_exporter,node_sharpness toneBlue
class node_explore,node_dashboard,node_view_share,node_forum,node_supabase toneAmber
class node_tile_studio toneMint
class node_auth,node_supabase_client,node_map_assets toneRose
class node_creator toneIndigo
```

## Components

### Map Editing

- [Editor Controller](https://github.com/suspect147/compass/blob/main/src/editor/MapEditor.ts): `src/editor/MapEditor.ts`
- [Editor Definitions](https://github.com/suspect147/compass/blob/main/src/editor/editor-config.ts): `src/editor/editor-config.ts`
- [Layered Map Data](https://github.com/suspect147/compass/blob/main/src/editor/engine/MapData.ts): `src/editor/engine/MapData.ts`
- [Editor Input](https://github.com/suspect147/compass/blob/main/src/editor/engine/Input.ts): `src/editor/engine/Input.ts`
- [Viewport Controls](https://github.com/suspect147/compass/blob/main/src/editor/engine/Viewport.ts): `src/editor/engine/Viewport.ts`
- [Edit History](https://github.com/suspect147/compass/blob/main/src/editor/engine/History.ts): `src/editor/engine/History.ts`
- [Map Validation](https://github.com/suspect147/compass/blob/main/src/editor/engine/Validator.ts): `src/editor/engine/Validator.ts`
- [Asset Loading](https://github.com/suspect147/compass/blob/main/src/editor/engine/AssetLoader.ts): `src/editor/engine/AssetLoader.ts`
- [Canvas Renderer](https://github.com/suspect147/compass/blob/main/src/editor/engine/Renderer.ts): `src/editor/engine/Renderer.ts`
- [Fence Auto-Tiling](https://github.com/suspect147/compass/blob/main/src/utils/fence-auto-tiler.ts): `src/utils/fence-auto-tiler.ts`
- [Map Persistence](https://github.com/suspect147/compass/blob/main/src/editor/engine/IO.ts): `src/editor/engine/IO.ts`
- [PNG Export](https://github.com/suspect147/compass/blob/main/src/utils/canvas-drawer.ts): `src/utils/canvas-drawer.ts`
- [Export Sharpening](https://github.com/suspect147/compass/blob/main/src/core/sharpness-modal.ts): `src/core/sharpness-modal.ts`

### Maps & Community

- [Map Gallery](https://github.com/suspect147/compass/blob/main/src/pages/explore.ts): `src/pages/explore.ts`
- [Private Vault](https://github.com/suspect147/compass/blob/main/src/pages/dashboard.ts): `src/pages/dashboard.ts`
- [Map Viewing & Sharing](https://github.com/suspect147/compass/blob/main/src/pages/view.ts): `src/pages/view.ts`
- [Community Forum](https://github.com/suspect147/compass/blob/main/src/pages/forum.ts): `src/pages/forum.ts`

### Tile Skins

- [Custom Tile Studio](https://github.com/suspect147/compass/blob/main/src/pages/custom-tiles.ts): `src/pages/custom-tiles.ts`

### Shared Platform

- [Authentication & Themes](https://github.com/suspect147/compass/blob/main/src/core/auth-global.ts): `src/core/auth-global.ts`
- [Supabase Client](https://github.com/suspect147/compass/blob/main/src/core/supabase-client.ts): `src/core/supabase-client.ts`
- [Map & Tile Assets](https://github.com/suspect147/compass/tree/main/Resources): `Resources`

### Other components

- **Map Creator**
- **Supabase Services**

## Connections

- Map Creator → Editor Controller: edits maps (evidence: `README.md`)
- Editor Controller → Editor Definitions: uses definitions (evidence: `src/editor/MapEditor.ts`)
- Editor Controller → Layered Map Data: uses map data (evidence: `src/editor/MapEditor.ts`)
- Editor Controller → Editor Input: handles input (evidence: `src/editor/MapEditor.ts`)
- Editor Controller → Viewport Controls: controls viewport (evidence: `src/editor/MapEditor.ts`)
- Editor Controller → Edit History: records edits (evidence: `src/editor/MapEditor.ts`)
- Editor Controller → Map Validation: validates maps (evidence: `src/editor/MapEditor.ts`)
- Editor Controller → Asset Loading: loads assets (evidence: `src/editor/MapEditor.ts`)
- Editor Controller → Canvas Renderer: renders map (evidence: `src/editor/MapEditor.ts`)
- Editor Controller → Fence Auto-Tiling: auto-tiles fences (evidence: `src/editor/MapEditor.ts`)
- Editor Controller → Map Persistence: loads and saves (evidence: `src/editor/MapEditor.ts`)
- Editor Controller → Supabase Client: uses client (evidence: `src/editor/MapEditor.ts`)
- Editor Controller → Map & Tile Assets: loads map assets
- Editor Controller → PNG Export: supports export (evidence: `README.md`)
- PNG Export → Editor Controller: renders preview (evidence: `src/utils/canvas-drawer.ts`)
- Map Persistence → Supabase Client: persists maps (evidence: `src/editor/engine/IO.ts`)
- Map Persistence → Export Sharpening: offers sharpening (evidence: `src/editor/engine/IO.ts`)
- Map Gallery → Supabase Client: loads community maps (evidence: `src/pages/explore.ts`)
- Map Gallery → PNG Export: renders previews (evidence: `src/pages/explore.ts`)
- Private Vault → Supabase Client: loads map archive (evidence: `src/pages/dashboard.ts`)
- Private Vault → PNG Export: renders previews (evidence: `src/pages/dashboard.ts`)
- Map Viewing & Sharing → Supabase Client: loads shared maps (evidence: `src/pages/view.ts`)
- Map Viewing & Sharing → PNG Export: renders maps (evidence: `src/pages/view.ts`)
- Map Viewing & Sharing → Export Sharpening: offers sharpening (evidence: `src/pages/view.ts`)
- Community Forum → Supabase Client: uses backend (evidence: `src/pages/forum.ts`)
- Custom Tile Studio → Supabase Client: publishes tile packs (evidence: `src/pages/custom-tiles.ts`)
- Custom Tile Studio → Map & Tile Assets: uses tile presets (evidence: `src/pages/custom-tiles.ts`)
- Authentication & Themes → Supabase Client: authenticates users (evidence: `src/core/auth-global.ts`)
- Authentication & Themes → Supabase Services: uses auth services
- Supabase Client → Supabase Services: connects to (evidence: `src/core/supabase-client.ts`)
