# mkpaz/atlantafx architecture

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

- Interactive diagram: https://gitdiagram.com/mkpaz/atlantafx
- Repository: https://github.com/mkpaz/atlantafx

## Overview

AtlantaFX is a JavaFX styling and UI-components library, accompanied by a sampler application and optional extension modules. The main developer workflow is to select a theme, apply it to a JavaFX application, and use the library’s controls; the sampler lets users explore themes, controls, and example code. The graph also preserves the documented decorations, validation, Scene Builder, and loading-indicator capabilities. Relationships are limited to explicit README statements because most implementation excerpts are incomplete or do not show those connections.

Main entry points: [`sampler/src/main/java/atlantafx/sampler/Launcher.java`](https://github.com/mkpaz/atlantafx/blob/master/sampler/src/main/java/atlantafx/sampler/Launcher.java) (Sampler application), [`base/src/main/java/atlantafx/base/theme/ThemeManager.java`](https://github.com/mkpaz/atlantafx/blob/master/base/src/main/java/atlantafx/base/theme/ThemeManager.java) (Theme manager), [`sampler/src/main/java/atlantafx/sampler/theme/ThemeRepository.java`](https://github.com/mkpaz/atlantafx/blob/master/sampler/src/main/java/atlantafx/sampler/theme/ThemeRepository.java) (Theme catalog), [`sampler/src/main/java/atlantafx/sampler/page/components`](https://github.com/mkpaz/atlantafx/tree/master/sampler/src/main/java/atlantafx/sampler/page/components) (Control examples)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_theming["Themes and styles"]
  node_theme_manager["Theme manager<br/>[ThemeManager.java]"]
  node_theme_definitions["Theme definitions<br/>[Theme.java]"]
  node_theme_styles["Styles and CSS<br/>[Styles.java]"]
  node_theme_loading["Stylesheet loading"]
  node_theme_resources["Theme resources<br/>[Resources.java]"]
  node_theme_color["Color utilities<br/>[Colour.java]"]
end

subgraph group_controls["JavaFX controls"]
  node_base_controls["Custom controls<br/>[Spacer.java]"]
  node_tab_control["Tab control<br/>[Tab.java]"]
  node_tab_drag["Tab drag behavior"]
end

subgraph group_sampler["Sampler application"]
  node_sampler_app["Sampler application<br/>[Launcher.java]"]
  node_sampler_themes["Theme catalog"]
  node_sampler_theme_manager["Theme customization<br/>[ThemeManager.java]"]
  node_sampler_theme_ui["Theme repository UI"]
  node_sampler_samples["Control examples"]
  node_sampler_showcases["Application showcases"]
end

subgraph group_extensions["UI extensions"]
  node_decorations["Window decorations"]
  node_validation["Fluent validation<br/>[Check.java]"]
  node_scene_builder["Scene Builder plugin<br/>[Agent.java]"]
  node_loading_spins["Loading indicators"]
end

node_developer(("JavaFX developer"))

node_developer -->|"selects theme"| node_theme_manager
node_developer -->|"explores features"| node_sampler_app
node_sampler_app -->|"previews themes"| node_sampler_themes
node_sampler_app -->|"tests controls"| node_sampler_samples
node_sampler_app -->|"views showcases"| node_sampler_showcases
node_developer -->|"uses decorations"| node_decorations
node_developer -->|"uses validation"| node_validation
node_developer -->|"uses integration"| node_scene_builder
node_developer -->|"uses indicators"| node_loading_spins

click node_theme_manager "https://github.com/mkpaz/atlantafx/blob/master/base/src/main/java/atlantafx/base/theme/ThemeManager.java"
click node_theme_definitions "https://github.com/mkpaz/atlantafx/blob/master/base/src/main/java/atlantafx/base/theme/Theme.java"
click node_theme_styles "https://github.com/mkpaz/atlantafx/blob/master/base/src/main/java/atlantafx/base/theme/Styles.java"
click node_theme_loading "https://github.com/mkpaz/atlantafx/blob/master/base/src/main/java/atlantafx/base/theme/StylesheetURLHandler.java"
click node_theme_resources "https://github.com/mkpaz/atlantafx/blob/master/base/src/main/java/atlantafx/base/util/Resources.java"
click node_theme_color "https://github.com/mkpaz/atlantafx/blob/master/base/src/main/java/atlantafx/base/util/Colour.java"
click node_base_controls "https://github.com/mkpaz/atlantafx/blob/master/base/src/main/java/atlantafx/base/controls/Spacer.java"
click node_tab_control "https://github.com/mkpaz/atlantafx/blob/master/base/src/main/java/atlantafx/base/controls/Tab.java"
click node_tab_drag "https://github.com/mkpaz/atlantafx/blob/master/base/src/main/java/atlantafx/base/controls/TabsDragHandler.java"
click node_decorations "https://github.com/mkpaz/atlantafx/blob/master/decorations/src/main/java/atlantafx/decorations/HeaderButtonGroup.java"
click node_validation "https://github.com/mkpaz/atlantafx/blob/master/validation/src/main/java/atlantafx/validation/Check.java"
click node_scene_builder "https://github.com/mkpaz/atlantafx/blob/master/scene-builder/src/main/java/atlantafx/scenebuilder/plugin/Agent.java"
click node_loading_spins "https://github.com/mkpaz/atlantafx/blob/master/spins/src/main/java/atlantafx/spins/LoupeSearchSpin.java"
click node_sampler_app "https://github.com/mkpaz/atlantafx/blob/master/sampler/src/main/java/atlantafx/sampler/Launcher.java"
click node_sampler_themes "https://github.com/mkpaz/atlantafx/blob/master/sampler/src/main/java/atlantafx/sampler/theme/ThemeRepository.java"
click node_sampler_theme_manager "https://github.com/mkpaz/atlantafx/blob/master/sampler/src/main/java/atlantafx/sampler/theme/ThemeManager.java"
click node_sampler_theme_ui "https://github.com/mkpaz/atlantafx/blob/master/sampler/src/main/java/atlantafx/sampler/page/general/ThemeRepoManager.java"
click node_sampler_samples "https://github.com/mkpaz/atlantafx/tree/master/sampler/src/main/java/atlantafx/sampler/page/components"
click node_sampler_showcases "https://github.com/mkpaz/atlantafx/tree/master/sampler/src/main/java/atlantafx/sampler/page/showcase"

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_theme_manager,node_theme_definitions,node_theme_styles,node_theme_loading,node_theme_resources,node_theme_color toneBlue
class node_base_controls,node_tab_control,node_tab_drag toneAmber
class node_sampler_app,node_sampler_themes,node_sampler_theme_manager,node_sampler_theme_ui,node_sampler_samples,node_sampler_showcases toneMint
class node_decorations,node_validation,node_scene_builder,node_loading_spins toneRose
class node_developer toneIndigo
```

## Components

### Themes and styles

- [Theme manager](https://github.com/mkpaz/atlantafx/blob/master/base/src/main/java/atlantafx/base/theme/ThemeManager.java): `base/src/main/java/atlantafx/base/theme/ThemeManager.java`
- [Theme definitions](https://github.com/mkpaz/atlantafx/blob/master/base/src/main/java/atlantafx/base/theme/Theme.java): `base/src/main/java/atlantafx/base/theme/Theme.java`
- [Styles and CSS](https://github.com/mkpaz/atlantafx/blob/master/base/src/main/java/atlantafx/base/theme/Styles.java): `base/src/main/java/atlantafx/base/theme/Styles.java`
- [Stylesheet loading](https://github.com/mkpaz/atlantafx/blob/master/base/src/main/java/atlantafx/base/theme/StylesheetURLHandler.java): `base/src/main/java/atlantafx/base/theme/StylesheetURLHandler.java`
- [Theme resources](https://github.com/mkpaz/atlantafx/blob/master/base/src/main/java/atlantafx/base/util/Resources.java): `base/src/main/java/atlantafx/base/util/Resources.java`
- [Color utilities](https://github.com/mkpaz/atlantafx/blob/master/base/src/main/java/atlantafx/base/util/Colour.java): `base/src/main/java/atlantafx/base/util/Colour.java`

### JavaFX controls

- [Custom controls](https://github.com/mkpaz/atlantafx/blob/master/base/src/main/java/atlantafx/base/controls/Spacer.java): `base/src/main/java/atlantafx/base/controls/Spacer.java`
- [Tab control](https://github.com/mkpaz/atlantafx/blob/master/base/src/main/java/atlantafx/base/controls/Tab.java): `base/src/main/java/atlantafx/base/controls/Tab.java`
- [Tab drag behavior](https://github.com/mkpaz/atlantafx/blob/master/base/src/main/java/atlantafx/base/controls/TabsDragHandler.java): `base/src/main/java/atlantafx/base/controls/TabsDragHandler.java`

### Sampler application

- [Sampler application](https://github.com/mkpaz/atlantafx/blob/master/sampler/src/main/java/atlantafx/sampler/Launcher.java): `sampler/src/main/java/atlantafx/sampler/Launcher.java`
- [Theme catalog](https://github.com/mkpaz/atlantafx/blob/master/sampler/src/main/java/atlantafx/sampler/theme/ThemeRepository.java): `sampler/src/main/java/atlantafx/sampler/theme/ThemeRepository.java`
- [Theme customization](https://github.com/mkpaz/atlantafx/blob/master/sampler/src/main/java/atlantafx/sampler/theme/ThemeManager.java): `sampler/src/main/java/atlantafx/sampler/theme/ThemeManager.java`
- [Theme repository UI](https://github.com/mkpaz/atlantafx/blob/master/sampler/src/main/java/atlantafx/sampler/page/general/ThemeRepoManager.java): `sampler/src/main/java/atlantafx/sampler/page/general/ThemeRepoManager.java`
- [Control examples](https://github.com/mkpaz/atlantafx/tree/master/sampler/src/main/java/atlantafx/sampler/page/components): `sampler/src/main/java/atlantafx/sampler/page/components`
- [Application showcases](https://github.com/mkpaz/atlantafx/tree/master/sampler/src/main/java/atlantafx/sampler/page/showcase): `sampler/src/main/java/atlantafx/sampler/page/showcase`

### UI extensions

- [Window decorations](https://github.com/mkpaz/atlantafx/blob/master/decorations/src/main/java/atlantafx/decorations/HeaderButtonGroup.java): `decorations/src/main/java/atlantafx/decorations/HeaderButtonGroup.java`
- [Fluent validation](https://github.com/mkpaz/atlantafx/blob/master/validation/src/main/java/atlantafx/validation/Check.java): `validation/src/main/java/atlantafx/validation/Check.java`
- [Scene Builder plugin](https://github.com/mkpaz/atlantafx/blob/master/scene-builder/src/main/java/atlantafx/scenebuilder/plugin/Agent.java): `scene-builder/src/main/java/atlantafx/scenebuilder/plugin/Agent.java`
- [Loading indicators](https://github.com/mkpaz/atlantafx/blob/master/spins/src/main/java/atlantafx/spins/LoupeSearchSpin.java): `spins/src/main/java/atlantafx/spins/LoupeSearchSpin.java`

### Other components

- **JavaFX developer**

## Connections

- JavaFX developer → Theme manager: selects theme (evidence: `README.md`)
- JavaFX developer → Sampler application: explores features (evidence: `README.md`)
- Sampler application → Theme catalog: previews themes (evidence: `README.md`)
- Sampler application → Control examples: tests controls (evidence: `README.md`)
- Sampler application → Application showcases: views showcases (evidence: `README.md`)
- JavaFX developer → Window decorations: uses decorations (evidence: `README.md`)
- JavaFX developer → Fluent validation: uses validation (evidence: `README.md`)
- JavaFX developer → Scene Builder plugin: uses integration (evidence: `README.md`)
- JavaFX developer → Loading indicators: uses indicators (evidence: `README.md`)
