# semantic-org/semantic-ui architecture

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

- Interactive diagram: https://gitdiagram.com/semantic-org/semantic-ui
- Repository: https://github.com/semantic-org/semantic-ui

## Overview

Semantic UI is a themable front-end framework: developers use concise HTML and JavaScript UI components, with responsive/theming capabilities documented in the README. This checkout also provides project setup, asset building and RTL packaging, plus maintainer release tooling. The source excerpts show installer copies and build/package actions; many UI modules and admin tasks are indexed but unsampled, so their internal call relationships are not inferred.

Main entry points: [`tasks/install.js`](https://github.com/semantic-org/semantic-ui/blob/master/tasks/install.js) (Project installer), [`tasks/rtl/build.js`](https://github.com/semantic-org/semantic-ui/blob/master/tasks/rtl/build.js) (RTL build), [`tasks/collections/admin.js`](https://github.com/semantic-org/semantic-ui/blob/master/tasks/collections/admin.js) (Admin task registration), [`tasks/build.js`](https://github.com/semantic-org/semantic-ui/blob/master/tasks/build.js) (Build tasks)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_ui["UI framework"]
  node_ui_framework["UI framework"]
  node_behaviors["Shared behaviors"]
  node_site_globals["Site globals<br/>[site.js]"]
  node_navigation_controls["Navigation controls<br/>[dropdown.js]"]
  node_overlays["Overlays<br/>[popup.js]"]
  node_forms_search["Forms and search<br/>[search.js]"]
  node_motion_layout["Motion and layout<br/>[transition.js]"]
end

subgraph group_setup["Project setup"]
  node_project_installer["Project installer<br/>[install.js]"]
  node_setup_config["Setup configuration<br/>[install.js]"]
  node_user_config["User configuration<br/>[user.js]"]
end

subgraph group_build["Build and packaging"]
  node_build_tasks["Build tasks<br/>[build.js]"]
  node_rtl_build["RTL build<br/>[build.js]"]
  node_rtl_watch["RTL watcher<br/>[watch.js]"]
  node_package_tasks["Package assembly<br/>[internal.js]"]
  node_task_settings["Task settings<br/>[tasks.js]"]
end

subgraph group_release["Maintainer releases"]
  node_admin_tasks["Admin task registration<br/>[admin.js]"]
  node_component_release["Component releases<br/>[create.js]"]
  node_distribution_release["Distribution releases<br/>[create.js]"]
  node_release_config["Release configuration<br/>[release.js]"]
  node_github_config["GitHub settings<br/>[github.js]"]
  node_publish["Publish updates<br/>[publish.js]"]
end

node_developer(("Developer"))

node_developer -->|"uses"| node_ui_framework
node_developer -->|"sets up"| node_project_installer
node_project_installer -->|"reads setup"| node_setup_config
node_project_installer -->|"reads config"| node_user_config
node_project_installer -->|"copies definitions"| node_ui_framework
node_project_installer -->|"starts build"| node_build_tasks
node_build_tasks -->|"reads config"| node_user_config
node_build_tasks -->|"invokes RTL"| node_rtl_build
node_rtl_build -->|"reads config"| node_user_config
node_rtl_build -->|"uses settings"| node_task_settings
node_rtl_build -->|"starts packaging"| node_package_tasks
node_rtl_watch -->|"starts packaging"| node_package_tasks
node_admin_tasks -->|"registers task"| node_component_release
node_admin_tasks -->|"registers task"| node_distribution_release
node_component_release -->|"reads settings"| node_release_config
node_distribution_release -->|"reads settings"| node_release_config
node_admin_tasks -->|"registers task"| node_publish
node_publish -->|"updates components"| node_component_release
node_publish -->|"updates distributions"| node_distribution_release

click node_ui_framework "https://github.com/semantic-org/semantic-ui/tree/master/src/definitions"
click node_behaviors "https://github.com/semantic-org/semantic-ui/tree/master/src/definitions/behaviors"
click node_site_globals "https://github.com/semantic-org/semantic-ui/blob/master/src/definitions/globals/site.js"
click node_navigation_controls "https://github.com/semantic-org/semantic-ui/blob/master/src/definitions/modules/dropdown.js"
click node_overlays "https://github.com/semantic-org/semantic-ui/blob/master/src/definitions/modules/popup.js"
click node_forms_search "https://github.com/semantic-org/semantic-ui/blob/master/src/definitions/modules/search.js"
click node_motion_layout "https://github.com/semantic-org/semantic-ui/blob/master/src/definitions/modules/transition.js"
click node_project_installer "https://github.com/semantic-org/semantic-ui/blob/master/tasks/install.js"
click node_setup_config "https://github.com/semantic-org/semantic-ui/blob/master/tasks/config/project/install.js"
click node_user_config "https://github.com/semantic-org/semantic-ui/blob/master/tasks/config/user.js"
click node_build_tasks "https://github.com/semantic-org/semantic-ui/blob/master/tasks/build.js"
click node_rtl_build "https://github.com/semantic-org/semantic-ui/blob/master/tasks/rtl/build.js"
click node_rtl_watch "https://github.com/semantic-org/semantic-ui/blob/master/tasks/rtl/watch.js"
click node_package_tasks "https://github.com/semantic-org/semantic-ui/blob/master/tasks/collections/internal.js"
click node_task_settings "https://github.com/semantic-org/semantic-ui/blob/master/tasks/config/tasks.js"
click node_admin_tasks "https://github.com/semantic-org/semantic-ui/blob/master/tasks/collections/admin.js"
click node_component_release "https://github.com/semantic-org/semantic-ui/blob/master/tasks/admin/components/create.js"
click node_distribution_release "https://github.com/semantic-org/semantic-ui/blob/master/tasks/admin/distributions/create.js"
click node_release_config "https://github.com/semantic-org/semantic-ui/blob/master/tasks/config/admin/release.js"
click node_github_config "https://github.com/semantic-org/semantic-ui/blob/master/tasks/config/admin/github.js"
click node_publish "https://github.com/semantic-org/semantic-ui/blob/master/tasks/admin/publish.js"

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_ui_framework,node_behaviors,node_site_globals,node_navigation_controls,node_overlays,node_forms_search,node_motion_layout toneBlue
class node_project_installer,node_setup_config,node_user_config toneAmber
class node_build_tasks,node_rtl_build,node_rtl_watch,node_package_tasks,node_task_settings toneMint
class node_admin_tasks,node_component_release,node_distribution_release,node_release_config,node_github_config,node_publish toneRose
class node_developer toneIndigo
```

## Components

### UI framework

- [UI framework](https://github.com/semantic-org/semantic-ui/tree/master/src/definitions): `src/definitions`
- [Shared behaviors](https://github.com/semantic-org/semantic-ui/tree/master/src/definitions/behaviors): `src/definitions/behaviors`
- [Site globals](https://github.com/semantic-org/semantic-ui/blob/master/src/definitions/globals/site.js): `src/definitions/globals/site.js`
- [Navigation controls](https://github.com/semantic-org/semantic-ui/blob/master/src/definitions/modules/dropdown.js): `src/definitions/modules/dropdown.js`
- [Overlays](https://github.com/semantic-org/semantic-ui/blob/master/src/definitions/modules/popup.js): `src/definitions/modules/popup.js`
- [Forms and search](https://github.com/semantic-org/semantic-ui/blob/master/src/definitions/modules/search.js): `src/definitions/modules/search.js`
- [Motion and layout](https://github.com/semantic-org/semantic-ui/blob/master/src/definitions/modules/transition.js): `src/definitions/modules/transition.js`

### Project setup

- [Project installer](https://github.com/semantic-org/semantic-ui/blob/master/tasks/install.js): `tasks/install.js`
- [Setup configuration](https://github.com/semantic-org/semantic-ui/blob/master/tasks/config/project/install.js): `tasks/config/project/install.js`
- [User configuration](https://github.com/semantic-org/semantic-ui/blob/master/tasks/config/user.js): `tasks/config/user.js`

### Build and packaging

- [Build tasks](https://github.com/semantic-org/semantic-ui/blob/master/tasks/build.js): `tasks/build.js`
- [RTL build](https://github.com/semantic-org/semantic-ui/blob/master/tasks/rtl/build.js): `tasks/rtl/build.js`
- [RTL watcher](https://github.com/semantic-org/semantic-ui/blob/master/tasks/rtl/watch.js): `tasks/rtl/watch.js`
- [Package assembly](https://github.com/semantic-org/semantic-ui/blob/master/tasks/collections/internal.js): `tasks/collections/internal.js`
- [Task settings](https://github.com/semantic-org/semantic-ui/blob/master/tasks/config/tasks.js): `tasks/config/tasks.js`

### Maintainer releases

- [Admin task registration](https://github.com/semantic-org/semantic-ui/blob/master/tasks/collections/admin.js): `tasks/collections/admin.js`
- [Component releases](https://github.com/semantic-org/semantic-ui/blob/master/tasks/admin/components/create.js): `tasks/admin/components/create.js`
- [Distribution releases](https://github.com/semantic-org/semantic-ui/blob/master/tasks/admin/distributions/create.js): `tasks/admin/distributions/create.js`
- [Release configuration](https://github.com/semantic-org/semantic-ui/blob/master/tasks/config/admin/release.js): `tasks/config/admin/release.js`
- [GitHub settings](https://github.com/semantic-org/semantic-ui/blob/master/tasks/config/admin/github.js): `tasks/config/admin/github.js`
- [Publish updates](https://github.com/semantic-org/semantic-ui/blob/master/tasks/admin/publish.js): `tasks/admin/publish.js`

### Other components

- **Developer**

## Connections

- Developer → UI framework: uses (evidence: `README.md`)
- Developer → Project installer: sets up (evidence: `README.md`)
- Project installer → Setup configuration: reads setup (evidence: `tasks/install.js`)
- Project installer → User configuration: reads config (evidence: `tasks/install.js`)
- Project installer → UI framework: copies definitions (evidence: `tasks/install.js`)
- Project installer → Build tasks: starts build (evidence: `tasks/install.js`)
- Build tasks → User configuration: reads config (evidence: `tasks/build.js`)
- Build tasks → RTL build: invokes RTL (evidence: `tasks/build.js`)
- RTL build → User configuration: reads config (evidence: `tasks/rtl/build.js`)
- RTL build → Task settings: uses settings (evidence: `tasks/rtl/build.js`)
- RTL build → Package assembly: starts packaging (evidence: `tasks/rtl/build.js`)
- RTL watcher → Package assembly: starts packaging (evidence: `tasks/rtl/watch.js`)
- Admin task registration → Component releases: registers task (evidence: `tasks/collections/admin.js`)
- Admin task registration → Distribution releases: registers task (evidence: `tasks/collections/admin.js`)
- Component releases → Release configuration: reads settings (evidence: `tasks/admin/components/create.js`)
- Distribution releases → Release configuration: reads settings (evidence: `tasks/admin/distributions/create.js`)
- Admin task registration → Publish updates: registers task (evidence: `tasks/collections/admin.js`)
- Publish updates → Component releases: updates components (evidence: `tasks/admin/publish.js`)
- Publish updates → Distribution releases: updates distributions (evidence: `tasks/admin/publish.js`)
