# syvixor/skills-icons architecture

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

- Interactive diagram: https://gitdiagram.com/syvixor/skills-icons
- Repository: https://github.com/syvixor/skills-icons

## Overview

Skills Icons is an Express API that turns requested technology names into a composed SVG badge, and also exposes an endpoint listing available icons. The main flow is request, name resolution, asset loading and customization, SVG composition, then response. The README also documents a separate visual builder, which the server redirects to. Source excerpts show these runtime relationships; the icon collection is represented as a filesystem asset store.

Main entry points: [`src/routes/index.ts`](https://github.com/syvixor/skills-icons/blob/main/src/routes/index.ts) (Icon Route), [`src/index.ts`](https://github.com/syvixor/skills-icons/blob/main/src/index.ts) (Express Server), [`icons`](https://github.com/syvixor/skills-icons/tree/main/icons) (SVG Icon Files), [`src/utils/index.ts`](https://github.com/syvixor/skills-icons/blob/main/src/utils/index.ts) (Error Response)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_api["API Runtime"]
  node_server["Express Server<br/>[index.ts]"]
  node_icons_route["Icon Route<br/>[index.ts]"]
  node_catalog_route["Catalog Route<br/>[index.ts]"]
  node_name_mapping["Name Mapping<br/>[index.ts]"]
end

subgraph group_assets["Icon Assets"]
  node_svg_assets["SVG Icon Files"]
  node_icon_files["Icon File Access<br/>[index.ts]"]
  node_catalog_parse["Catalog Metadata<br/>[index.ts]"]
end

subgraph group_render["SVG Rendering"]
  node_svg_composer["SVG Composer<br/>[index.ts]"]
  node_error_response["Error Response<br/>[index.ts]"]
end

node_user(("API Consumer"))
node_builder["Visual Builder"]
node_raw_github["Raw GitHub URLs"]

node_user -->|"requests icons"| node_server
node_server -->|"redirects to"| node_builder
node_server -->|"mounts API"| node_icons_route
node_server -->|"handles fallback"| node_error_response
node_icons_route -->|"resolves names"| node_name_mapping
node_icons_route -->|"reads requested"| node_icon_files
node_icon_files -->|"loads SVGs"| node_svg_assets
node_icons_route -->|"composes badge"| node_svg_composer
node_icons_route -->|"sends errors"| node_error_response
node_icons_route -->|"returns SVG"| node_user
node_server -->|"mounts API"| node_catalog_route
node_catalog_route -->|"reads directory"| node_icon_files
node_catalog_route -->|"extracts titles"| node_catalog_parse
node_catalog_parse -->|"reads SVG content"| node_svg_assets
node_catalog_route -->|"returns asset URLs"| node_raw_github
node_catalog_route -->|"returns catalog"| node_user

click node_server "https://github.com/syvixor/skills-icons/blob/main/src/index.ts"
click node_icons_route "https://github.com/syvixor/skills-icons/blob/main/src/routes/index.ts"
click node_catalog_route "https://github.com/syvixor/skills-icons/blob/main/src/routes/index.ts"
click node_name_mapping "https://github.com/syvixor/skills-icons/blob/main/src/routes/index.ts"
click node_svg_assets "https://github.com/syvixor/skills-icons/tree/main/icons"
click node_icon_files "https://github.com/syvixor/skills-icons/blob/main/src/routes/index.ts"
click node_catalog_parse "https://github.com/syvixor/skills-icons/blob/main/src/routes/index.ts"
click node_svg_composer "https://github.com/syvixor/skills-icons/blob/main/src/utils/index.ts"
click node_error_response "https://github.com/syvixor/skills-icons/blob/main/src/utils/index.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_server,node_icons_route,node_catalog_route,node_name_mapping toneBlue
class node_svg_assets,node_icon_files,node_catalog_parse toneAmber
class node_svg_composer,node_error_response,node_user toneMint
class node_builder,node_raw_github toneIndigo
```

## Components

### API Runtime

- [Express Server](https://github.com/syvixor/skills-icons/blob/main/src/index.ts): `src/index.ts`
- [Icon Route](https://github.com/syvixor/skills-icons/blob/main/src/routes/index.ts): `src/routes/index.ts`
- [Catalog Route](https://github.com/syvixor/skills-icons/blob/main/src/routes/index.ts): `src/routes/index.ts`
- [Name Mapping](https://github.com/syvixor/skills-icons/blob/main/src/routes/index.ts): `src/routes/index.ts`

### Icon Assets

- [SVG Icon Files](https://github.com/syvixor/skills-icons/tree/main/icons): `icons`
- [Icon File Access](https://github.com/syvixor/skills-icons/blob/main/src/routes/index.ts): `src/routes/index.ts`
- [Catalog Metadata](https://github.com/syvixor/skills-icons/blob/main/src/routes/index.ts): `src/routes/index.ts`

### SVG Rendering

- [SVG Composer](https://github.com/syvixor/skills-icons/blob/main/src/utils/index.ts): `src/utils/index.ts`
- [Error Response](https://github.com/syvixor/skills-icons/blob/main/src/utils/index.ts): `src/utils/index.ts`

### Other components

- **API Consumer**
- **Visual Builder**
- **Raw GitHub URLs**

## Connections

- API Consumer → Express Server: requests icons (evidence: `README.md`)
- Express Server → Visual Builder: redirects to (evidence: `src/index.ts`)
- Express Server → Icon Route: mounts API (evidence: `src/index.ts`)
- Express Server → Error Response: handles fallback (evidence: `src/index.ts`)
- Icon Route → Name Mapping: resolves names (evidence: `src/routes/index.ts`)
- Icon Route → Icon File Access: reads requested (evidence: `src/routes/index.ts`)
- Icon File Access → SVG Icon Files: loads SVGs (evidence: `src/routes/index.ts`)
- Icon Route → SVG Composer: composes badge (evidence: `src/routes/index.ts`)
- Icon Route → Error Response: sends errors (evidence: `src/routes/index.ts`)
- Icon Route → API Consumer: returns SVG (evidence: `src/routes/index.ts`)
- Express Server → Catalog Route: mounts API (evidence: `src/index.ts`)
- Catalog Route → Icon File Access: reads directory (evidence: `src/routes/index.ts`)
- Catalog Route → Catalog Metadata: extracts titles (evidence: `src/routes/index.ts`)
- Catalog Metadata → SVG Icon Files: reads SVG content (evidence: `src/routes/index.ts`)
- Catalog Route → Raw GitHub URLs: returns asset URLs (evidence: `src/routes/index.ts`)
- Catalog Route → API Consumer: returns catalog (evidence: `src/routes/index.ts`)
