# flipspacesit/fs-ui architecture

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

- Interactive diagram: https://gitdiagram.com/flipspacesit/fs-ui
- Repository: https://github.com/flipspacesit/fs-ui

## Overview

@flipspacesit/fs-ui is a React and Material-UI component library, not an application with its own business-data workflow. An integrating application selects exported controls and composes them into user interfaces; the package supplies interaction controls, data presentation, overlays and feedback, plus shared styling and icons. The DataTable is a substantial specialized branch, with state, filtering/totals utilities and column resizing. Edges reflect explicit exports, sampled imports or calls, and README statements; many listed components were not sampled, so their internal relationships are omitted.

Main entry points: [`src/index.ts`](https://github.com/flipspacesit/fs-ui/blob/master/src/index.ts) (Component exports), [`src/components/SearchInput/index.tsx`](https://github.com/flipspacesit/fs-ui/blob/master/src/components/SearchInput/index.tsx) (Search input), [`src/components/Table/useDataTableState.ts`](https://github.com/flipspacesit/fs-ui/blob/master/src/components/Table/useDataTableState.ts) (Table state), [`src/components/Dropdown/index.tsx`](https://github.com/flipspacesit/fs-ui/blob/master/src/components/Dropdown/index.tsx) (Dropdown)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_entry["Package surface"]
  node_api["Component exports<br/>[index.ts]"]
end

subgraph group_controls["Inputs and navigation"]
  node_controls["Controls"]
  node_dropdown["Dropdown<br/>[index.tsx]"]
  node_search["Search input<br/>[index.tsx]"]
  node_select["Select input<br/>[index.tsx]"]
  node_fileupload["File upload<br/>[index.tsx]"]
  node_navigation["Navigation<br/>[index.tsx]"]
end

subgraph group_presentation["Data presentation"]
  node_table["DataTable<br/>[DataTable.tsx]"]
  node_tablestate["Table state"]
  node_tableutils["Table utilities<br/>[dataTableUtils.ts]"]
  node_resize["Column resizing<br/>[useColumnResize.ts]"]
  node_tabletypes["Table types<br/>[dataTableTypes.ts]"]
  node_tablestyles["Table styles<br/>[dataTableStyles.ts]"]
end

subgraph group_feedback["Overlays and feedback"]
  node_dialogs["Dialogs and modals"]
  node_notifications["Notifications"]
end

subgraph group_foundation["Design foundation"]
  node_theme["Theme<br/>[index.ts]"]
  node_colors["Color tokens<br/>[colors.ts]"]
  node_shadows["Shadow tokens<br/>[shadows.ts]"]
  node_icons["Icon exports<br/>[index.ts]"]
  node_constants["Control constants<br/>[index.ts]"]
end

node_consumer(("Integrating app"))

node_consumer -->|"uses package"| node_api
node_api -->|"exports"| node_dropdown
node_api -->|"exports"| node_search
node_api -->|"exports"| node_select
node_api -->|"exports"| node_fileupload
node_api -->|"exports"| node_navigation
node_api -->|"exports"| node_table
node_api -->|"exports"| node_dialogs
node_api -->|"exports"| node_notifications
node_dropdown -->|"renders"| node_search
node_select -->|"uses"| node_search
node_tablestate -->|"calls"| node_tableutils
node_tablestate -->|"uses"| node_resize
node_resize -->|"resolves widths"| node_tableutils
node_tableutils -->|"uses types"| node_tabletypes
node_resize -->|"uses types"| node_tabletypes
node_tablestate -->|"uses types"| node_tabletypes
node_theme -->|"reads tokens"| node_colors
node_theme -->|"reads tokens"| node_shadows
node_search -->|"uses theme"| node_theme
node_search -->|"uses helper"| node_constants
node_dropdown -->|"imports icons"| node_icons
node_fileupload -->|"imports icons"| node_icons

click node_api "https://github.com/flipspacesit/fs-ui/blob/master/src/index.ts"
click node_controls "https://github.com/flipspacesit/fs-ui/tree/master/src/components"
click node_dropdown "https://github.com/flipspacesit/fs-ui/blob/master/src/components/Dropdown/index.tsx"
click node_search "https://github.com/flipspacesit/fs-ui/blob/master/src/components/SearchInput/index.tsx"
click node_select "https://github.com/flipspacesit/fs-ui/blob/master/src/components/SelectInput/index.tsx"
click node_fileupload "https://github.com/flipspacesit/fs-ui/blob/master/src/components/FileUpload/index.tsx"
click node_navigation "https://github.com/flipspacesit/fs-ui/blob/master/src/components/SidebarNav/index.tsx"
click node_table "https://github.com/flipspacesit/fs-ui/blob/master/src/components/Table/DataTable.tsx"
click node_tablestate "https://github.com/flipspacesit/fs-ui/blob/master/src/components/Table/useDataTableState.ts"
click node_tableutils "https://github.com/flipspacesit/fs-ui/blob/master/src/components/Table/dataTableUtils.ts"
click node_resize "https://github.com/flipspacesit/fs-ui/blob/master/src/components/Table/useColumnResize.ts"
click node_tabletypes "https://github.com/flipspacesit/fs-ui/blob/master/src/components/Table/dataTableTypes.ts"
click node_tablestyles "https://github.com/flipspacesit/fs-ui/blob/master/src/components/Table/dataTableStyles.ts"
click node_dialogs "https://github.com/flipspacesit/fs-ui/tree/master/src/components"
click node_notifications "https://github.com/flipspacesit/fs-ui/blob/master/src/hooks/useNotification.tsx"
click node_theme "https://github.com/flipspacesit/fs-ui/blob/master/src/theme/index.ts"
click node_colors "https://github.com/flipspacesit/fs-ui/blob/master/src/theme/tokens/colors.ts"
click node_shadows "https://github.com/flipspacesit/fs-ui/blob/master/src/theme/tokens/shadows.ts"
click node_icons "https://github.com/flipspacesit/fs-ui/blob/master/src/icons/index.ts"
click node_constants "https://github.com/flipspacesit/fs-ui/blob/master/src/constants/index.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_api toneBlue
class node_controls,node_dropdown,node_search,node_select,node_fileupload,node_navigation toneAmber
class node_table,node_tablestate,node_tableutils,node_resize,node_tabletypes,node_tablestyles toneMint
class node_dialogs,node_notifications toneRose
class node_theme,node_colors,node_shadows,node_icons,node_constants,node_consumer toneIndigo
```

## Components

### Package surface

- [Component exports](https://github.com/flipspacesit/fs-ui/blob/master/src/index.ts): `src/index.ts`

### Inputs and navigation

- [Controls](https://github.com/flipspacesit/fs-ui/tree/master/src/components): `src/components`
- [Dropdown](https://github.com/flipspacesit/fs-ui/blob/master/src/components/Dropdown/index.tsx): `src/components/Dropdown/index.tsx`
- [Search input](https://github.com/flipspacesit/fs-ui/blob/master/src/components/SearchInput/index.tsx): `src/components/SearchInput/index.tsx`
- [Select input](https://github.com/flipspacesit/fs-ui/blob/master/src/components/SelectInput/index.tsx): `src/components/SelectInput/index.tsx`
- [File upload](https://github.com/flipspacesit/fs-ui/blob/master/src/components/FileUpload/index.tsx): `src/components/FileUpload/index.tsx`
- [Navigation](https://github.com/flipspacesit/fs-ui/blob/master/src/components/SidebarNav/index.tsx): `src/components/SidebarNav/index.tsx`

### Data presentation

- [DataTable](https://github.com/flipspacesit/fs-ui/blob/master/src/components/Table/DataTable.tsx): `src/components/Table/DataTable.tsx`
- [Table state](https://github.com/flipspacesit/fs-ui/blob/master/src/components/Table/useDataTableState.ts): `src/components/Table/useDataTableState.ts`
- [Table utilities](https://github.com/flipspacesit/fs-ui/blob/master/src/components/Table/dataTableUtils.ts): `src/components/Table/dataTableUtils.ts`
- [Column resizing](https://github.com/flipspacesit/fs-ui/blob/master/src/components/Table/useColumnResize.ts): `src/components/Table/useColumnResize.ts`
- [Table types](https://github.com/flipspacesit/fs-ui/blob/master/src/components/Table/dataTableTypes.ts): `src/components/Table/dataTableTypes.ts`
- [Table styles](https://github.com/flipspacesit/fs-ui/blob/master/src/components/Table/dataTableStyles.ts): `src/components/Table/dataTableStyles.ts`

### Overlays and feedback

- [Dialogs and modals](https://github.com/flipspacesit/fs-ui/tree/master/src/components): `src/components`
- [Notifications](https://github.com/flipspacesit/fs-ui/blob/master/src/hooks/useNotification.tsx): `src/hooks/useNotification.tsx`

### Design foundation

- [Theme](https://github.com/flipspacesit/fs-ui/blob/master/src/theme/index.ts): `src/theme/index.ts`
- [Color tokens](https://github.com/flipspacesit/fs-ui/blob/master/src/theme/tokens/colors.ts): `src/theme/tokens/colors.ts`
- [Shadow tokens](https://github.com/flipspacesit/fs-ui/blob/master/src/theme/tokens/shadows.ts): `src/theme/tokens/shadows.ts`
- [Icon exports](https://github.com/flipspacesit/fs-ui/blob/master/src/icons/index.ts): `src/icons/index.ts`
- [Control constants](https://github.com/flipspacesit/fs-ui/blob/master/src/constants/index.ts): `src/constants/index.ts`

### Other components

- **Integrating app**

## Connections

- Integrating app → Component exports: uses package (evidence: `README.md`)
- Component exports → Dropdown: exports (evidence: `src/index.ts`)
- Component exports → Search input: exports (evidence: `src/index.ts`)
- Component exports → Select input: exports (evidence: `src/index.ts`)
- Component exports → File upload: exports (evidence: `src/index.ts`)
- Component exports → Navigation: exports (evidence: `src/index.ts`)
- Component exports → DataTable: exports (evidence: `src/index.ts`)
- Component exports → Dialogs and modals: exports (evidence: `src/index.ts`)
- Component exports → Notifications: exports (evidence: `src/index.ts`)
- Dropdown → Search input: renders (evidence: `src/components/Dropdown/index.tsx`)
- Select input → Search input: uses (evidence: `src/components/SelectInput/index.tsx`)
- Table state → Table utilities: calls (evidence: `src/components/Table/useDataTableState.ts`)
- Table state → Column resizing: uses (evidence: `src/components/Table/useDataTableState.ts`)
- Column resizing → Table utilities: resolves widths (evidence: `src/components/Table/useColumnResize.ts`)
- Table utilities → Table types: uses types (evidence: `src/components/Table/dataTableUtils.ts`)
- Column resizing → Table types: uses types (evidence: `src/components/Table/useColumnResize.ts`)
- Table state → Table types: uses types (evidence: `src/components/Table/useDataTableState.ts`)
- Theme → Color tokens: reads tokens (evidence: `src/theme/index.ts`)
- Theme → Shadow tokens: reads tokens (evidence: `src/theme/index.ts`)
- Search input → Theme: uses theme (evidence: `src/components/SearchInput/index.tsx`)
- Search input → Control constants: uses helper (evidence: `src/components/SearchInput/index.tsx`)
- Dropdown → Icon exports: imports icons (evidence: `src/components/Dropdown/index.tsx`)
- File upload → Icon exports: imports icons (evidence: `src/components/FileUpload/index.tsx`)
