# pranjal-barnwal/minimal-kiwi architecture

> Architecture diagram of the GitHub repository pranjal-barnwal/minimal-kiwi, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2025-05-27). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/pranjal-barnwal/minimal-kiwi
- Repository: https://github.com/pranjal-barnwal/minimal-kiwi

## Overview

##### Project type and purpose
- This is an open-source Visual Studio Code theme extension (“Minimal Kiwi”).

##### File structure
- Top-level config and metadata:
- package.json (extension manifest, version, publisher, activation events)
- .github/workflows (CI for packaging or publishing)
- vsc-extension-quickstart.md (guidance for extension development)
- themes directory:
- custom.css (optional UI tweaks)
- Build tooling is external: vsce, Yeoman generator-code

##### Key insights from the README
- No runtime code: purely static theme information
- Installation pathways: Marketplace, VSIX via CLI
- Contribution workflow: edit JSON, bump version in package.json, vsce package, PR

## Diagram (Mermaid)

```mermaid
flowchart TD
    %% Developer Workstation
    subgraph "Developer Workstation"
        direction TB
        Repo["Git Repository"]:::repo
        subgraph "Static Assets"
            direction TB
            PackageJSON["package.json"]:::asset
            ThemeJSON["themes/Minimal Kiwi-color-theme.json"]:::asset
            CSS["themes/custom.css"]:::asset
            AssetsDir["assets/"]:::asset
            VscodeIgnore[".vscodeignore"]:::asset
            Quickstart["vsc-extension-quickstart.md"]:::asset
            ContribGuide["CONTRIBUTING.md"]:::asset
            Readme["README.md"]:::asset
            License["LICENSE"]:::asset
        end
        subgraph "Tools"
            direction TB
            GitCLI["Git"]:::tool
            NodeJS["Node.js"]:::tool
            Yeoman["Yeoman generator-code"]:::tool
            VSCE["vsce"]:::tool
        end
    end

    %% CI/CD Platform
    subgraph "CI/CD Platform (GitHub Actions)"
        direction TB
        Workflow[".github/workflows/pr-closed.yml"]:::tool
        CI["Lint & Package"]:::tool
        VSIX_ART[".vsix Package"]:::artifact
    end

    %% Marketplace
    Marketplace["VS Code Marketplace"]:::external

    %% End-User VS Code Client
    subgraph "End-User VS Code Client"
        direction TB
        VSCodeUI["CLI/GUI Install"]:::runtime
        VSCodeHost["VS Code Extension Host"]:::runtime
    end

    ExternalAPI["VS Code Extension API"]:::external

    %% Connections
    Repo -->|push| Workflow
    Workflow -->|run CI| CI
    CI -->|outputs| VSIX_ART

    VSCE -->|package VSIX| VSIX_ART
    VSIX_ART -->|publish| Marketplace

    Marketplace -->|install| VSCodeUI
    VSCodeUI -->|activates| VSCodeHost
    VSCodeHost -->|reads JSON/CSS| ThemeJSON
    VSCodeHost -->|reads JSON/CSS| CSS
    VSCodeHost -->|uses API| ExternalAPI

    %% Click Events
    click PackageJSON "https://github.com/pranjal-barnwal/minimal-kiwi/blob/main/package.json"
    click ThemeJSON "https://github.com/pranjal-barnwal/minimal-kiwi/blob/main/themes/Minimal Kiwi-color-theme.json"
    click CSS "https://github.com/pranjal-barnwal/minimal-kiwi/blob/main/themes/custom.css"
    click AssetsDir "https://github.com/pranjal-barnwal/minimal-kiwi/tree/main/assets/"
    click VscodeIgnore "https://github.com/pranjal-barnwal/minimal-kiwi/blob/main/.vscodeignore"
    click Quickstart "https://github.com/pranjal-barnwal/minimal-kiwi/blob/main/vsc-extension-quickstart.md"
    click ContribGuide "https://github.com/pranjal-barnwal/minimal-kiwi/blob/main/CONTRIBUTING.md"
    click Readme "https://github.com/pranjal-barnwal/minimal-kiwi/blob/main/README.md"
    click License "https://github.com/pranjal-barnwal/minimal-kiwi/tree/main/LICENSE"
    click Workflow "https://github.com/pranjal-barnwal/minimal-kiwi/blob/main/.github/workflows/pr-closed.yml"

    %% Styles
    classDef asset fill:#a2f5a2,stroke:#333,stroke-width:1px
    classDef tool fill:#a2d0f5,stroke:#333,stroke-width:1px
    classDef runtime fill:#f5cfa2,stroke:#333,stroke-width:1px
    classDef repo fill:#e0e0e0,stroke:#333,stroke-width:1px
    classDef artifact fill:#d0f5f0,stroke:#333,stroke-width:1px
    classDef external fill:#f0c2f5,stroke:#333,stroke-width:1px
```
