# amit-tzadok/os-dpi architecture

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

- Interactive diagram: https://gitdiagram.com/amit-tzadok/os-dpi
- Repository: https://github.com/amit-tzadok/os-dpi

## Overview

Open AAC Prototype is a browser-based environment for designing and running AAC boards. A designer loads or edits board content, layout, actions, and access settings; the running board renders that design, accepts input through access methods or direct taps, applies actions, and can speak or suggest utterances. Persistence, speech/AI assistance, and visual-scene content are important supporting capabilities. The graph follows documented behavior and shown references; unsampled modules are represented at their known source paths, with uncertain connections omitted.

Main entry points: [`src/start.js`](https://github.com/amit-tzadok/os-dpi/blob/main/src/start.js) (App startup), [`src/components/speechSuggestions.js`](https://github.com/amit-tzadok/os-dpi/blob/main/src/components/speechSuggestions.js) (Speech suggestions), [`src/components/tapRouter.js`](https://github.com/amit-tzadok/os-dpi/blob/main/src/components/tapRouter.js) (Tap routing), [`src/components/speech.js`](https://github.com/amit-tzadok/os-dpi/blob/main/src/components/speech.js) (Speech output)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_runtime["Board Runtime"]
  node_startup["App startup<br/>[start.js]"]
  node_renderer["Board rendering<br/>[render.js]"]
  node_tap["Tap routing<br/>[tapRouter.js]"]
  node_actions["Action rules<br/>[actions.js]"]
end

subgraph group_design["Design and Access"]
  node_layout["Layout editor<br/>[layout.js]"]
  node_designer_ui["Designer panels<br/>[designer.js]"]
  node_access["Access methods<br/>[index.js]"]
  node_patterns["Access patterns<br/>[index.js]"]
  node_cues["Access cues<br/>[index.js]"]
end

subgraph group_content["Content and Assistance"]
  node_content["Board content<br/>[content.js]"]
  node_tree["Board components<br/>[treebase.js]"]
  node_speech["Speech output<br/>[speech.js]"]
  node_suggestions["Speech suggestions"]
  node_pictograms["Pictograms<br/>[pictograms.js]"]
  node_vsd["Visual scene display<br/>[vsd.js]"]
  node_ai["AI assistance<br/>[index.js]"]
end

subgraph group_platform["State and Persistence"]
  node_state["App state<br/>[state.js]"]
  node_data["Content data<br/>[data.js]"]
  node_db[("Design database<br/>[db.js]")]
  node_globals["Shared globals<br/>[globals.js]"]
end

node_user(("AAC user"))
node_designer(("Board designer"))

node_designer -->|"starts design"| node_startup
node_user -->|"taps board"| node_tap
node_startup -->|"initializes"| node_state
node_startup -->|"loads content"| node_data
node_startup -->|"reads design"| node_db
node_startup -->|"loads layout"| node_layout
node_startup -->|"renders via"| node_renderer
node_startup -->|"refreshes methods"| node_access
node_startup -->|"renders cues"| node_patterns
node_startup -->|"renders cues"| node_cues
node_startup -->|"shows editor"| node_designer_ui
node_startup -->|"registers component"| node_content
node_startup -->|"registers component"| node_actions
node_startup -->|"renders suggestions"| node_suggestions
node_tap -->|"applies rules"| node_actions
node_tap -->|"speaks label"| node_speech
node_tap -->|"resets exchange"| node_suggestions
node_access -->|"selects pattern"| node_patterns
node_speech -->|"uses components"| node_tree
node_speech -->|"supports suggestions"| node_suggestions
node_suggestions -->|"requests assistance"| node_ai
node_suggestions -->|"uses pictograms"| node_pictograms
node_suggestions -->|"uses components"| node_tree
node_db -->|"reads shared state"| node_globals
node_designer_ui -.->|"edits layout"| node_layout
node_content -.->|"includes scene display"| node_vsd
node_ai -.->|"provides predictions"| node_suggestions

click node_startup "https://github.com/amit-tzadok/os-dpi/blob/main/src/start.js"
click node_renderer "https://github.com/amit-tzadok/os-dpi/blob/main/src/render.js"
click node_tap "https://github.com/amit-tzadok/os-dpi/blob/main/src/components/tapRouter.js"
click node_actions "https://github.com/amit-tzadok/os-dpi/blob/main/src/components/actions.js"
click node_layout "https://github.com/amit-tzadok/os-dpi/blob/main/src/components/layout.js"
click node_designer_ui "https://github.com/amit-tzadok/os-dpi/blob/main/src/components/designer.js"
click node_access "https://github.com/amit-tzadok/os-dpi/blob/main/src/components/access/method/index.js"
click node_patterns "https://github.com/amit-tzadok/os-dpi/blob/main/src/components/access/pattern/index.js"
click node_cues "https://github.com/amit-tzadok/os-dpi/blob/main/src/components/access/cues/index.js"
click node_content "https://github.com/amit-tzadok/os-dpi/blob/main/src/components/content.js"
click node_tree "https://github.com/amit-tzadok/os-dpi/blob/main/src/components/treebase.js"
click node_speech "https://github.com/amit-tzadok/os-dpi/blob/main/src/components/speech.js"
click node_suggestions "https://github.com/amit-tzadok/os-dpi/blob/main/src/components/speechSuggestions.js"
click node_pictograms "https://github.com/amit-tzadok/os-dpi/blob/main/src/components/pictograms.js"
click node_vsd "https://github.com/amit-tzadok/os-dpi/blob/main/src/components/vsd.js"
click node_ai "https://github.com/amit-tzadok/os-dpi/blob/main/src/components/ai/index.js"
click node_state "https://github.com/amit-tzadok/os-dpi/blob/main/src/state.js"
click node_data "https://github.com/amit-tzadok/os-dpi/blob/main/src/data.js"
click node_db "https://github.com/amit-tzadok/os-dpi/blob/main/src/db.js"
click node_globals "https://github.com/amit-tzadok/os-dpi/blob/main/src/globals.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_startup,node_renderer,node_tap,node_actions,node_user toneBlue
class node_layout,node_designer_ui,node_access,node_patterns,node_cues toneAmber
class node_content,node_tree,node_speech,node_suggestions,node_pictograms,node_vsd,node_ai toneMint
class node_state,node_data,node_db,node_globals toneRose
class node_designer toneIndigo
```

## Components

### Board Runtime

- [App startup](https://github.com/amit-tzadok/os-dpi/blob/main/src/start.js): `src/start.js`
- [Board rendering](https://github.com/amit-tzadok/os-dpi/blob/main/src/render.js): `src/render.js`
- [Tap routing](https://github.com/amit-tzadok/os-dpi/blob/main/src/components/tapRouter.js): `src/components/tapRouter.js`
- [Action rules](https://github.com/amit-tzadok/os-dpi/blob/main/src/components/actions.js): `src/components/actions.js`

### Design and Access

- [Layout editor](https://github.com/amit-tzadok/os-dpi/blob/main/src/components/layout.js): `src/components/layout.js`
- [Designer panels](https://github.com/amit-tzadok/os-dpi/blob/main/src/components/designer.js): `src/components/designer.js`
- [Access methods](https://github.com/amit-tzadok/os-dpi/blob/main/src/components/access/method/index.js): `src/components/access/method/index.js`
- [Access patterns](https://github.com/amit-tzadok/os-dpi/blob/main/src/components/access/pattern/index.js): `src/components/access/pattern/index.js`
- [Access cues](https://github.com/amit-tzadok/os-dpi/blob/main/src/components/access/cues/index.js): `src/components/access/cues/index.js`

### Content and Assistance

- [Board content](https://github.com/amit-tzadok/os-dpi/blob/main/src/components/content.js): `src/components/content.js`
- [Board components](https://github.com/amit-tzadok/os-dpi/blob/main/src/components/treebase.js): `src/components/treebase.js`
- [Speech output](https://github.com/amit-tzadok/os-dpi/blob/main/src/components/speech.js): `src/components/speech.js`
- [Speech suggestions](https://github.com/amit-tzadok/os-dpi/blob/main/src/components/speechSuggestions.js): `src/components/speechSuggestions.js`
- [Pictograms](https://github.com/amit-tzadok/os-dpi/blob/main/src/components/pictograms.js): `src/components/pictograms.js`
- [Visual scene display](https://github.com/amit-tzadok/os-dpi/blob/main/src/components/vsd.js): `src/components/vsd.js`
- [AI assistance](https://github.com/amit-tzadok/os-dpi/blob/main/src/components/ai/index.js): `src/components/ai/index.js`

### State and Persistence

- [App state](https://github.com/amit-tzadok/os-dpi/blob/main/src/state.js): `src/state.js`
- [Content data](https://github.com/amit-tzadok/os-dpi/blob/main/src/data.js): `src/data.js`
- [Design database](https://github.com/amit-tzadok/os-dpi/blob/main/src/db.js): `src/db.js`
- [Shared globals](https://github.com/amit-tzadok/os-dpi/blob/main/src/globals.js): `src/globals.js`

### Other components

- **AAC user**
- **Board designer**

## Connections

- Board designer → App startup: starts design (evidence: `README.md`)
- AAC user → Tap routing: taps board (evidence: `src/components/tapRouter.js`)
- App startup → App state: initializes (evidence: `src/start.js`)
- App startup → Content data: loads content (evidence: `src/start.js`)
- App startup → Design database: reads design (evidence: `src/start.js`)
- App startup → Layout editor: loads layout (evidence: `src/start.js`)
- App startup → Board rendering: renders via (evidence: `src/start.js`)
- App startup → Access methods: refreshes methods (evidence: `src/start.js`)
- App startup → Access patterns: renders cues (evidence: `src/start.js`)
- App startup → Access cues: renders cues (evidence: `src/start.js`)
- App startup → Designer panels: shows editor (evidence: `src/start.js`)
- App startup → Board content: registers component
- App startup → Action rules: registers component (evidence: `src/start.js`)
- App startup → Speech suggestions: renders suggestions (evidence: `src/start.js`)
- Tap routing → Action rules: applies rules (evidence: `src/components/tapRouter.js`)
- Tap routing → Speech output: speaks label (evidence: `src/components/tapRouter.js`)
- Tap routing → Speech suggestions: resets exchange (evidence: `src/components/tapRouter.js`)
- Access methods → Access patterns: selects pattern (evidence: `src/components/access/method/index.js`)
- Speech output → Board components: uses components (evidence: `src/components/speech.js`)
- Speech output → Speech suggestions: supports suggestions (evidence: `src/components/speechSuggestions.js`)
- Speech suggestions → AI assistance: requests assistance (evidence: `src/components/speechSuggestions.js`)
- Speech suggestions → Pictograms: uses pictograms (evidence: `src/components/speechSuggestions.js`)
- Speech suggestions → Board components: uses components (evidence: `src/components/speechSuggestions.js`)
- Design database → Shared globals: reads shared state (evidence: `src/db.js`)
- Designer panels → Layout editor: edits layout
- Board content → Visual scene display: includes scene display
- AI assistance → Speech suggestions: provides predictions (evidence: `src/components/speechSuggestions.js`)
