# infinum/arkive architecture

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

- Interactive diagram: https://gitdiagram.com/infinum/arkive
- Repository: https://github.com/infinum/arkive

## Overview

Arkive is a Gradle plugin that discovers annotated Compose previews and XML views, generates engine-specific JVM snapshot tests, records UI snapshots, and builds a browsable web catalogue. The graph follows the documented workflow and sampled processor/plugin references; several service and generator implementations are unsampled, so their internal links are omitted or marked unverified.

Main entry points: [`plugin/src/main/java/com/infinum/arkive/plugin/tasks/GenerateShowcaseTask.kt`](https://github.com/infinum/arkive/blob/main/plugin/src/main/java/com/infinum/arkive/plugin/tasks/GenerateShowcaseTask.kt) (Showcase tasks), [`plugin/src/main/java/com/infinum/arkive/plugin/ArkivePlugin.kt`](https://github.com/infinum/arkive/blob/main/plugin/src/main/java/com/infinum/arkive/plugin/ArkivePlugin.kt) (Arkive Gradle plugin), [`processor/src/main/java/com/infinum/arkive/processor/ArkiveProcessor.kt`](https://github.com/infinum/arkive/blob/main/processor/src/main/java/com/infinum/arkive/processor/ArkiveProcessor.kt) (KSP processor), [`testprocessor/src/main/java/com/infinum/arkive/processor/generators/EngineTestGenerator.kt`](https://github.com/infinum/arkive/blob/main/testprocessor/src/main/java/com/infinum/arkive/processor/generators/EngineTestGenerator.kt) (Snapshot test generation)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_discovery["Component discovery"]
  node_annotations["Arkive annotations"]
  node_processor["KSP processor<br/>[ArkiveProcessor.kt]"]
  node_collectors["Preview collectors"]
  node_components["Component repository"]
  node_variant_specs["Compose variants"]
end

subgraph group_capture["Snapshot capture"]
  node_generated_tests["Snapshot test generation"]
  node_roborazzi["Roborazzi engine"]
  node_paparazzi["Paparazzi engine"]
  node_snapshots["Image snapshots"]
  node_uitree["UI tree capture<br/>[UiTreeSession.kt]"]
  node_tree_files["UI tree files<br/>[UiTreeFiles.kt]"]
end

subgraph group_catalogue["Catalogue generation"]
  node_metadata["Component metadata"]
  node_showcase["Showcase generator"]
  node_web_generator["Web showcase"]
  node_web_app["Catalogue interface<br/>[app.js]"]
end

subgraph group_plugin["Gradle integration"]
  node_plugin["Arkive Gradle plugin<br/>[ArkivePlugin.kt]"]
  node_engine_provisioning["Engine provisioning"]
  node_showcase_task["Showcase tasks"]
end

node_developer(("App developer"))
node_browser(("Browser user"))

node_developer -->|"annotates UI"| node_annotations
node_annotations -.->|"marks components"| node_processor
node_processor -->|"loads components"| node_components
node_components -->|"collects and validates"| node_collectors
node_processor -.->|"generates variants"| node_variant_specs
node_plugin -.->|"selects engine"| node_generated_tests
node_generated_tests -.->|"records snapshots"| node_roborazzi
node_generated_tests -.->|"records snapshots"| node_paparazzi
node_plugin -->|"provisions engine"| node_roborazzi
node_roborazzi -->|"applies plugin"| node_engine_provisioning
node_plugin -->|"registers tasks"| node_showcase_task
node_showcase_task -.->|"reads snapshots"| node_snapshots
node_showcase_task -->|"loads UI trees"| node_uitree
node_uitree -->|"writes tree JSON"| node_tree_files
node_showcase_task -.->|"loads metadata"| node_metadata
node_showcase_task -.->|"generates catalogue"| node_showcase
node_showcase -.->|"builds web output"| node_web_generator
node_web_generator -.->|"includes interface"| node_web_app
node_browser -->|"views catalogue"| node_web_app

click node_annotations "https://github.com/infinum/arkive/blob/main/annotations/src/commonMain/kotlin/com/infinum/arkive/annotations/ArkiveComposable.kt"
click node_processor "https://github.com/infinum/arkive/blob/main/processor/src/main/java/com/infinum/arkive/processor/ArkiveProcessor.kt"
click node_collectors "https://github.com/infinum/arkive/blob/main/processor/src/main/java/com/infinum/arkive/processor/collectors/PreviewCollector.kt"
click node_components "https://github.com/infinum/arkive/blob/main/processor/src/main/java/com/infinum/arkive/processor/repository/ComponentRepository.kt"
click node_variant_specs "https://github.com/infinum/arkive/blob/main/processor/src/main/java/com/infinum/arkive/processor/specs/ComposeVariantSpec.kt"
click node_generated_tests "https://github.com/infinum/arkive/blob/main/testprocessor/src/main/java/com/infinum/arkive/processor/generators/EngineTestGenerator.kt"
click node_roborazzi "https://github.com/infinum/arkive/blob/main/plugin/src/main/java/com/infinum/arkive/plugin/engines/SnapshotEngineAdapter.kt"
click node_paparazzi "https://github.com/infinum/arkive/blob/main/plugin/src/main/java/com/infinum/arkive/plugin/engines/SnapshotEngineAdapter.kt"
click node_snapshots "https://github.com/infinum/arkive/blob/main/plugin/src/main/java/com/infinum/arkive/plugin/services/SnapshotsGrabber.kt"
click node_uitree "https://github.com/infinum/arkive/blob/main/composeUtils/src/main/java/com/infinum/arkive/composeutils/uitree/UiTreeSession.kt"
click node_tree_files "https://github.com/infinum/arkive/blob/main/composeUtils/src/main/java/com/infinum/arkive/composeutils/uitree/UiTreeFiles.kt"
click node_metadata "https://github.com/infinum/arkive/blob/main/metadata/src/main/java/com/infinum/arkive/metadata/model/ComponentsMetaData.kt"
click node_showcase "https://github.com/infinum/arkive/blob/main/plugin/src/main/java/com/infinum/arkive/plugin/generators/ShowcaseGenerator.kt"
click node_web_generator "https://github.com/infinum/arkive/blob/main/plugin/src/main/java/com/infinum/arkive/plugin/generators/ShowcaseWebGenerator.kt"
click node_web_app "https://github.com/infinum/arkive/blob/main/plugin/src/main/resources/web/app.js"
click node_plugin "https://github.com/infinum/arkive/blob/main/plugin/src/main/java/com/infinum/arkive/plugin/ArkivePlugin.kt"
click node_engine_provisioning "https://github.com/infinum/arkive/blob/main/plugin/src/main/java/com/infinum/arkive/plugin/engines/EnginePluginProvisioning.kt"
click node_showcase_task "https://github.com/infinum/arkive/blob/main/plugin/src/main/java/com/infinum/arkive/plugin/tasks/GenerateShowcaseTask.kt"

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_annotations,node_processor,node_collectors,node_components,node_variant_specs,node_browser toneBlue
class node_generated_tests,node_roborazzi,node_paparazzi,node_snapshots,node_uitree,node_tree_files toneAmber
class node_metadata,node_showcase,node_web_generator,node_web_app toneMint
class node_plugin,node_engine_provisioning,node_showcase_task toneRose
class node_developer toneIndigo
```

## Components

### Component discovery

- [Arkive annotations](https://github.com/infinum/arkive/blob/main/annotations/src/commonMain/kotlin/com/infinum/arkive/annotations/ArkiveComposable.kt): `annotations/src/commonMain/kotlin/com/infinum/arkive/annotations/ArkiveComposable.kt`
- [KSP processor](https://github.com/infinum/arkive/blob/main/processor/src/main/java/com/infinum/arkive/processor/ArkiveProcessor.kt): `processor/src/main/java/com/infinum/arkive/processor/ArkiveProcessor.kt`
- [Preview collectors](https://github.com/infinum/arkive/blob/main/processor/src/main/java/com/infinum/arkive/processor/collectors/PreviewCollector.kt): `processor/src/main/java/com/infinum/arkive/processor/collectors/PreviewCollector.kt`
- [Component repository](https://github.com/infinum/arkive/blob/main/processor/src/main/java/com/infinum/arkive/processor/repository/ComponentRepository.kt): `processor/src/main/java/com/infinum/arkive/processor/repository/ComponentRepository.kt`
- [Compose variants](https://github.com/infinum/arkive/blob/main/processor/src/main/java/com/infinum/arkive/processor/specs/ComposeVariantSpec.kt): `processor/src/main/java/com/infinum/arkive/processor/specs/ComposeVariantSpec.kt`

### Snapshot capture

- [Snapshot test generation](https://github.com/infinum/arkive/blob/main/testprocessor/src/main/java/com/infinum/arkive/processor/generators/EngineTestGenerator.kt): `testprocessor/src/main/java/com/infinum/arkive/processor/generators/EngineTestGenerator.kt`
- [Roborazzi engine](https://github.com/infinum/arkive/blob/main/plugin/src/main/java/com/infinum/arkive/plugin/engines/SnapshotEngineAdapter.kt): `plugin/src/main/java/com/infinum/arkive/plugin/engines/SnapshotEngineAdapter.kt`
- [Paparazzi engine](https://github.com/infinum/arkive/blob/main/plugin/src/main/java/com/infinum/arkive/plugin/engines/SnapshotEngineAdapter.kt): `plugin/src/main/java/com/infinum/arkive/plugin/engines/SnapshotEngineAdapter.kt`
- [Image snapshots](https://github.com/infinum/arkive/blob/main/plugin/src/main/java/com/infinum/arkive/plugin/services/SnapshotsGrabber.kt): `plugin/src/main/java/com/infinum/arkive/plugin/services/SnapshotsGrabber.kt`
- [UI tree capture](https://github.com/infinum/arkive/blob/main/composeUtils/src/main/java/com/infinum/arkive/composeutils/uitree/UiTreeSession.kt): `composeUtils/src/main/java/com/infinum/arkive/composeutils/uitree/UiTreeSession.kt`
- [UI tree files](https://github.com/infinum/arkive/blob/main/composeUtils/src/main/java/com/infinum/arkive/composeutils/uitree/UiTreeFiles.kt): `composeUtils/src/main/java/com/infinum/arkive/composeutils/uitree/UiTreeFiles.kt`

### Catalogue generation

- [Component metadata](https://github.com/infinum/arkive/blob/main/metadata/src/main/java/com/infinum/arkive/metadata/model/ComponentsMetaData.kt): `metadata/src/main/java/com/infinum/arkive/metadata/model/ComponentsMetaData.kt`
- [Showcase generator](https://github.com/infinum/arkive/blob/main/plugin/src/main/java/com/infinum/arkive/plugin/generators/ShowcaseGenerator.kt): `plugin/src/main/java/com/infinum/arkive/plugin/generators/ShowcaseGenerator.kt`
- [Web showcase](https://github.com/infinum/arkive/blob/main/plugin/src/main/java/com/infinum/arkive/plugin/generators/ShowcaseWebGenerator.kt): `plugin/src/main/java/com/infinum/arkive/plugin/generators/ShowcaseWebGenerator.kt`
- [Catalogue interface](https://github.com/infinum/arkive/blob/main/plugin/src/main/resources/web/app.js): `plugin/src/main/resources/web/app.js`

### Gradle integration

- [Arkive Gradle plugin](https://github.com/infinum/arkive/blob/main/plugin/src/main/java/com/infinum/arkive/plugin/ArkivePlugin.kt): `plugin/src/main/java/com/infinum/arkive/plugin/ArkivePlugin.kt`
- [Engine provisioning](https://github.com/infinum/arkive/blob/main/plugin/src/main/java/com/infinum/arkive/plugin/engines/EnginePluginProvisioning.kt): `plugin/src/main/java/com/infinum/arkive/plugin/engines/EnginePluginProvisioning.kt`
- [Showcase tasks](https://github.com/infinum/arkive/blob/main/plugin/src/main/java/com/infinum/arkive/plugin/tasks/GenerateShowcaseTask.kt): `plugin/src/main/java/com/infinum/arkive/plugin/tasks/GenerateShowcaseTask.kt`

### Other components

- **App developer**
- **Browser user**

## Connections

- App developer → Arkive annotations: annotates UI (evidence: `README.md`)
- Arkive annotations → KSP processor: marks components
- KSP processor → Component repository: loads components (evidence: `processor/src/main/java/com/infinum/arkive/processor/ArkiveProcessor.kt`)
- Component repository → Preview collectors: collects and validates (evidence: `processor/src/main/java/com/infinum/arkive/processor/repository/ComponentRepository.kt`)
- KSP processor → Compose variants: generates variants
- Arkive Gradle plugin → Snapshot test generation: selects engine
- Snapshot test generation → Roborazzi engine: records snapshots
- Snapshot test generation → Paparazzi engine: records snapshots
- Arkive Gradle plugin → Roborazzi engine: provisions engine (evidence: `plugin/src/main/java/com/infinum/arkive/plugin/ArkivePlugin.kt`)
- Roborazzi engine → Engine provisioning: applies plugin (evidence: `plugin/src/main/java/com/infinum/arkive/plugin/engines/SnapshotEngineAdapter.kt`)
- Arkive Gradle plugin → Showcase tasks: registers tasks (evidence: `plugin/src/main/java/com/infinum/arkive/plugin/ArkivePlugin.kt`)
- Showcase tasks → Image snapshots: reads snapshots
- Showcase tasks → UI tree capture: loads UI trees (evidence: `plugin/src/main/java/com/infinum/arkive/plugin/tasks/GenerateShowcaseTask.kt`)
- UI tree capture → UI tree files: writes tree JSON (evidence: `composeUtils/src/main/java/com/infinum/arkive/composeutils/uitree/UiTreeSession.kt`)
- Showcase tasks → Component metadata: loads metadata
- Showcase tasks → Showcase generator: generates catalogue
- Showcase generator → Web showcase: builds web output
- Web showcase → Catalogue interface: includes interface
- Browser user → Catalogue interface: views catalogue (evidence: `README.md`)
