# nallto/swirla architecture

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

- Interactive diagram: https://gitdiagram.com/nallto/swirla
- Repository: https://github.com/nallto/swirla

## Overview

##### File structure
- Top-level files:
- package.json – extension metadata (name, version, publisher, contributes section pointing at the theme)
- images/ – assets (e.g. screenshot) used in the marketplace listing or README
- .vscodeignore – files to exclude when packaging
- vsc-extension-quickstart.md – template guidance for building a VS Code extension
- CHANGELOG.md, LICENSE, README.md – documentation
- There is no backend, database, or build pipeline code here—just the manifest + JSON theme + assets.

##### Final guidance
- This approach ensures you document how Swirla is built, published, and ultimately loaded by the editor.

## Diagram (Mermaid)

```mermaid
flowchart TD
    subgraph "Developer Environment"
        Dev["Developer"]:::dev
        subgraph "Local Extension Files"
            A["package.json"]:::file
            B["themes/swirla-color-theme.json"]:::file
            C["images/"]:::file
            D[".vscodeignore"]:::file
            E["vsc-extension-quickstart.md"]:::file
            F["README.md"]:::file
            G["CHANGELOG.md"]:::file
            H["LICENSE"]:::file
        end
        Dev --> A
        Dev --> B
        Dev --> C
        Dev --> D
        Dev --> E
        Dev --> F
        Dev --> G
        Dev --> H
    end

    Dev -->|"runs vsce package"| VSCE["VS Code vsce CLI"]:::pipeline
    VSCE -->|"publishes .vsix"| Market["VS Code Marketplace"]:::pipeline
    Market -->|"installs extension"| Client["VS Code Client (Extension Host + Workbench)"]:::runtime

    subgraph "VS Code Client"
        Load["Load package.json → find theme"]:::runtime
        Apply["Apply swirla-color-theme.json"]:::runtime
        Client --> Load
        Load --> Apply
    end

    click A "https://github.com/nallto/swirla/blob/main/package.json"
    click B "https://github.com/nallto/swirla/blob/main/themes/swirla-color-theme.json"
    click C "https://github.com/nallto/swirla/tree/main/images/"
    click D "https://github.com/nallto/swirla/blob/main/.vscodeignore"
    click E "https://github.com/nallto/swirla/blob/main/vsc-extension-quickstart.md"
    click F "https://github.com/nallto/swirla/blob/main/README.md"
    click G "https://github.com/nallto/swirla/blob/main/CHANGELOG.md"
    click H "https://github.com/nallto/swirla/tree/main/LICENSE"

    classDef dev fill:#f9f,stroke:#333,stroke-width:1px
    classDef pipeline fill:#bbf,stroke:#333,stroke-width:1px
    classDef runtime fill:#bfb,stroke:#333,stroke-width:1px
    classDef file fill:#ddd,stroke:#333,stroke-width:1px
```
