# rimpk901/obsidian-svg-sticker architecture

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

- Interactive diagram: https://gitdiagram.com/rimpk901/obsidian-svg-sticker
- Repository: https://github.com/rimpk901/obsidian-svg-sticker

## Overview

SVG Sticker is an Obsidian plugin for choosing SVGs from a vault and assigning them to notes, folders, and Make.md Spaces. Users open the picker from a command or context menu, select an icon, and the plugin saves the assignment and refreshes its display. The graph also shows settings, localization, and bulk Make.md assignment. Edges reflect the supplied excerpts, source index, or README; unsampled implementation details are not inferred.

Main entry points: [`src/main.ts`](https://github.com/rimpk901/obsidian-svg-sticker/blob/main/src/main.ts) (Plugin commands), [`src/MakeMDAdapter.ts`](https://github.com/rimpk901/obsidian-svg-sticker/blob/main/src/MakeMDAdapter.ts) (Make.md adapter), [`src/StickerModal.ts`](https://github.com/rimpk901/obsidian-svg-sticker/blob/main/src/StickerModal.ts) (SVG icon picker), [`src/i18n.ts`](https://github.com/rimpk901/obsidian-svg-sticker/blob/main/src/i18n.ts) (Language detection)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_plugin["Plugin workflow"]
  node_plugin["Plugin commands<br/>[main.ts]"]
  node_picker["SVG icon picker<br/>[StickerModal.ts]"]
  node_assign["Sticker assignment<br/>[main.ts]"]
  node_settings["Plugin settings<br/>[main.ts]"]
  node_saved[("Plugin data<br/>[main.ts]")]
end

subgraph group_vault["Vault stickers"]
  node_vault[("Obsidian vault")]
  node_note["Note stickers<br/>[main.ts]"]
  node_folder["Folder stickers<br/>[main.ts]"]
  node_display["Explorer sticker display<br/>[main.ts]"]
end

subgraph group_make["Make.md integration"]
  node_adapter["Make.md adapter<br/>[MakeMDAdapter.ts]"]
  node_makeapi["Make.md runtime API"]
  node_bulk["Bulk assignments<br/>[main.ts]"]
end

subgraph group_shared["Shared interface"]
  node_language["Language detection<br/>[i18n.ts]"]
  node_types["Settings and data types<br/>[types.ts]"]
end

node_user(("Obsidian user"))

node_user -->|"uses commands"| node_plugin
node_plugin -->|"opens"| node_picker
node_picker -->|"lists SVGs"| node_vault
node_picker -->|"chooses icon"| node_assign
node_plugin -->|"creates adapter"| node_adapter
node_plugin -->|"updates"| node_settings
node_plugin -->|"loads and saves"| node_saved
node_assign -->|"writes frontmatter"| node_note
node_assign -->|"saves assignment"| node_folder
node_plugin -->|"refreshes"| node_display
node_display -->|"reads icon files"| node_vault
node_display -->|"reads sticker metadata"| node_note
node_plugin -->|"assigns Make.md icons"| node_adapter
node_adapter -->|"reads and updates"| node_makeapi
node_plugin -->|"opens bulk picker"| node_bulk
node_bulk -->|"assigns many"| node_adapter
node_plugin -->|"translates interface"| node_language
node_picker -->|"translates labels"| node_language
node_adapter -->|"translates menu"| node_language
node_settings -->|"uses settings types"| node_types

click node_plugin "https://github.com/rimpk901/obsidian-svg-sticker/blob/main/src/main.ts"
click node_picker "https://github.com/rimpk901/obsidian-svg-sticker/blob/main/src/StickerModal.ts"
click node_assign "https://github.com/rimpk901/obsidian-svg-sticker/blob/main/src/main.ts"
click node_settings "https://github.com/rimpk901/obsidian-svg-sticker/blob/main/src/main.ts"
click node_saved "https://github.com/rimpk901/obsidian-svg-sticker/blob/main/src/main.ts"
click node_note "https://github.com/rimpk901/obsidian-svg-sticker/blob/main/src/main.ts"
click node_folder "https://github.com/rimpk901/obsidian-svg-sticker/blob/main/src/main.ts"
click node_display "https://github.com/rimpk901/obsidian-svg-sticker/blob/main/src/main.ts"
click node_adapter "https://github.com/rimpk901/obsidian-svg-sticker/blob/main/src/MakeMDAdapter.ts"
click node_bulk "https://github.com/rimpk901/obsidian-svg-sticker/blob/main/src/main.ts"
click node_language "https://github.com/rimpk901/obsidian-svg-sticker/blob/main/src/i18n.ts"
click node_types "https://github.com/rimpk901/obsidian-svg-sticker/blob/main/src/types.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_plugin,node_picker,node_assign,node_settings,node_saved,node_user toneBlue
class node_vault,node_note,node_folder,node_display toneAmber
class node_adapter,node_makeapi,node_bulk toneMint
class node_language,node_types toneRose
```

## Components

### Plugin workflow

- [Plugin commands](https://github.com/rimpk901/obsidian-svg-sticker/blob/main/src/main.ts): `src/main.ts`
- [SVG icon picker](https://github.com/rimpk901/obsidian-svg-sticker/blob/main/src/StickerModal.ts): `src/StickerModal.ts`
- [Sticker assignment](https://github.com/rimpk901/obsidian-svg-sticker/blob/main/src/main.ts): `src/main.ts`
- [Plugin settings](https://github.com/rimpk901/obsidian-svg-sticker/blob/main/src/main.ts): `src/main.ts`
- [Plugin data](https://github.com/rimpk901/obsidian-svg-sticker/blob/main/src/main.ts): `src/main.ts`

### Vault stickers

- **Obsidian vault**
- [Note stickers](https://github.com/rimpk901/obsidian-svg-sticker/blob/main/src/main.ts): `src/main.ts`
- [Folder stickers](https://github.com/rimpk901/obsidian-svg-sticker/blob/main/src/main.ts): `src/main.ts`
- [Explorer sticker display](https://github.com/rimpk901/obsidian-svg-sticker/blob/main/src/main.ts): `src/main.ts`

### Make.md integration

- [Make.md adapter](https://github.com/rimpk901/obsidian-svg-sticker/blob/main/src/MakeMDAdapter.ts): `src/MakeMDAdapter.ts`
- **Make.md runtime API**
- [Bulk assignments](https://github.com/rimpk901/obsidian-svg-sticker/blob/main/src/main.ts): `src/main.ts`

### Shared interface

- [Language detection](https://github.com/rimpk901/obsidian-svg-sticker/blob/main/src/i18n.ts): `src/i18n.ts`
- [Settings and data types](https://github.com/rimpk901/obsidian-svg-sticker/blob/main/src/types.ts): `src/types.ts`

### Other components

- **Obsidian user**

## Connections

- Obsidian user → Plugin commands: uses commands (evidence: `README.md`)
- Plugin commands → SVG icon picker: opens (evidence: `src/main.ts`)
- SVG icon picker → Obsidian vault: lists SVGs (evidence: `src/StickerModal.ts`)
- SVG icon picker → Sticker assignment: chooses icon (evidence: `src/main.ts`)
- Plugin commands → Make.md adapter: creates adapter (evidence: `src/main.ts`)
- Plugin commands → Plugin settings: updates (evidence: `src/main.ts`)
- Plugin commands → Plugin data: loads and saves (evidence: `src/main.ts`)
- Sticker assignment → Note stickers: writes frontmatter (evidence: `src/main.ts`)
- Sticker assignment → Folder stickers: saves assignment (evidence: `src/main.ts`)
- Plugin commands → Explorer sticker display: refreshes (evidence: `src/main.ts`)
- Explorer sticker display → Obsidian vault: reads icon files (evidence: `src/main.ts`)
- Explorer sticker display → Note stickers: reads sticker metadata (evidence: `src/main.ts`)
- Plugin commands → Make.md adapter: assigns Make.md icons (evidence: `src/main.ts`)
- Make.md adapter → Make.md runtime API: reads and updates (evidence: `src/MakeMDAdapter.ts`)
- Plugin commands → Bulk assignments: opens bulk picker (evidence: `README.md`)
- Bulk assignments → Make.md adapter: assigns many (evidence: `README.md`)
- Plugin commands → Language detection: translates interface (evidence: `src/main.ts`)
- SVG icon picker → Language detection: translates labels (evidence: `src/StickerModal.ts`)
- Make.md adapter → Language detection: translates menu (evidence: `src/MakeMDAdapter.ts`)
- Plugin settings → Settings and data types: uses settings types (evidence: `src/main.ts`)
