# Atlas.Ui

> The QML module every Atlas app imports, with windows, pages, buttons, fields, lists, dialogs, charts and the style and services behind them; how to install it, check it and find a type.

Atlas.Ui is the QML module of Atlas controls. Every Atlas app imports it, so they all share one look, one set of keyboard and accessibility rules and one copy on disk. It is a QML module installed next to Qt's own, like Kirigami. Its URI is `Atlas.Ui`.

## Install and import

Install the `atlas-ui` package (Fedora 44, Qt 6.11). It brings in the Material Symbols fonts (`atlas-symbols-fonts`), Kirigami, IBM Plex Sans and JetBrains Mono.

```sh
sudo dnf install atlas-ui
```

The module lives in Qt's QML directory (`/usr/lib64/qt6/qml/Atlas/Ui/`). An app writes `import Atlas.Ui` in QML and links nothing: the QML engine loads the plugin. There is no CMake package and no devel package.

```qml
import QtQuick
import Atlas.Ui

AtlasWindow {
    title: qsTr("Hello")
    visible: true

    AtlasPage {
        anchors.fill: parent
        title: qsTr("Hello")

        PrimaryButton {
            text: qsTr("Say hello")
            symbol: Symbols.WavingHand
        }
    }
}
```

> [!NOTE]
> `import Atlas.Ui` wins over the QML files in an app's own directory. An app file named like an Atlas.Ui type (say `SearchField.qml`) is hidden by it. New Atlas.Ui types are named `Atlas<Name>` to keep clear of apps' names; see [Compatibility](https://atlasos.eterneon.net/framework/atlas-ui/compatibility.md).

## Check the module at configure time

The [app template](https://atlasos.eterneon.net/framework/template.md) fails the CMake configure with a plain message when the module is missing. qmlcachegen and qmllint find it in Qt's QML directory by themselves, so the app's `<app>_qmllint` target checks the app's QML against it.

```cmake
if(NOT EXISTS "${QT6_INSTALL_PREFIX}/${QT6_INSTALL_QML}/Atlas/Ui/qmldir")
    message(FATAL_ERROR "Atlas.Ui is not installed: dnf install atlas-ui")
endif()
```

## Version rule

Atlas.Ui only ever adds API. An app that uses something added after 1.0.0 states the oldest version it works with in two places, and keeps them equal:

- `Requires: atlas-ui >= X.Y.Z` (and `BuildRequires`) in the app's RPM spec, so dnf installs a new enough one;
- `ui: "X.Y.Z"` in the app's `app!` call, so at startup an older Atlas.Ui, installed some other way, gives a plain error window instead of a broken one.

`AtlasApp.uiVersion` reports the installed version at run time. Each page says which version added its type (`since`).

## Guides

- [Design rules](https://atlasos.eterneon.net/framework/atlas-ui/design-rules.md): what every Atlas app does.
- [Style and theming](https://atlasos.eterneon.net/framework/atlas-ui/style-and-theming.md): colours, spacing, radii, density, blur and text scale.
- [Motion](https://atlasos.eterneon.net/framework/atlas-ui/motion.md): springs, reduced motion and the violet to sakura gradient.
- [Compatibility](https://atlasos.eterneon.net/framework/atlas-ui/compatibility.md): the API contract and what it means for an app.
- [Accessibility](https://atlasos.eterneon.net/framework/atlas-ui/accessibility.md): focus, roles, names, right-to-left and the framework's tests.

## The types

Every type has a page. The groups below are the sidebar sections.

### Windows and pages

- [AtlasWindow](https://atlasos.eterneon.net/framework/atlas-ui/atlas-window.md): The application window: blurred or opaque by the shared switch, remembers its size, and goes frameless with a header bar.
- [AtlasHeaderBar](https://atlasos.eterneon.net/framework/atlas-ui/atlas-header-bar.md): The merged header of a frameless window: window menu, title, tools and window buttons.
- [AtlasWindowButtons](https://atlasos.eterneon.net/framework/atlas-ui/atlas-window-buttons.md): Minimise, maximise and close buttons drawn like the AtlasOS window decoration.
- [AtlasWindowChrome](https://atlasos.eterneon.net/framework/atlas-ui/atlas-window-chrome.md): Singleton with the desktop's caption-button layout and whether a global menu exists.
- [AtlasPage](https://atlasos.eterneon.net/framework/atlas-ui/atlas-page.md): A scrolling page with a large bold title and centred margins.
- [AtlasAboutPage](https://atlasos.eterneon.net/framework/atlas-ui/atlas-about-page.md): A ready-made About page for any app.
- [AtlasOnboarding](https://atlasos.eterneon.net/framework/atlas-ui/atlas-onboarding.md): A setup scaffold: steps, one page at a time, Back, Skip and Next.
- [StatusBar](https://atlasos.eterneon.net/framework/atlas-ui/status-bar.md): A slim bottom bar of cells such as line, column and encoding.
- [StatusBarItem](https://atlasos.eterneon.net/framework/atlas-ui/status-bar-item.md): One cell of a status bar, optionally clickable or with a menu.

### Buttons

- [AtlasButton](https://atlasos.eterneon.net/framework/atlas-ui/atlas-button.md): The shared base of the buttons, with four variants and a busy state.
- [PrimaryButton](https://atlasos.eterneon.net/framework/atlas-ui/primary-button.md): The filled accent button for the main action.
- [SecondaryButton](https://atlasos.eterneon.net/framework/atlas-ui/secondary-button.md): The soft, tinted button for ordinary actions.
- [TextButton](https://atlasos.eterneon.net/framework/atlas-ui/text-button.md): A button that looks like a link.
- [MenuButton](https://atlasos.eterneon.net/framework/atlas-ui/menu-button.md): A button that opens a menu.
- [ToolbarButton](https://atlasos.eterneon.net/framework/atlas-ui/toolbar-button.md): A small icon button for toolbars that never takes the editor's focus.
- [AtlasSplitButton](https://atlasos.eterneon.net/framework/atlas-ui/atlas-split-button.md): A main button joined to an arrow that opens a menu of variants.
- [AtlasInstallButton](https://atlasos.eterneon.net/framework/atlas-ui/atlas-install-button.md): An install button with progress inside it and states for install, update, open and retry.
- [AtlasCopyButton](https://atlasos.eterneon.net/framework/atlas-ui/atlas-copy-button.md): An icon button that copies text and shows a check mark.
- [AtlasSwitch](https://atlasos.eterneon.net/framework/atlas-ui/atlas-switch.md): A round switch.
- [AtlasCheckBox](https://atlasos.eterneon.net/framework/atlas-ui/atlas-check-box.md): A check box with an optional partly-checked state.
- [AtlasRadioButton](https://atlasos.eterneon.net/framework/atlas-ui/atlas-radio-button.md): A radio button; siblings form a group.
- [AtlasSegmentedControl](https://atlasos.eterneon.net/framework/atlas-ui/atlas-segmented-control.md): Joined segments with one selected.
- [AtlasChip](https://atlasos.eterneon.net/framework/atlas-ui/atlas-chip.md): A small chip for a tag, filter or value.
- [AtlasChipGroup](https://atlasos.eterneon.net/framework/atlas-ui/atlas-chip-group.md): A wrapping group of chips, optionally one-of.

### Fields and pickers

- [AtlasTextField](https://atlasos.eterneon.net/framework/atlas-ui/atlas-text-field.md): A single-line text field with error, clear button, prefix, suffix and counter.
- [AtlasTextArea](https://atlasos.eterneon.net/framework/atlas-ui/atlas-text-area.md): A multi-line text field.
- [AtlasPasswordField](https://atlasos.eterneon.net/framework/atlas-ui/atlas-password-field.md): A password field with a show toggle.
- [SearchField](https://atlasos.eterneon.net/framework/atlas-ui/search-field.md): A search field with a debounced query.
- [AtlasAutocompleteField](https://atlasos.eterneon.net/framework/atlas-ui/atlas-autocomplete-field.md): A text field that suggests completions.
- [AtlasComboBox](https://atlasos.eterneon.net/framework/atlas-ui/atlas-combo-box.md): A drop-down list, optionally filterable.
- [AtlasSpinBox](https://atlasos.eterneon.net/framework/atlas-ui/atlas-spin-box.md): A whole-number field with minus and plus buttons.
- [AtlasDoubleSpinBox](https://atlasos.eterneon.net/framework/atlas-ui/atlas-double-spin-box.md): A number field with decimals.
- [AtlasSlider](https://atlasos.eterneon.net/framework/atlas-ui/atlas-slider.md): A slider with an accent track, horizontal or vertical.
- [AtlasRating](https://atlasos.eterneon.net/framework/atlas-ui/atlas-rating.md): Zero to five stars, read-only or editable.
- [AtlasDatePicker](https://atlasos.eterneon.net/framework/atlas-ui/atlas-date-picker.md): A date field that opens a calendar.
- [AtlasCalendar](https://atlasos.eterneon.net/framework/atlas-ui/atlas-calendar.md): A month grid for choosing a day.
- [AtlasTimePicker](https://atlasos.eterneon.net/framework/atlas-ui/atlas-time-picker.md): Hours and minutes, with AM/PM in 12-hour mode.
- [AtlasColorField](https://atlasos.eterneon.net/framework/atlas-ui/atlas-color-field.md): A colour chooser with a palette and a hex field.
- [AtlasFileField](https://atlasos.eterneon.net/framework/atlas-ui/atlas-file-field.md): A file chooser with a Browse button.
- [AtlasFolderField](https://atlasos.eterneon.net/framework/atlas-ui/atlas-folder-field.md): A folder chooser with a Browse button.
- [AtlasFontPicker](https://atlasos.eterneon.net/framework/atlas-ui/atlas-font-picker.md): A font chooser with a searchable list of families.
- [AtlasShortcutField](https://atlasos.eterneon.net/framework/atlas-ui/atlas-shortcut-field.md): A field that records a key combination and reports conflicts.
- [AtlasDropZone](https://atlasos.eterneon.net/framework/atlas-ui/atlas-drop-zone.md): An area that files can be dropped on.

### Lists and tables

- [AtlasListView](https://atlasos.eterneon.net/framework/atlas-ui/atlas-list-view.md): A ListView in the Atlas look with selection, type-ahead and drag reordering.
- [AtlasTreeView](https://atlasos.eterneon.net/framework/atlas-ui/atlas-tree-view.md): A tree view in the Atlas list look.
- [AtlasTreeModel](https://atlasos.eterneon.net/framework/atlas-ui/atlas-tree-model.md): A read-only tree model built from nested JavaScript objects, for the tree view.
- [DataTable](https://atlasos.eterneon.net/framework/atlas-ui/data-table.md): A sortable table that only makes the rows on screen.
- [AtlasIconGrid](https://atlasos.eterneon.net/framework/atlas-ui/atlas-icon-grid.md): A scrolling grid of icons over names.
- [AtlasDetailGrid](https://atlasos.eterneon.net/framework/atlas-ui/atlas-detail-grid.md): Names and values in aligned columns.
- [AtlasSearchResults](https://atlasos.eterneon.net/framework/atlas-ui/atlas-search-results.md): A launcher's results list with sections and shortcut hints.
- [AtlasAppCard](https://atlasos.eterneon.net/framework/atlas-ui/atlas-app-card.md): A store card for one app.
- [AtlasScreenshotCarousel](https://atlasos.eterneon.net/framework/atlas-ui/atlas-screenshot-carousel.md): Screenshots shown one at a time.

### Navigation

- [AtlasSidebar](https://atlasos.eterneon.net/framework/atlas-ui/atlas-sidebar.md): A scrolling sidebar for sidebar items and groups.
- [SidebarItem](https://atlasos.eterneon.net/framework/atlas-ui/sidebar-item.md): One sidebar entry with a live value and badge.
- [SidebarGroup](https://atlasos.eterneon.net/framework/atlas-ui/sidebar-group.md): A foldable group of sidebar entries.
- [StepItem](https://atlasos.eterneon.net/framework/atlas-ui/step-item.md): One step of a setup sidebar: done, current or to come.
- [TabBar](https://atlasos.eterneon.net/framework/atlas-ui/tab-bar.md): Document tabs with an unsaved dot and a close button.
- [AtlasViewSwitcher](https://atlasos.eterneon.net/framework/atlas-ui/atlas-view-switcher.md): Page tabs for the top of a window.
- [AtlasNavigationStack](https://atlasos.eterneon.net/framework/atlas-ui/atlas-navigation-stack.md): Drill-down pages with a Back button.
- [AtlasBreadcrumb](https://atlasos.eterneon.net/framework/atlas-ui/atlas-breadcrumb.md): A path bar that folds its middle into a menu.
- [AtlasToolbar](https://atlasos.eterneon.net/framework/atlas-ui/atlas-toolbar.md): A bar of actions that moves what does not fit into a menu.
- [AtlasFloatingToolbar](https://atlasos.eterneon.net/framework/atlas-ui/atlas-floating-toolbar.md): A capsule of icon buttons that floats over content.

### Menus, dialogs and popups

- [ContextMenu](https://atlasos.eterneon.net/framework/atlas-ui/context-menu.md): A right-click menu.
- [ContextMenuItem](https://atlasos.eterneon.net/framework/atlas-ui/context-menu-item.md): One row of a context menu.
- [ContextMenuSeparator](https://atlasos.eterneon.net/framework/atlas-ui/context-menu-separator.md): A divider line in a context menu.
- [AtlasAppMenu](https://atlasos.eterneon.net/framework/atlas-ui/atlas-app-menu.md): The app's menus for the header bar or the desktop's global menu.
- [AtlasAction](https://atlasos.eterneon.net/framework/atlas-ui/atlas-action.md): One user action shared by buttons, menus and the keyboard.
- [AtlasDialog](https://atlasos.eterneon.net/framework/atlas-ui/atlas-dialog.md): The general modal dialog.
- [ConfirmDialog](https://atlasos.eterneon.net/framework/atlas-ui/confirm-dialog.md): A modal question with small rounded buttons.
- [AtlasPopover](https://atlasos.eterneon.net/framework/atlas-ui/atlas-popover.md): A raised card that opens next to a control.
- [AtlasToolTip](https://atlasos.eterneon.net/framework/atlas-ui/atlas-tool-tip.md): A hint on a raised card.
- [AtlasCommandPalette](https://atlasos.eterneon.net/framework/atlas-ui/atlas-command-palette.md): A searchable list of the app's actions, opened with Ctrl+K.
- [AtlasShortcutsDialog](https://atlasos.eterneon.net/framework/atlas-ui/atlas-shortcuts-dialog.md): A modal list of the app's keyboard shortcuts.

### Feedback and status

- [InfoBanner](https://atlasos.eterneon.net/framework/atlas-ui/info-banner.md): An inline info, warning or error banner with actions.
- [Toast](https://atlasos.eterneon.net/framework/atlas-ui/toast.md): A short message that goes by itself.
- [AtlasProgressBar](https://atlasos.eterneon.net/framework/atlas-ui/atlas-progress-bar.md): A progress bar with indeterminate, paused and error states.
- [AtlasSpinner](https://atlasos.eterneon.net/framework/atlas-ui/atlas-spinner.md): A busy indicator.
- [AtlasPlaceholder](https://atlasos.eterneon.net/framework/atlas-ui/atlas-placeholder.md): Skeleton bars shown while content loads.
- [AtlasEmptyState](https://atlasos.eterneon.net/framework/atlas-ui/atlas-empty-state.md): What a list shows when it has nothing.
- [AtlasBadge](https://atlasos.eterneon.net/framework/atlas-ui/atlas-badge.md): A small pill label for a status or count.
- [AtlasAvatar](https://atlasos.eterneon.net/framework/atlas-ui/atlas-avatar.md): A round picture of a person, with initials as the fallback.
- [AtlasStat](https://atlasos.eterneon.net/framework/atlas-ui/atlas-stat.md): A figure with a label, a unit, a trend and a sparkline.
- [AtlasEdgeGlow](https://atlasos.eterneon.net/framework/atlas-ui/atlas-edge-glow.md): The violet-to-sakura glow for "the system is working for you now".
- [StatusHero](https://atlasos.eterneon.net/framework/atlas-ui/status-hero.md): A big centred status: icon, headline, subtitle and actions.

### Charts

- [LiveChart](https://atlasos.eterneon.net/framework/atlas-ui/live-chart.md): A live line chart.
- [LiveChartItem](https://atlasos.eterneon.net/framework/atlas-ui/live-chart-item.md): The painted item behind the live chart.
- [UsageBar](https://atlasos.eterneon.net/framework/atlas-ui/usage-bar.md): A stacked usage bar.
- [MiniBars](https://atlasos.eterneon.net/framework/atlas-ui/mini-bars.md): A row of small bars.
- [AtlasSparkline](https://atlasos.eterneon.net/framework/atlas-ui/atlas-sparkline.md): A small line chart with no axes.
- [AtlasSparklineItem](https://atlasos.eterneon.net/framework/atlas-ui/atlas-sparkline-item.md): The painted item behind the sparkline.
- [RepaintArea](https://atlasos.eterneon.net/framework/atlas-ui/repaint-area.md): An invisible item that makes a table row repaint as one rectangle.

### Text and code

- [AtlasLabel](https://atlasos.eterneon.net/framework/atlas-ui/atlas-label.md): Text in one of the Atlas looks.
- [AtlasCodeView](https://atlasos.eterneon.net/framework/atlas-ui/atlas-code-view.md): Read-only monospace text with an optional copy button.
- [AtlasShortcutLabel](https://atlasos.eterneon.net/framework/atlas-ui/atlas-shortcut-label.md): A keyboard shortcut drawn as keycaps.
- [NotesText](https://atlasos.eterneon.net/framework/atlas-ui/notes-text.md): Release notes from a safe HTML fragment.
- [FindBar](https://atlasos.eterneon.net/framework/atlas-ui/find-bar.md): A find and replace bar.

### Layout

- [Section](https://atlasos.eterneon.net/framework/atlas-ui/section.md): A rounded card of rows.
- [SectionRow](https://atlasos.eterneon.net/framework/atlas-ui/section-row.md): One row of a section: title, subtitle, value and a switch, check mark or chevron.
- [AtlasCard](https://atlasos.eterneon.net/framework/atlas-ui/atlas-card.md): A padded card with an optional header and footer.
- [AtlasExpandableSection](https://atlasos.eterneon.net/framework/atlas-ui/atlas-expandable-section.md): A header row that folds its content.
- [AtlasSplitView](https://atlasos.eterneon.net/framework/atlas-ui/atlas-split-view.md): Panes with a draggable divider.
- [AtlasFlowLayout](https://atlasos.eterneon.net/framework/atlas-ui/atlas-flow-layout.md): A wrapping row layout.
- [AtlasScrollBar](https://atlasos.eterneon.net/framework/atlas-ui/atlas-scroll-bar.md): A thin scroll bar that fades out.
- [AtlasTransparencySwitch](https://atlasos.eterneon.net/framework/atlas-ui/atlas-transparency-switch.md): A settings row with the shared Transparency and blur switch.

### Style and motion

- [AtlasStyle](https://atlasos.eterneon.net/framework/atlas-ui/atlas-style.md): The design tokens: colours, spacing, radii, fonts, motion and density.
- [Appearance](https://atlasos.eterneon.net/framework/atlas-ui/appearance.md): The look switches every app shares: transparency, colour scheme, motion and text scale.
- [AtlasSpringAnimation](https://atlasos.eterneon.net/framework/atlas-ui/atlas-spring-animation.md): The Atlas spring for movement and size.
- [AtlasFocusRing](https://atlasos.eterneon.net/framework/atlas-ui/atlas-focus-ring.md): The keyboard focus outline.

### Icons

- [Symbol](https://atlasos.eterneon.net/framework/atlas-ui/symbol.md): One Material Symbols icon.
- [Symbols](https://atlasos.eterneon.net/framework/atlas-ui/symbols.md): The singleton of every symbol's name.

### Services

- [AtlasApp](https://atlasos.eterneon.net/framework/atlas-ui/atlas-app.md): The running app's name, ID, version and the OS.
- [AtlasSettings](https://atlasos.eterneon.net/framework/atlas-ui/atlas-settings.md): The app's own settings file.
- [AtlasClipboard](https://atlasos.eterneon.net/framework/atlas-ui/atlas-clipboard.md): The system clipboard.
- [AtlasFormat](https://atlasos.eterneon.net/framework/atlas-ui/atlas-format.md): Formats sizes, speeds, numbers, durations and dates for the user's locale.
- [AtlasPortal](https://atlasos.eterneon.net/framework/atlas-ui/atlas-portal.md): Opens links and sends desktop notifications.
- [AtlasShortcuts](https://atlasos.eterneon.net/framework/atlas-ui/atlas-shortcuts.md): The registry of the app's actions and shortcut conflicts.
- [AccessibilityState](https://atlasos.eterneon.net/framework/atlas-ui/accessibility-state.md): Whether a screen reader is listening.

### Validators

- [AtlasEmailValidator](https://atlasos.eterneon.net/framework/atlas-ui/atlas-email-validator.md): Checks an email address.
- [AtlasUrlValidator](https://atlasos.eterneon.net/framework/atlas-ui/atlas-url-validator.md): Checks a URL and its scheme.
- [AtlasPathValidator](https://atlasos.eterneon.net/framework/atlas-ui/atlas-path-validator.md): Checks a file path.
- [AtlasNumberValidator](https://atlasos.eterneon.net/framework/atlas-ui/atlas-number-validator.md): Checks a number's range, decimals and locale format.


## Pages

- [Design rules](https://atlasos.eterneon.net/framework/atlas-ui/design-rules.md): The rules every Atlas app follows, and which Atlas.Ui control or token carries each one.
- [Style and theming](https://atlasos.eterneon.net/framework/atlas-ui/style-and-theming.md): AtlasStyle's colour, spacing, radius, size and density tokens, how the Plasma accent, light and dark, blur, high contrast and text scale reach an app.
- [Motion](https://atlasos.eterneon.net/framework/atlas-ui/motion.md): How Atlas apps move: AtlasSpringAnimation standard and expressive, the duration tokens, reduced motion, the violet to sakura gradient rule and why nothing animates while idle.
- [Compatibility](https://atlasos.eterneon.net/framework/atlas-ui/compatibility.md): Atlas.Ui's API is a contract with every Atlas app: it only grows, and what that means for the app's version requirements and names.
- [Accessibility](https://atlasos.eterneon.net/framework/atlas-ui/accessibility.md): Keyboard focus, the focus ring, accessible roles and names, right-to-left mirroring and the checks the framework runs on every control.
- [AccessibilityState](https://atlasos.eterneon.net/framework/atlas-ui/accessibility-state.md): A singleton that says whether a screen reader or other assistive technology is listening.
- [AtlasApp](https://atlasos.eterneon.net/framework/atlas-ui/atlas-app.md): A read-only singleton with the running app's name, ID, version and repository, the OS, and the Qt and Atlas.Ui versions.
- [AtlasClipboard](https://atlasos.eterneon.net/framework/atlas-ui/atlas-clipboard.md): A singleton for the system clipboard: copy and read text, rich text and images without a hidden TextEdit.
- [AtlasFormat](https://atlasos.eterneon.net/framework/atlas-ui/atlas-format.md): A singleton that formats sizes, speeds, percentages, numbers, durations and dates alike in every Atlas app and in the user's language.
- [AtlasPortal](https://atlasos.eterneon.net/framework/atlas-ui/atlas-portal.md): A singleton for what an app asks the desktop to do: open a link with the default app and show a desktop notification.
- [AtlasSettings](https://atlasos.eterneon.net/framework/atlas-ui/atlas-settings.md): An app's own settings file, read and written in the format the Rust settings crate uses, with typed values, atomic batched writes and change notices.
- [AtlasShortcuts](https://atlasos.eterneon.net/framework/atlas-ui/atlas-shortcuts.md): A singleton registry of the app's actions that reports shortcut conflicts and turns shortcuts into readable text.
- [Appearance](https://atlasos.eterneon.net/framework/atlas-ui/appearance.md): A singleton with the look switches every Atlas app shares: transparency and blur, colour scheme, motion, text scale and the brand fonts.
- [AtlasFocusRing](https://atlasos.eterneon.net/framework/atlas-ui/atlas-focus-ring.md): The keyboard focus ring every Atlas control shows: a magenta-violet outline with a gap, only for keyboard focus.
- [AtlasSpringAnimation](https://atlasos.eterneon.net/framework/atlas-ui/atlas-spring-animation.md): The Atlas spring for movement and size, standard or with a small overshoot, for use in a Behavior.
- [AtlasStyle](https://atlasos.eterneon.net/framework/atlas-ui/atlas-style.md): A singleton of design tokens: colours by role, spacing, radii, fonts, durations and density, so no app hard-codes a number.
- [AtlasAboutPage](https://atlasos.eterneon.net/framework/atlas-ui/atlas-about-page.md): A ready-made About page: app icon, name, version, system info, links, licence and a "Copy system info" button.
- [AtlasHeaderBar](https://atlasos.eterneon.net/framework/atlas-ui/atlas-header-bar.md): The merged header of a frameless Atlas window: window menu, title, main tools and window buttons in one row.
- [AtlasOnboarding](https://atlasos.eterneon.net/framework/atlas-ui/atlas-onboarding.md): A setup scaffold with a column of steps, one page at a time, and a footer with Back, Skip and Next or Finish.
- [AtlasPage](https://atlasos.eterneon.net/framework/atlas-ui/atlas-page.md): A scrolling page with a large bold title, generous centred margins and a place for buttons at the end of the title row.
- [AtlasWindow](https://atlasos.eterneon.net/framework/atlas-ui/atlas-window.md): The application window of an Atlas app: blur or opaque, a width class, saved size and an optional frameless header.
- [AtlasWindowButtons](https://atlasos.eterneon.net/framework/atlas-ui/atlas-window-buttons.md): The minimise, maximise or restore and close buttons of a frameless window, drawn like the AtlasOS window decoration.
- [AtlasWindowChrome](https://atlasos.eterneon.net/framework/atlas-ui/atlas-window-chrome.md): A singleton with KWin's caption button layout and whether the desktop has a global menu.
- [StatusBar](https://atlasos.eterneon.net/framework/atlas-ui/status-bar.md): A slim bar along the bottom of a window for Ln/Col, encoding, zoom and similar cells.
- [StatusBarItem](https://atlasos.eterneon.net/framework/atlas-ui/status-bar-item.md): One cell of a StatusBar: a short text, optionally clickable, with a symbol, a tooltip and a menu.
- [AtlasAction](https://atlasos.eterneon.net/framework/atlas-ui/atlas-action.md): One user action with its text, symbol, shortcut and tooltip in one place, shared by toolbar buttons, menu items and the keyboard.
- [AtlasAppMenu](https://atlasos.eterneon.net/framework/atlas-ui/atlas-app-menu.md): The app's menus for the header bar: exported to the desktop's global menu when there is one, else a menu button.
- [AtlasCommandPalette](https://atlasos.eterneon.net/framework/atlas-ui/atlas-command-palette.md): A searchable popup list of the app's actions, opened with a shortcut such as Ctrl+K.
- [AtlasDialog](https://atlasos.eterneon.net/framework/atlas-ui/atlas-dialog.md): The general modal dialog: a title row, a scrolling body and a row of buttons, over a dimmed window.
- [AtlasPopover](https://atlasos.eterneon.net/framework/atlas-ui/atlas-popover.md): A raised card that opens next to a control, with a soft shadow, a border and an optional arrow pointing at its target.
- [AtlasShortcutsDialog](https://atlasos.eterneon.net/framework/atlas-ui/atlas-shortcuts-dialog.md): A modal list of the app's keyboard shortcuts grouped by section, with search, scrolling and a Close button.
- [AtlasToolTip](https://atlasos.eterneon.net/framework/atlas-ui/atlas-tool-tip.md): A small rounded hint on a raised card, opened after the hover delay.
- [ConfirmDialog](https://atlasos.eterneon.net/framework/atlas-ui/confirm-dialog.md): A modal dialog in the Atlas look with small rounded buttons, an optional third button and a destructive style.
- [ContextMenu](https://atlasos.eterneon.net/framework/atlas-ui/context-menu.md): A right-click menu in the Atlas look: a raised card with 6 px corners with inset rows.
- [ContextMenuItem](https://atlasos.eterneon.net/framework/atlas-ui/context-menu-item.md): One row of a ContextMenu: an icon or symbol, the text and a shortcut hint, optionally checkable or a radio choice.
- [ContextMenuSeparator](https://atlasos.eterneon.net/framework/atlas-ui/context-menu-separator.md): A thin rule between groups of ContextMenuItem rows.
- [AtlasAppCard](https://atlasos.eterneon.net/framework/atlas-ui/atlas-app-card.md): A store card for one app: icon, name, short summary, rating and size, with an install button at the end.
- [AtlasDetailGrid](https://atlasos.eterneon.net/framework/atlas-ui/atlas-detail-grid.md): Names and values in aligned columns for an item's facts, with optional monospace and copy buttons.
- [AtlasIconGrid](https://atlasos.eterneon.net/framework/atlas-ui/atlas-icon-grid.md): A scrolling grid of icons over names that makes cells only for what is on screen, for folders of files or apps.
- [AtlasListView](https://atlasos.eterneon.net/framework/atlas-ui/atlas-list-view.md): A ListView in the Atlas look with selection, type-ahead, a default row from model roles, a context menu and optional drag reordering.
- [AtlasScreenshotCarousel](https://atlasos.eterneon.net/framework/atlas-ui/atlas-screenshot-carousel.md): A row of screenshots shown one at a time with previous and next buttons, dots and arrow keys, loading only the neighbours.
- [AtlasSearchResults](https://atlasos.eterneon.net/framework/atlas-ui/atlas-search-results.md): A launcher's results list with section headings, icons, subtitles and shortcut hints, driven by keys passed on from the search field.
- [AtlasTreeModel](https://atlasos.eterneon.net/framework/atlas-ui/atlas-tree-model.md): A read-only tree model built from nested JavaScript objects, for AtlasTreeView.
- [AtlasTreeView](https://atlasos.eterneon.net/framework/atlas-ui/atlas-tree-view.md): A tree of rows in the Atlas list look, on Qt Quick's TreeView.
- [DataTable](https://atlasos.eterneon.net/framework/atlas-ui/data-table.md): A sortable table in the Section style that only makes the rows on screen.
- [AtlasAutocompleteField](https://atlasos.eterneon.net/framework/atlas-ui/atlas-autocomplete-field.md): A text field that suggests completions from a list or model while you type.
- [AtlasCalendar](https://atlasos.eterneon.net/framework/atlas-ui/atlas-calendar.md): A month grid for choosing a day, with keyboard navigation and optional date limits.
- [AtlasColorField](https://atlasos.eterneon.net/framework/atlas-ui/atlas-color-field.md): A colour chooser: a swatch and hex field that opens a palette, a hex field and the system colour dialog.
- [AtlasComboBox](https://atlasos.eterneon.net/framework/atlas-ui/atlas-combo-box.md): A drop-down list with the current choice in a field and the choices in a raised card, optionally filterable.
- [AtlasDatePicker](https://atlasos.eterneon.net/framework/atlas-ui/atlas-date-picker.md): A date field that shows the chosen date and opens a calendar in a raised card.
- [AtlasDoubleSpinBox](https://atlasos.eterneon.net/framework/atlas-ui/atlas-double-spin-box.md): A number field with decimals, minus and plus buttons, a prefix and a suffix.
- [AtlasDropZone](https://atlasos.eterneon.net/framework/atlas-ui/atlas-drop-zone.md): A dashed, rounded area that files can be dropped on, with a symbol, text and an optional Browse button.
- [AtlasFileField](https://atlasos.eterneon.net/framework/atlas-ui/atlas-file-field.md): A file chooser: a path field and a Browse button that opens the system file dialog.
- [AtlasFolderField](https://atlasos.eterneon.net/framework/atlas-ui/atlas-folder-field.md): A folder chooser: a path field and a Browse button that opens the system folder dialog.
- [AtlasFontPicker](https://atlasos.eterneon.net/framework/atlas-ui/atlas-font-picker.md): A font chooser: a small rounded button showing the family in its own face and the size, opening a searchable list of installed families.
- [AtlasPasswordField](https://atlasos.eterneon.net/framework/atlas-ui/atlas-password-field.md): A rounded password field with an eye that shows the text, an error message, and automatic hiding when focus leaves.
- [AtlasRating](https://atlasos.eterneon.net/framework/atlas-ui/atlas-rating.md): Zero to five stars with halves drawn, read-only by default, or editable with hover preview, click and keyboard.
- [AtlasShortcutField](https://atlasos.eterneon.net/framework/atlas-ui/atlas-shortcut-field.md): A field that records a key combination and reports conflicts with other registered actions.
- [AtlasSlider](https://atlasos.eterneon.net/framework/atlas-ui/atlas-slider.md): A slider with a thin accent track with round ends and a knob, horizontal or vertical, with Page Up, Page Down, Home and End keys.
- [AtlasSpinBox](https://atlasos.eterneon.net/framework/atlas-ui/atlas-spin-box.md): A whole-number field with minus and plus buttons, a prefix and a suffix, which can be shown as a plain number field.
- [AtlasTextArea](https://atlasos.eterneon.net/framework/atlas-ui/atlas-text-area.md): A multi-line text field with small rounded corners that wraps long lines and lets Tab move focus on.
- [AtlasTextField](https://atlasos.eterneon.net/framework/atlas-ui/atlas-text-field.md): A single-line text field with an error message, a clear button, a prefix and suffix, a character counter and validation messages.
- [AtlasTimePicker](https://atlasos.eterneon.net/framework/atlas-ui/atlas-time-picker.md): A time of day as hours and minutes number fields, with AM/PM in 12-hour mode and an optional day-of-week drop-down.
- [SearchField](https://atlasos.eterneon.net/framework/atlas-ui/search-field.md): A search field with a magnifier, a clear button and a debounced query.
- [AtlasAvatar](https://atlasos.eterneon.net/framework/atlas-ui/atlas-avatar.md): A round picture of a person or account, falling back to initials on a name-based colour, or a symbol.
- [AtlasBadge](https://atlasos.eterneon.net/framework/atlas-ui/atlas-badge.md): A small pill label for a status or count, or a dot meaning "something is new here".
- [AtlasEdgeGlow](https://atlasos.eterneon.net/framework/atlas-ui/atlas-edge-glow.md): A soft violet-to-sakura glow along the inside edges of its parent, meaning "the system is doing something for you now".
- [AtlasEmptyState](https://atlasos.eterneon.net/framework/atlas-ui/atlas-empty-state.md): What a list shows when it has nothing: a large symbol, a title, an explanation and an optional action button, centred.
- [AtlasPlaceholder](https://atlasos.eterneon.net/framework/atlas-ui/atlas-placeholder.md): A skeleton block of soft rounded bars with a light sweep, shown where content is still loading.
- [AtlasProgressBar](https://atlasos.eterneon.net/framework/atlas-ui/atlas-progress-bar.md): A rounded progress bar in the accent colour, with an indeterminate mode, a text label beside it and normal, paused and error states.
- [AtlasSpinner](https://atlasos.eterneon.net/framework/atlas-ui/atlas-spinner.md): A busy indicator, an accent arc that turns while something loads.
- [AtlasStat](https://atlasos.eterneon.net/framework/atlas-ui/atlas-stat.md): A figure with a small muted label, a big value with a unit, an optional trend arrow and an optional sparkline.
- [InfoBanner](https://atlasos.eterneon.net/framework/atlas-ui/info-banner.md): An inline banner above the content for notices such as "File changed on disk" or "Could not save".
- [StatusHero](https://atlasos.eterneon.net/framework/atlas-ui/status-hero.md): A big centred status: a round icon badge with an optional ring, a headline, a subtitle and action buttons.
- [Toast](https://atlasos.eterneon.net/framework/atlas-ui/toast.md): A short message that appears at the bottom centre of its parent and goes by itself.
- [AtlasBreadcrumb](https://atlasos.eterneon.net/framework/atlas-ui/atlas-breadcrumb.md): A path bar with one button per segment; a long path collapses its middle into a menu.
- [AtlasFloatingToolbar](https://atlasos.eterneon.net/framework/atlas-ui/atlas-floating-toolbar.md): A capsule of icon buttons that floats over content, such as formatting tools over an editor.
- [AtlasNavigationStack](https://atlasos.eterneon.net/framework/atlas-ui/atlas-navigation-stack.md): Drill-down navigation with pages pushed over each other, a header with a Back button and the page title, and Alt+Left to go back.
- [AtlasSidebar](https://atlasos.eterneon.net/framework/atlas-ui/atlas-sidebar.md): A scrolling sidebar for SidebarItem and SidebarGroup entries with filtering, a placeholder, context menus and drop targets.
- [AtlasToolbar](https://atlasos.eterneon.net/framework/atlas-ui/atlas-toolbar.md): A horizontal bar of actions that moves the ones that don't fit into a "more" menu.
- [AtlasViewSwitcher](https://atlasos.eterneon.net/framework/atlas-ui/atlas-view-switcher.md): Page tabs for the top of a window: a symbol and text per tab, the current one tinted, with an optional count badge.
- [SidebarGroup](https://atlasos.eterneon.net/framework/atlas-ui/sidebar-group.md): A sidebar entry that folds out into sub-entries.
- [SidebarItem](https://atlasos.eterneon.net/framework/atlas-ui/sidebar-item.md): A sidebar entry: accent icon and label with a soft selection and an optional live value or badge.
- [StepItem](https://atlasos.eterneon.net/framework/atlas-ui/step-item.md): One step in a setup sidebar: a numbered circle, or a check mark once done, and the step's name.
- [TabBar](https://atlasos.eterneon.net/framework/atlas-ui/tab-bar.md): A strip of document tabs with an unsaved dot, a close button, a new-tab button and drag to reorder.
- [AtlasButton](https://atlasos.eterneon.net/framework/atlas-ui/atlas-button.md): The button every Atlas app uses, with four variants, an optional symbol and a busy state.
- [AtlasCheckBox](https://atlasos.eterneon.net/framework/atlas-ui/atlas-check-box.md): A rounded check box with a label and an optional partly-checked state.
- [AtlasChip](https://atlasos.eterneon.net/framework/atlas-ui/atlas-chip.md): A small label for a tag, a filter or a value; plain, checkable or closable.
- [AtlasChipGroup](https://atlasos.eterneon.net/framework/atlas-ui/atlas-chip-group.md): A wrapping flow of chips, optionally one-of like radio buttons, with one Tab stop.
- [AtlasCopyButton](https://atlasos.eterneon.net/framework/atlas-ui/atlas-copy-button.md): A small icon button that copies its text to the clipboard and shows a check mark for a moment.
- [AtlasInstallButton](https://atlasos.eterneon.net/framework/atlas-ui/atlas-install-button.md): An install button for apps with a progress bar inside it, a cancel press while installing, and states for install, update, open and retry.
- [AtlasRadioButton](https://atlasos.eterneon.net/framework/atlas-ui/atlas-radio-button.md): A round radio button with a label; buttons with the same parent form a group and the arrow keys move the choice.
- [AtlasSegmentedControl](https://atlasos.eterneon.net/framework/atlas-ui/atlas-segmented-control.md): A row of joined segments with one selected, for a choice between a few views or modes.
- [AtlasSplitButton](https://atlasos.eterneon.net/framework/atlas-ui/atlas-split-button.md): A main button joined to an arrow that opens a menu of variants of the action, such as Save and Save As.
- [AtlasSwitch](https://atlasos.eterneon.net/framework/atlas-ui/atlas-switch.md): A pill switch with an accent track when on and a knob that slides across with a small overshoot.
- [MenuButton](https://atlasos.eterneon.net/framework/atlas-ui/menu-button.md): A SecondaryButton with a chevron that opens a menu of the items inside it.
- [PrimaryButton](https://atlasos.eterneon.net/framework/atlas-ui/primary-button.md): An AtlasButton preset as a filled accent button, for the main action.
- [SecondaryButton](https://atlasos.eterneon.net/framework/atlas-ui/secondary-button.md): An AtlasButton preset as a soft tinted button with a hairline border.
- [TextButton](https://atlasos.eterneon.net/framework/atlas-ui/text-button.md): A link-styled button: accent text, no fill.
- [ToolbarButton](https://atlasos.eterneon.net/framework/atlas-ui/toolbar-button.md): A small icon button for toolbars that never takes the editor's focus.
- [AtlasCard](https://atlasos.eterneon.net/framework/atlas-ui/atlas-card.md): A padded card on the raised surface, with an optional header and footer, and optionally clickable.
- [AtlasExpandableSection](https://atlasos.eterneon.net/framework/atlas-ui/atlas-expandable-section.md): A header row that folds its content away, with an optional symbol, subtitle and chevron.
- [AtlasFlowLayout](https://atlasos.eterneon.net/framework/atlas-ui/atlas-flow-layout.md): Lays children out left to right and wraps them onto new rows, honouring Layout attached properties.
- [AtlasScrollBar](https://atlasos.eterneon.net/framework/atlas-ui/atlas-scroll-bar.md): A thin, rounded scroll bar whose thumb widens on hover and fades out when nothing is scrolling.
- [AtlasSplitView](https://atlasos.eterneon.net/framework/atlas-ui/atlas-split-view.md): Panes side by side or stacked with a thin draggable Atlas divider that can remember the pane sizes between runs.
- [AtlasTransparencySwitch](https://atlasos.eterneon.net/framework/atlas-ui/atlas-transparency-switch.md): A settings row with a switch for the "Transparency and blur" setting every Atlas app shares.
- [Section](https://atlasos.eterneon.net/framework/atlas-ui/section.md): A rounded card that groups SectionRows, or any items, on a raised background.
- [SectionRow](https://atlasos.eterneon.net/framework/atlas-ui/section-row.md): One row in a Section: icon, title and subtitle, with a value, extra items, a check mark, a switch or a chevron.
- [AtlasCodeView](https://atlasos.eterneon.net/framework/atlas-ui/atlas-code-view.md): Read-only monospace text for a command, log excerpt, snippet or config, with optional line numbers and a copy button.
- [AtlasLabel](https://atlasos.eterneon.net/framework/atlas-ui/atlas-label.md): Text in one of the Atlas looks \(body, title, heading, caption, monospace\) so an app never hard-codes sizes and weights.
- [AtlasShortcutLabel](https://atlasos.eterneon.net/framework/atlas-ui/atlas-shortcut-label.md): A keyboard shortcut drawn as keycaps, one per key, in the platform's own spelling.
- [FindBar](https://atlasos.eterneon.net/framework/atlas-ui/find-bar.md): A find and replace bar that slides down above an editor.
- [NotesText](https://atlasos.eterneon.net/framework/atlas-ui/notes-text.md): Release notes shown from a safe HTML fragment, styled with Atlas colours and spacing.
- [AtlasEmailValidator](https://atlasos.eterneon.net/framework/atlas-ui/atlas-email-validator.md): A validator for an email address field: one @, a dotted domain and a bounded length.
- [AtlasNumberValidator](https://atlasos.eterneon.net/framework/atlas-ui/atlas-number-validator.md): A validator for a number field that checks a range, a number of decimals and the locale's way of writing numbers.
- [AtlasPathValidator](https://atlasos.eterneon.net/framework/atlas-ui/atlas-path-validator.md): A validator for a file path field that can require an absolute path or an existing file or folder.
- [AtlasUrlValidator](https://atlasos.eterneon.net/framework/atlas-ui/atlas-url-validator.md): A validator for a text field that accepts a URL with one of a set of schemes.
- [AtlasSparkline](https://atlasos.eterneon.net/framework/atlas-ui/atlas-sparkline.md): A small line chart with no axes or captions that shows the trend of a figure in a card or a row.
- [AtlasSparklineItem](https://atlasos.eterneon.net/framework/atlas-ui/atlas-sparkline-item.md): The painted item behind AtlasSparkline, a small axis-less line chart drawn with QPainter.
- [LiveChart](https://atlasos.eterneon.net/framework/atlas-ui/live-chart.md): A live line-and-area chart of the last 60 samples in the theme's colours.
- [LiveChartItem](https://atlasos.eterneon.net/framework/atlas-ui/live-chart-item.md): The painted item behind LiveChart: a line-and-area chart of the last 60 samples.
- [MiniBars](https://atlasos.eterneon.net/framework/atlas-ui/mini-bars.md): A row of small upright bars, one per value, wrapping onto more rows when there are many.
- [RepaintArea](https://atlasos.eterneon.net/framework/atlas-ui/repaint-area.md): An invisible item that repaints its whole area as one rectangle whenever its content changes.
- [UsageBar](https://atlasos.eterneon.net/framework/atlas-ui/usage-bar.md): A stacked bar of how something is shared out, with an optional legend.
- [Symbol](https://atlasos.eterneon.net/framework/atlas-ui/symbol.md): Draws one Material Symbol, tinted like text.
- [Symbols](https://atlasos.eterneon.net/framework/atlas-ui/symbols.md): The singleton that holds every Material Symbol's value as Symbols.Name, and looks symbols up by name.