# mubashshiradeeb/stratakort architecture

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

- Interactive diagram: https://gitdiagram.com/mubashshiradeeb/stratakort
- Repository: https://github.com/mubashshiradeeb/stratakort

## Overview

Stratakort is a browser-based map-poster generator. The main workflow is to enter the editor, search for a place, customize the live map and poster, preview the composition, then export a print-ready PNG. Its major branches also include a marketing gallery with live map thumbnails, geocoding, and the export-rendering internals. Edges are limited to relationships shown in excerpts, the source index, or README; some unsampled editor-control wiring is therefore omitted.

Main entry points: [`components/editor/MapCanvas.tsx`](https://github.com/mubashshiradeeb/stratakort/blob/main/components/editor/MapCanvas.tsx) (Live map), [`lib/store.ts`](https://github.com/mubashshiradeeb/stratakort/blob/main/lib/store.ts) (Editor state), [`components/editor/PosterOverlay.tsx`](https://github.com/mubashshiradeeb/stratakort/blob/main/components/editor/PosterOverlay.tsx) (Poster preview), [`lib/useExportPoster.ts`](https://github.com/mubashshiradeeb/stratakort/blob/main/lib/useExportPoster.ts) (Export orchestration)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_entry["Product entry"]
  node_home["Landing page<br/>[page.tsx]"]
  node_showcase["Poster showcase<br/>[PosterMock.tsx]"]
  node_thumbnail["Live map thumbnail"]
  node_sample_data["Sample posters<br/>[sampleData.ts]"]
end

subgraph group_editor["Map editor"]
  node_create["Editor route<br/>[page.tsx]"]
  node_editor_app["Editor assembly<br/>[MapEditor.tsx]"]
  node_map_canvas["Live map<br/>[MapCanvas.tsx]"]
  node_controls["Editor controls"]
  node_state["Editor state<br/>[store.ts]"]
  node_map_context["Map references<br/>[mapContext.tsx]"]
  node_map_styles["Map style engine<br/>[mapStyles.ts]"]
  node_routes["Route editing<br/>[RouteControls.tsx]"]
end

subgraph group_design["Poster design"]
  node_themes["Theme palettes<br/>[palettes.ts]"]
  node_map_filters["Map filters<br/>[mapFilters.ts]"]
  node_poster_overlay["Poster preview<br/>[PosterOverlay.tsx]"]
  node_typography["Typography controls"]
  node_ratios["Aspect ratios"]
  node_font_pairs["Font pairings<br/>[fontPairs.ts]"]
end

subgraph group_render["Rendering and export"]
  node_export_hook["Export orchestration<br/>[useExportPoster.ts]"]
  node_exporter["Canvas compositor<br/>[export.ts]"]
  node_grain["Grain renderer<br/>[grain.ts]"]
end

subgraph group_location["Location search"]
  node_location_panel["Location panel<br/>[LocationPanel.tsx]"]
  node_location_search["Location search<br/>[LocationSearch.tsx]"]
  node_search_hook["Search logic"]
  node_geocoder["Geocoding client<br/>[geocode.ts]"]
  node_geocode_api["Geocoding proxy<br/>[route.ts]"]
end

node_visitor(("Visitor"))
node_nominatim{{"Nominatim"}}

node_visitor -->|"opens"| node_home
node_home -->|"shows"| node_showcase
node_showcase -->|"renders"| node_thumbnail
node_showcase -->|"uses themes"| node_themes
node_showcase -->|"uses samples"| node_sample_data
node_visitor -->|"starts creating"| node_create
node_create -->|"renders"| node_editor_app
node_editor_app -->|"uses references"| node_map_context
node_map_canvas -->|"reads settings"| node_state
node_map_canvas -->|"builds map style"| node_map_styles
node_map_canvas -->|"applies filters"| node_map_filters
node_map_canvas -->|"uses references"| node_map_context
node_map_canvas -.->|"uses palette"| node_themes
node_map_canvas -.->|"loads map tiles"| node_nominatim
node_location_search -->|"uses search"| node_search_hook
node_location_search -->|"sets location"| node_state
node_search_hook -->|"searches"| node_geocoder
node_geocoder -.->|"requests proxy"| node_geocode_api
node_geocode_api -->|"forwards query"| node_nominatim
node_routes -->|"updates route"| node_state
node_routes -->|"uses search"| node_search_hook
node_poster_overlay -->|"reads settings"| node_state
node_poster_overlay -->|"reads map"| node_map_context
node_poster_overlay -->|"uses layout"| node_exporter
node_poster_overlay -->|"uses fonts"| node_font_pairs
node_poster_overlay -->|"uses grain"| node_grain
node_typography -->|"updates settings"| node_state
node_typography -->|"uses fonts"| node_font_pairs
node_visitor -.->|"requests export"| node_export_hook
node_export_hook -->|"reads settings"| node_state
node_export_hook -->|"captures map"| node_map_context
node_export_hook -->|"renders poster"| node_exporter
node_export_hook -->|"gets preset"| node_ratios
node_exporter -->|"draws grain"| node_grain
node_exporter -->|"gets preset"| node_ratios

click node_home "https://github.com/mubashshiradeeb/stratakort/blob/main/app/page.tsx"
click node_showcase "https://github.com/mubashshiradeeb/stratakort/blob/main/components/landing/PosterMock.tsx"
click node_thumbnail "https://github.com/mubashshiradeeb/stratakort/blob/main/components/landing/LiveMapThumbnail.tsx"
click node_create "https://github.com/mubashshiradeeb/stratakort/blob/main/app/create/page.tsx"
click node_editor_app "https://github.com/mubashshiradeeb/stratakort/blob/main/components/editor/MapEditor.tsx"
click node_map_canvas "https://github.com/mubashshiradeeb/stratakort/blob/main/components/editor/MapCanvas.tsx"
click node_controls "https://github.com/mubashshiradeeb/stratakort/tree/main/components/editor"
click node_location_panel "https://github.com/mubashshiradeeb/stratakort/blob/main/components/editor/LocationPanel.tsx"
click node_location_search "https://github.com/mubashshiradeeb/stratakort/blob/main/components/editor/LocationSearch.tsx"
click node_search_hook "https://github.com/mubashshiradeeb/stratakort/blob/main/lib/useLocationSearch.ts"
click node_geocoder "https://github.com/mubashshiradeeb/stratakort/blob/main/lib/geocode.ts"
click node_geocode_api "https://github.com/mubashshiradeeb/stratakort/blob/main/app/api/geocode/route.ts"
click node_state "https://github.com/mubashshiradeeb/stratakort/blob/main/lib/store.ts"
click node_map_context "https://github.com/mubashshiradeeb/stratakort/blob/main/lib/mapContext.tsx"
click node_map_styles "https://github.com/mubashshiradeeb/stratakort/blob/main/lib/mapStyles.ts"
click node_themes "https://github.com/mubashshiradeeb/stratakort/blob/main/lib/palettes.ts"
click node_map_filters "https://github.com/mubashshiradeeb/stratakort/blob/main/lib/mapFilters.ts"
click node_routes "https://github.com/mubashshiradeeb/stratakort/blob/main/components/editor/RouteControls.tsx"
click node_poster_overlay "https://github.com/mubashshiradeeb/stratakort/blob/main/components/editor/PosterOverlay.tsx"
click node_typography "https://github.com/mubashshiradeeb/stratakort/blob/main/components/editor/TypographyControls.tsx"
click node_ratios "https://github.com/mubashshiradeeb/stratakort/blob/main/lib/aspectRatioPresets.ts"
click node_export_hook "https://github.com/mubashshiradeeb/stratakort/blob/main/lib/useExportPoster.ts"
click node_exporter "https://github.com/mubashshiradeeb/stratakort/blob/main/lib/export.ts"
click node_grain "https://github.com/mubashshiradeeb/stratakort/blob/main/lib/grain.ts"
click node_font_pairs "https://github.com/mubashshiradeeb/stratakort/blob/main/lib/fontPairs.ts"
click node_sample_data "https://github.com/mubashshiradeeb/stratakort/blob/main/lib/sampleData.ts"

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_home,node_showcase,node_thumbnail,node_sample_data toneBlue
class node_create,node_editor_app,node_map_canvas,node_controls,node_state,node_map_context,node_map_styles,node_routes toneAmber
class node_themes,node_map_filters,node_poster_overlay,node_typography,node_ratios,node_font_pairs toneMint
class node_export_hook,node_exporter,node_grain toneRose
class node_location_panel,node_location_search,node_search_hook,node_geocoder,node_geocode_api,node_visitor,node_nominatim toneIndigo
```

## Components

### Product entry

- [Landing page](https://github.com/mubashshiradeeb/stratakort/blob/main/app/page.tsx): `app/page.tsx`
- [Poster showcase](https://github.com/mubashshiradeeb/stratakort/blob/main/components/landing/PosterMock.tsx): `components/landing/PosterMock.tsx`
- [Live map thumbnail](https://github.com/mubashshiradeeb/stratakort/blob/main/components/landing/LiveMapThumbnail.tsx): `components/landing/LiveMapThumbnail.tsx`
- [Sample posters](https://github.com/mubashshiradeeb/stratakort/blob/main/lib/sampleData.ts): `lib/sampleData.ts`

### Map editor

- [Editor route](https://github.com/mubashshiradeeb/stratakort/blob/main/app/create/page.tsx): `app/create/page.tsx`
- [Editor assembly](https://github.com/mubashshiradeeb/stratakort/blob/main/components/editor/MapEditor.tsx): `components/editor/MapEditor.tsx`
- [Live map](https://github.com/mubashshiradeeb/stratakort/blob/main/components/editor/MapCanvas.tsx): `components/editor/MapCanvas.tsx`
- [Editor controls](https://github.com/mubashshiradeeb/stratakort/tree/main/components/editor): `components/editor`
- [Editor state](https://github.com/mubashshiradeeb/stratakort/blob/main/lib/store.ts): `lib/store.ts`
- [Map references](https://github.com/mubashshiradeeb/stratakort/blob/main/lib/mapContext.tsx): `lib/mapContext.tsx`
- [Map style engine](https://github.com/mubashshiradeeb/stratakort/blob/main/lib/mapStyles.ts): `lib/mapStyles.ts`
- [Route editing](https://github.com/mubashshiradeeb/stratakort/blob/main/components/editor/RouteControls.tsx): `components/editor/RouteControls.tsx`

### Poster design

- [Theme palettes](https://github.com/mubashshiradeeb/stratakort/blob/main/lib/palettes.ts): `lib/palettes.ts`
- [Map filters](https://github.com/mubashshiradeeb/stratakort/blob/main/lib/mapFilters.ts): `lib/mapFilters.ts`
- [Poster preview](https://github.com/mubashshiradeeb/stratakort/blob/main/components/editor/PosterOverlay.tsx): `components/editor/PosterOverlay.tsx`
- [Typography controls](https://github.com/mubashshiradeeb/stratakort/blob/main/components/editor/TypographyControls.tsx): `components/editor/TypographyControls.tsx`
- [Aspect ratios](https://github.com/mubashshiradeeb/stratakort/blob/main/lib/aspectRatioPresets.ts): `lib/aspectRatioPresets.ts`
- [Font pairings](https://github.com/mubashshiradeeb/stratakort/blob/main/lib/fontPairs.ts): `lib/fontPairs.ts`

### Rendering and export

- [Export orchestration](https://github.com/mubashshiradeeb/stratakort/blob/main/lib/useExportPoster.ts): `lib/useExportPoster.ts`
- [Canvas compositor](https://github.com/mubashshiradeeb/stratakort/blob/main/lib/export.ts): `lib/export.ts`
- [Grain renderer](https://github.com/mubashshiradeeb/stratakort/blob/main/lib/grain.ts): `lib/grain.ts`

### Location search

- [Location panel](https://github.com/mubashshiradeeb/stratakort/blob/main/components/editor/LocationPanel.tsx): `components/editor/LocationPanel.tsx`
- [Location search](https://github.com/mubashshiradeeb/stratakort/blob/main/components/editor/LocationSearch.tsx): `components/editor/LocationSearch.tsx`
- [Search logic](https://github.com/mubashshiradeeb/stratakort/blob/main/lib/useLocationSearch.ts): `lib/useLocationSearch.ts`
- [Geocoding client](https://github.com/mubashshiradeeb/stratakort/blob/main/lib/geocode.ts): `lib/geocode.ts`
- [Geocoding proxy](https://github.com/mubashshiradeeb/stratakort/blob/main/app/api/geocode/route.ts): `app/api/geocode/route.ts`

### Other components

- **Visitor**
- **Nominatim**

## Connections

- Visitor → Landing page: opens (evidence: `app/page.tsx`)
- Landing page → Poster showcase: shows (evidence: `app/page.tsx`)
- Poster showcase → Live map thumbnail: renders (evidence: `components/landing/PosterMock.tsx`)
- Poster showcase → Theme palettes: uses themes (evidence: `components/landing/PosterMock.tsx`)
- Poster showcase → Sample posters: uses samples (evidence: `components/landing/PosterMock.tsx`)
- Visitor → Editor route: starts creating
- Editor route → Editor assembly: renders (evidence: `app/create/page.tsx`)
- Editor assembly → Map references: uses references (evidence: `components/editor/MapEditor.tsx`)
- Live map → Editor state: reads settings (evidence: `components/editor/MapCanvas.tsx`)
- Live map → Map style engine: builds map style (evidence: `components/editor/MapCanvas.tsx`)
- Live map → Map filters: applies filters (evidence: `components/editor/MapCanvas.tsx`)
- Live map → Map references: uses references (evidence: `components/editor/MapCanvas.tsx`)
- Live map → Theme palettes: uses palette
- Live map → Nominatim: loads map tiles
- Location search → Search logic: uses search (evidence: `components/editor/LocationSearch.tsx`)
- Location search → Editor state: sets location (evidence: `components/editor/LocationSearch.tsx`)
- Search logic → Geocoding client: searches (evidence: `lib/useLocationSearch.ts`)
- Geocoding client → Geocoding proxy: requests proxy
- Geocoding proxy → Nominatim: forwards query
- Route editing → Editor state: updates route (evidence: `components/editor/RouteControls.tsx`)
- Route editing → Search logic: uses search (evidence: `components/editor/RouteControls.tsx`)
- Poster preview → Editor state: reads settings (evidence: `components/editor/PosterOverlay.tsx`)
- Poster preview → Map references: reads map (evidence: `components/editor/PosterOverlay.tsx`)
- Poster preview → Canvas compositor: uses layout (evidence: `components/editor/PosterOverlay.tsx`)
- Poster preview → Font pairings: uses fonts (evidence: `components/editor/PosterOverlay.tsx`)
- Poster preview → Grain renderer: uses grain (evidence: `components/editor/PosterOverlay.tsx`)
- Typography controls → Editor state: updates settings (evidence: `components/editor/TypographyControls.tsx`)
- Typography controls → Font pairings: uses fonts (evidence: `components/editor/TypographyControls.tsx`)
- Visitor → Export orchestration: requests export
- Export orchestration → Editor state: reads settings (evidence: `lib/useExportPoster.ts`)
- Export orchestration → Map references: captures map (evidence: `lib/useExportPoster.ts`)
- Export orchestration → Canvas compositor: renders poster (evidence: `lib/useExportPoster.ts`)
- Export orchestration → Aspect ratios: gets preset (evidence: `lib/useExportPoster.ts`)
- Canvas compositor → Grain renderer: draws grain (evidence: `lib/export.ts`)
- Canvas compositor → Aspect ratios: gets preset (evidence: `lib/export.ts`)
