# penpot/penpot-files architecture

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

- Interactive diagram: https://gitdiagram.com/penpot/penpot-files
- Repository: https://github.com/penpot/penpot-files

## Overview

This repository is a community catalog of Penpot design resources, not the Penpot application itself. The user workflow is to find and download a design file, import it into Penpot, and optionally convert it into a shared library. The catalog spans UI kits, design systems, icons, templates, prototyping examples, and layout tools. No source excerpts were provided, so relationships below are limited to the workflow documented in the README; catalog nodes use representative files from the tree.

Main entry points: [`README.md`](https://github.com/penpot/penpot-files/blob/main/README.md) (Resource catalog), [`Color palette kit - design tokens v1.penpot`](https://github.com/penpot/penpot-files/blob/main/Color%20palette%20kit%20-%20design%20tokens%20v1.penpot) (Design tokens), [`Penpot - Design System v2.1.penpot`](https://github.com/penpot/penpot-files/blob/main/Penpot%20-%20Design%20System%20v2.1.penpot) (Design systems), [`Material Design 3.penpot`](https://github.com/penpot/penpot-files/blob/main/Material%20Design%203.penpot) (Material system)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_systems["Design systems"]
  node_design_tokens["Design tokens"]
  node_design_systems["Design systems"]
  node_material_system["Material system"]
end

subgraph group_kits["UI kits"]
  node_ui_kits["UI kits"]
  node_dashboard_kits["Dashboard kits"]
  node_mobile_kits["Mobile kits"]
end

subgraph group_assets["Visual assets"]
  node_icon_sets["Icon sets"]
  node_illustrations["Illustrations"]
  node_charts["Charts"]
end

subgraph group_workflows["Templates and workflows"]
  node_wireframes["Wireframing kits"]
  node_prototypes["Prototype examples"]
  node_playgrounds["Layout playgrounds"]
  node_process_templates["Process templates"]
end

node_user(("Designer"))
node_catalog["Resource catalog<br/>[README.md]"]
node_penpot["Penpot"]
node_shared[("Shared libraries")]

node_user -->|"browses"| node_catalog
node_catalog -->|"offers resources"| node_design_tokens
node_catalog -->|"offers resources"| node_design_systems
node_catalog -->|"offers resources"| node_material_system
node_catalog -->|"offers resources"| node_ui_kits
node_catalog -->|"offers resources"| node_dashboard_kits
node_catalog -->|"offers resources"| node_mobile_kits
node_catalog -->|"offers resources"| node_icon_sets
node_catalog -->|"offers resources"| node_illustrations
node_catalog -->|"offers resources"| node_charts
node_catalog -->|"offers resources"| node_wireframes
node_catalog -->|"offers resources"| node_prototypes
node_catalog -->|"offers resources"| node_playgrounds
node_catalog -->|"offers resources"| node_process_templates
node_user -->|"imports files"| node_penpot
node_user -->|"converts to"| node_shared

click node_catalog "https://github.com/penpot/penpot-files/blob/main/README.md"
click node_design_tokens "https://github.com/penpot/penpot-files/blob/main/Color%20palette%20kit%20-%20design%20tokens%20v1.penpot"
click node_design_systems "https://github.com/penpot/penpot-files/blob/main/Penpot%20-%20Design%20System%20v2.1.penpot"
click node_material_system "https://github.com/penpot/penpot-files/blob/main/Material%20Design%203.penpot"
click node_ui_kits "https://github.com/penpot/penpot-files/blob/main/Essential%20UI%20-%20Figma%20Ui%20Kit%20(Community).penpot"
click node_dashboard_kits "https://github.com/penpot/penpot-files/blob/main/Dashboard%20UI%20Kit%20-%20Dashboard%2C%20Free%20Admin%20Dashboard%20(Community).penpot"
click node_mobile_kits "https://github.com/penpot/penpot-files/blob/main/Android%20UI%20Kit%20(Community).penpot"
click node_icon_sets "https://github.com/penpot/penpot-files/blob/main/Lucide-icons.penpot"
click node_illustrations "https://github.com/penpot/penpot-files/blob/main/Gopher%20illustrations%20v2.penpot"
click node_charts "https://github.com/penpot/penpot-files/blob/main/59%20Charts%20UI%20Responsive%20Components%20Chart.js%20Chartist%20Apex%20Charts%20and%20Recharts%20(Community).penpot"
click node_wireframes "https://github.com/penpot/penpot-files/blob/main/Wireframing%20kit%20v1.1.penpot"
click node_prototypes "https://github.com/penpot/penpot-files/blob/main/Prototype%20examples%20v1.1.penpot"
click node_playgrounds "https://github.com/penpot/penpot-files/blob/main/Flex%20Layout%20Playground%20v2.0.penpot"
click node_process_templates "https://github.com/penpot/penpot-files/blob/main/Business%20Process%20Model%20and%20Notation%20BPMN%20Kit.penpot"

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_design_tokens,node_design_systems,node_material_system toneBlue
class node_ui_kits,node_dashboard_kits,node_mobile_kits,node_shared toneAmber
class node_icon_sets,node_illustrations,node_charts toneMint
class node_wireframes,node_prototypes,node_playgrounds,node_process_templates toneRose
class node_user,node_penpot toneIndigo
class node_catalog toneTeal
```

## Components

### Design systems

- [Design tokens](https://github.com/penpot/penpot-files/blob/main/Color%20palette%20kit%20-%20design%20tokens%20v1.penpot): `Color palette kit - design tokens v1.penpot`
- [Design systems](https://github.com/penpot/penpot-files/blob/main/Penpot%20-%20Design%20System%20v2.1.penpot): `Penpot - Design System v2.1.penpot`
- [Material system](https://github.com/penpot/penpot-files/blob/main/Material%20Design%203.penpot): `Material Design 3.penpot`

### UI kits

- [UI kits](https://github.com/penpot/penpot-files/blob/main/Essential%20UI%20-%20Figma%20Ui%20Kit%20(Community).penpot): `Essential UI - Figma Ui Kit (Community).penpot`
- [Dashboard kits](https://github.com/penpot/penpot-files/blob/main/Dashboard%20UI%20Kit%20-%20Dashboard%2C%20Free%20Admin%20Dashboard%20(Community).penpot): `Dashboard UI Kit - Dashboard, Free Admin Dashboard (Community).penpot`
- [Mobile kits](https://github.com/penpot/penpot-files/blob/main/Android%20UI%20Kit%20(Community).penpot): `Android UI Kit (Community).penpot`

### Visual assets

- [Icon sets](https://github.com/penpot/penpot-files/blob/main/Lucide-icons.penpot): `Lucide-icons.penpot`
- [Illustrations](https://github.com/penpot/penpot-files/blob/main/Gopher%20illustrations%20v2.penpot): `Gopher illustrations v2.penpot`
- [Charts](https://github.com/penpot/penpot-files/blob/main/59%20Charts%20UI%20Responsive%20Components%20Chart.js%20Chartist%20Apex%20Charts%20and%20Recharts%20(Community).penpot): `59 Charts UI Responsive Components Chart.js Chartist Apex Charts and Recharts (Community).penpot`

### Templates and workflows

- [Wireframing kits](https://github.com/penpot/penpot-files/blob/main/Wireframing%20kit%20v1.1.penpot): `Wireframing kit v1.1.penpot`
- [Prototype examples](https://github.com/penpot/penpot-files/blob/main/Prototype%20examples%20v1.1.penpot): `Prototype examples v1.1.penpot`
- [Layout playgrounds](https://github.com/penpot/penpot-files/blob/main/Flex%20Layout%20Playground%20v2.0.penpot): `Flex Layout Playground v2.0.penpot`
- [Process templates](https://github.com/penpot/penpot-files/blob/main/Business%20Process%20Model%20and%20Notation%20BPMN%20Kit.penpot): `Business Process Model and Notation BPMN Kit.penpot`

### Other components

- **Designer**
- [Resource catalog](https://github.com/penpot/penpot-files/blob/main/README.md): `README.md`
- **Penpot**
- **Shared libraries**

## Connections

- Designer → Resource catalog: browses (evidence: `README.md`)
- Resource catalog → Design tokens: offers resources (evidence: `README.md`)
- Resource catalog → Design systems: offers resources (evidence: `README.md`)
- Resource catalog → Material system: offers resources (evidence: `README.md`)
- Resource catalog → UI kits: offers resources (evidence: `README.md`)
- Resource catalog → Dashboard kits: offers resources (evidence: `README.md`)
- Resource catalog → Mobile kits: offers resources (evidence: `README.md`)
- Resource catalog → Icon sets: offers resources (evidence: `README.md`)
- Resource catalog → Illustrations: offers resources (evidence: `README.md`)
- Resource catalog → Charts: offers resources (evidence: `README.md`)
- Resource catalog → Wireframing kits: offers resources (evidence: `README.md`)
- Resource catalog → Prototype examples: offers resources (evidence: `README.md`)
- Resource catalog → Layout playgrounds: offers resources (evidence: `README.md`)
- Resource catalog → Process templates: offers resources (evidence: `README.md`)
- Designer → Penpot: imports files (evidence: `README.md`)
- Designer → Shared libraries: converts to (evidence: `README.md`)
