# nativescript-community/ui-material-components architecture

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

- Interactive diagram: https://gitdiagram.com/nativescript-community/ui-material-components
- Repository: https://github.com/nativescript-community/ui-material-components

## Overview

NativeScript Material Components is a monorepo of native UI widgets exposed through NativeScript and framework-specific adapters. An app developer configures a NativeScript app and uses widgets such as indicators, navigation, inputs, and dialogs; the platform implementations render the corresponding native controls. The graph preserves the documented theming and mixin capabilities as well as major component families visible in the repository tree. Several subsystem links are dashed because their implementation files were not sampled; relationships shown directly in excerpts or documented in the README are cited.

Main entry points: [`src/core/index.ios.ts`](https://github.com/nativescript-community/ui-material-components/blob/master/src/core/index.ios.ts) (Theme and mixins), [`src/bottom-navigation/index.ios.ts`](https://github.com/nativescript-community/ui-material-components/blob/master/src/bottom-navigation/index.ios.ts) (Bottom navigation), [`src/core-tabs/tab-navigation/index-common.ts`](https://github.com/nativescript-community/ui-material-components/blob/master/src/core-tabs/tab-navigation/index-common.ts) (Tab navigation), [`src/button/button-common.ts`](https://github.com/nativescript-community/ui-material-components/blob/master/src/button/button-common.ts) (Button)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_foundation["Shared foundation"]
  node_core["Theme and mixins<br/>[index.ios.ts]"]
  node_coreandroid["Android utilities<br/>[utils.ts]"]
end

subgraph group_navigation["Navigation"]
  node_bottomnav["Bottom navigation<br/>[index.ios.ts]"]
  node_bottombar["Bottom navigation bar"]
  node_tabbase["Tab navigation base<br/>[index.ts]"]
  node_tabnav["Tab navigation<br/>[index-common.ts]"]
  node_tabstrip["Tab strip items<br/>[index.ts]"]
  node_tabs["Tabs<br/>[index.ios.ts]"]
  node_segmented["Segmented bar<br/>[index.android.ts]"]
end

subgraph group_controls["Inputs and controls"]
  node_button["Button<br/>[button-common.ts]"]
  node_slider["Slider<br/>[slider.android.ts]"]
  node_switch["Switch<br/>[index-common.ts]"]
  node_textfield["Text field"]
  node_textview["Text view<br/>[textview.common.ts]"]
end

subgraph group_feedback["Feedback"]
  node_activity["Activity indicator<br/>[index-common.ts]"]
  node_progress["Progress indicator"]
  node_snackbar["Snackbar<br/>[snackbar-common.ts]"]
  node_ripple["Ripple<br/>[ripple-common.ts]"]
end

subgraph group_surfaces["Surfaces and actions"]
  node_dialogs["Dialogs<br/>[dialogs-common.ts]"]
  node_bottomsheet["Bottom sheet"]
  node_cardview["Card view<br/>[cardview-common.ts]"]
  node_fab["Floating action button"]
  node_speeddial["Speed dial<br/>[index.ts]"]
  node_appbar["App bar<br/>[appbar-common.ts]"]
end

node_developer(("App developer"))
node_app["NativeScript app"]

node_developer -->|"builds with"| node_app
node_app -->|"uses widget"| node_activity
node_app -->|"uses navigation"| node_bottomnav
node_developer -->|"configures theme"| node_core
node_developer -->|"installs mixins"| node_core
node_bottomnav -->|"uses tab model"| node_tabbase
node_bottomnav -->|"uses tab behavior"| node_tabnav
node_bottomnav -->|"emits tab tap"| node_tabstrip
node_tabnav -->|"extends base"| node_tabbase
node_tabnav -->|"uses strip items"| node_tabstrip
node_tabs -->|"uses navigation"| node_tabnav
node_segmented -->|"extends button"| node_button
node_activity -->|"uses theme"| node_core
node_bottomnav -->|"uses theme"| node_core
node_button -.->|"uses shared core"| node_core
node_bottombar -.->|"uses shared core"| node_core
node_slider -.->|"uses shared core"| node_core
node_switch -.->|"uses shared core"| node_core
node_textfield -.->|"uses shared core"| node_core
node_textview -.->|"uses shared core"| node_core
node_progress -.->|"uses shared core"| node_core
node_snackbar -.->|"uses shared core"| node_core
node_ripple -.->|"uses shared core"| node_core
node_dialogs -.->|"uses shared core"| node_core
node_bottomsheet -.->|"uses shared core"| node_core
node_cardview -.->|"uses shared core"| node_core
node_fab -.->|"uses shared core"| node_core
node_speeddial -->|"creates buttons"| node_button
node_appbar -.->|"uses shared core"| node_core
node_core -.->|"uses Android helpers"| node_coreandroid

click node_core "https://github.com/nativescript-community/ui-material-components/blob/master/src/core/index.ios.ts"
click node_coreandroid "https://github.com/nativescript-community/ui-material-components/blob/master/src/core/android/utils.ts"
click node_activity "https://github.com/nativescript-community/ui-material-components/blob/master/src/activityindicator/index-common.ts"
click node_bottomnav "https://github.com/nativescript-community/ui-material-components/blob/master/src/bottom-navigation/index.ios.ts"
click node_bottombar "https://github.com/nativescript-community/ui-material-components/blob/master/src/bottomnavigationbar/bottomnavigationbar-common.ts"
click node_tabbase "https://github.com/nativescript-community/ui-material-components/blob/master/src/core-tabs/tab-navigation-base/index.ts"
click node_tabnav "https://github.com/nativescript-community/ui-material-components/blob/master/src/core-tabs/tab-navigation/index-common.ts"
click node_tabstrip "https://github.com/nativescript-community/ui-material-components/blob/master/src/core-tabs/tab-strip-item/index.ts"
click node_tabs "https://github.com/nativescript-community/ui-material-components/blob/master/src/tabs/index.ios.ts"
click node_segmented "https://github.com/nativescript-community/ui-material-components/blob/master/src/segmentedbar/index.android.ts"
click node_button "https://github.com/nativescript-community/ui-material-components/blob/master/src/button/button-common.ts"
click node_slider "https://github.com/nativescript-community/ui-material-components/blob/master/src/slider/slider.android.ts"
click node_switch "https://github.com/nativescript-community/ui-material-components/blob/master/src/switch/index-common.ts"
click node_textfield "https://github.com/nativescript-community/ui-material-components/blob/master/src/textfield/textfield.common.ts"
click node_textview "https://github.com/nativescript-community/ui-material-components/blob/master/src/textview/textview.common.ts"
click node_progress "https://github.com/nativescript-community/ui-material-components/blob/master/src/progress/progress.android.ts"
click node_snackbar "https://github.com/nativescript-community/ui-material-components/blob/master/src/snackbar/snackbar-common.ts"
click node_ripple "https://github.com/nativescript-community/ui-material-components/blob/master/src/ripple/ripple-common.ts"
click node_dialogs "https://github.com/nativescript-community/ui-material-components/blob/master/src/dialogs/dialogs-common.ts"
click node_bottomsheet "https://github.com/nativescript-community/ui-material-components/blob/master/src/bottomsheet/bottomsheet-common.ts"
click node_cardview "https://github.com/nativescript-community/ui-material-components/blob/master/src/cardview/cardview-common.ts"
click node_fab "https://github.com/nativescript-community/ui-material-components/blob/master/src/floatingactionbutton/floatingactionbutton.android.ts"
click node_speeddial "https://github.com/nativescript-community/ui-material-components/blob/master/src/speeddial/index.ts"
click node_appbar "https://github.com/nativescript-community/ui-material-components/blob/master/src/appbar/appbar-common.ts"

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_core,node_coreandroid toneBlue
class node_bottomnav,node_bottombar,node_tabbase,node_tabnav,node_tabstrip,node_tabs,node_segmented toneAmber
class node_button,node_slider,node_switch,node_textfield,node_textview toneMint
class node_activity,node_progress,node_snackbar,node_ripple toneRose
class node_dialogs,node_bottomsheet,node_cardview,node_fab,node_speeddial,node_appbar,node_developer,node_app toneIndigo
```

## Components

### Shared foundation

- [Theme and mixins](https://github.com/nativescript-community/ui-material-components/blob/master/src/core/index.ios.ts): `src/core/index.ios.ts`
- [Android utilities](https://github.com/nativescript-community/ui-material-components/blob/master/src/core/android/utils.ts): `src/core/android/utils.ts`

### Navigation

- [Bottom navigation](https://github.com/nativescript-community/ui-material-components/blob/master/src/bottom-navigation/index.ios.ts): `src/bottom-navigation/index.ios.ts`
- [Bottom navigation bar](https://github.com/nativescript-community/ui-material-components/blob/master/src/bottomnavigationbar/bottomnavigationbar-common.ts): `src/bottomnavigationbar/bottomnavigationbar-common.ts`
- [Tab navigation base](https://github.com/nativescript-community/ui-material-components/blob/master/src/core-tabs/tab-navigation-base/index.ts): `src/core-tabs/tab-navigation-base/index.ts`
- [Tab navigation](https://github.com/nativescript-community/ui-material-components/blob/master/src/core-tabs/tab-navigation/index-common.ts): `src/core-tabs/tab-navigation/index-common.ts`
- [Tab strip items](https://github.com/nativescript-community/ui-material-components/blob/master/src/core-tabs/tab-strip-item/index.ts): `src/core-tabs/tab-strip-item/index.ts`
- [Tabs](https://github.com/nativescript-community/ui-material-components/blob/master/src/tabs/index.ios.ts): `src/tabs/index.ios.ts`
- [Segmented bar](https://github.com/nativescript-community/ui-material-components/blob/master/src/segmentedbar/index.android.ts): `src/segmentedbar/index.android.ts`

### Inputs and controls

- [Button](https://github.com/nativescript-community/ui-material-components/blob/master/src/button/button-common.ts): `src/button/button-common.ts`
- [Slider](https://github.com/nativescript-community/ui-material-components/blob/master/src/slider/slider.android.ts): `src/slider/slider.android.ts`
- [Switch](https://github.com/nativescript-community/ui-material-components/blob/master/src/switch/index-common.ts): `src/switch/index-common.ts`
- [Text field](https://github.com/nativescript-community/ui-material-components/blob/master/src/textfield/textfield.common.ts): `src/textfield/textfield.common.ts`
- [Text view](https://github.com/nativescript-community/ui-material-components/blob/master/src/textview/textview.common.ts): `src/textview/textview.common.ts`

### Feedback

- [Activity indicator](https://github.com/nativescript-community/ui-material-components/blob/master/src/activityindicator/index-common.ts): `src/activityindicator/index-common.ts`
- [Progress indicator](https://github.com/nativescript-community/ui-material-components/blob/master/src/progress/progress.android.ts): `src/progress/progress.android.ts`
- [Snackbar](https://github.com/nativescript-community/ui-material-components/blob/master/src/snackbar/snackbar-common.ts): `src/snackbar/snackbar-common.ts`
- [Ripple](https://github.com/nativescript-community/ui-material-components/blob/master/src/ripple/ripple-common.ts): `src/ripple/ripple-common.ts`

### Surfaces and actions

- [Dialogs](https://github.com/nativescript-community/ui-material-components/blob/master/src/dialogs/dialogs-common.ts): `src/dialogs/dialogs-common.ts`
- [Bottom sheet](https://github.com/nativescript-community/ui-material-components/blob/master/src/bottomsheet/bottomsheet-common.ts): `src/bottomsheet/bottomsheet-common.ts`
- [Card view](https://github.com/nativescript-community/ui-material-components/blob/master/src/cardview/cardview-common.ts): `src/cardview/cardview-common.ts`
- [Floating action button](https://github.com/nativescript-community/ui-material-components/blob/master/src/floatingactionbutton/floatingactionbutton.android.ts): `src/floatingactionbutton/floatingactionbutton.android.ts`
- [Speed dial](https://github.com/nativescript-community/ui-material-components/blob/master/src/speeddial/index.ts): `src/speeddial/index.ts`
- [App bar](https://github.com/nativescript-community/ui-material-components/blob/master/src/appbar/appbar-common.ts): `src/appbar/appbar-common.ts`

### Other components

- **App developer**
- **NativeScript app**

## Connections

- App developer → NativeScript app: builds with (evidence: `README.md`)
- NativeScript app → Activity indicator: uses widget (evidence: `README.md`)
- NativeScript app → Bottom navigation: uses navigation (evidence: `README.md`)
- App developer → Theme and mixins: configures theme (evidence: `README.md`)
- App developer → Theme and mixins: installs mixins (evidence: `README.md`)
- Bottom navigation → Tab navigation base: uses tab model (evidence: `src/bottom-navigation/index.ios.ts`)
- Bottom navigation → Tab navigation: uses tab behavior (evidence: `src/bottom-navigation/index.ios.ts`)
- Bottom navigation → Tab strip items: emits tab tap (evidence: `src/bottom-navigation/index.ios.ts`)
- Tab navigation → Tab navigation base: extends base (evidence: `src/core-tabs/tab-navigation/index.ios.ts`)
- Tab navigation → Tab strip items: uses strip items (evidence: `src/core-tabs/tab-navigation/index.ios.ts`)
- Tabs → Tab navigation: uses navigation (evidence: `src/tabs/index.ios.ts`)
- Segmented bar → Button: extends button (evidence: `src/segmentedbar/index.android.ts`)
- Activity indicator → Theme and mixins: uses theme
- Bottom navigation → Theme and mixins: uses theme
- Button → Theme and mixins: uses shared core
- Bottom navigation bar → Theme and mixins: uses shared core
- Slider → Theme and mixins: uses shared core
- Switch → Theme and mixins: uses shared core
- Text field → Theme and mixins: uses shared core
- Text view → Theme and mixins: uses shared core
- Progress indicator → Theme and mixins: uses shared core
- Snackbar → Theme and mixins: uses shared core
- Ripple → Theme and mixins: uses shared core
- Dialogs → Theme and mixins: uses shared core
- Bottom sheet → Theme and mixins: uses shared core
- Card view → Theme and mixins: uses shared core
- Floating action button → Theme and mixins: uses shared core
- Speed dial → Button: creates buttons (evidence: `src/speeddial/index.ts`)
- App bar → Theme and mixins: uses shared core
- Theme and mixins → Android utilities: uses Android helpers
