# po-ui/po-angular architecture

> Architecture diagram of the GitHub repository po-ui/po-angular, 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/po-ui/po-angular
- Repository: https://github.com/po-ui/po-angular

## Overview

PO UI is an Angular component library. An application adds the library, uses its UI components, and can add ready-made page templates; the repository also includes persistence, synchronization, code-editor, portal, and MCP capabilities. The README documents the application setup, templates, and MCP use. Source excerpts and the index establish only selected internal links, so unverified relationships are omitted or marked dashed.

Main entry points: [`projects/templates/src/lib/po-templates.module.ts`](https://github.com/po-ui/po-angular/blob/master/projects/templates/src/lib/po-templates.module.ts) (Page templates), [`projects/sync/src/lib/services/po-sync/po-sync.service.ts`](https://github.com/po-ui/po-angular/blob/master/projects/sync/src/lib/services/po-sync/po-sync.service.ts) (Data sync), [`projects/templates/src/lib/services/po-page-dynamic/po-page-dynamic.service.ts`](https://github.com/po-ui/po-angular/blob/master/projects/templates/src/lib/services/po-page-dynamic/po-page-dynamic.service.ts) (Dynamic pages), [`projects/sync/src/lib/services/po-event-sourcing/po-event-sourcing.service.ts`](https://github.com/po-ui/po-angular/blob/master/projects/sync/src/lib/services/po-event-sourcing/po-event-sourcing.service.ts) (Event sourcing)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_ui["UI library"]
  node_components["UI components"]
  node_table_columns["Table columns"]
  node_table_lists["Table lists"]
  node_language["Localization"]
  node_theme["Theme service"]
end

subgraph group_templates["Page templates"]
  node_templates["Page templates"]
  node_dynamic_pages["Dynamic pages"]
  node_customization["Page customization"]
  node_login["Login page"]
  node_dynamic_table["Dynamic table"]
end

subgraph group_data["Data services"]
  node_storage[("Local storage")]
  node_loki["Loki driver<br/>[po-loki-driver.ts]"]
  node_sync["Data sync<br/>[po-sync.service.ts]"]
  node_event_sourcing["Event sourcing"]
  node_http["HTTP client"]
  node_schema["Sync schemas"]
end

subgraph group_developer["Developer tools"]
  node_editor["Code editor"]
  node_mcp["MCP server<br/>[server.ts]"]
  node_docs_parser["Docs parser<br/>[llms-parser.ts]"]
end

subgraph group_showcase["Portal"]
  node_portal["Documentation portal<br/>[app.component.ts]"]
end

node_developer(("Angular developer"))
node_app["Angular application"]

node_developer -->|"creates project"| node_app
node_developer -->|"adds library"| node_components
node_app -.->|"uses components"| node_components
node_developer -->|"adds templates"| node_templates
node_app -->|"uses templates"| node_templates
node_table_columns -->|"reads language"| node_language
node_table_lists -->|"reads language"| node_language
node_dynamic_pages -.->|"uses options"| node_customization
node_templates -.->|"includes service"| node_dynamic_pages
node_templates -->|"provides page"| node_login
node_templates -->|"provides page"| node_dynamic_table
node_storage -->|"creates driver"| node_loki
node_sync -->|"uses events"| node_event_sourcing
node_sync -->|"uses client"| node_http
node_sync -->|"uses schemas"| node_schema
node_event_sourcing -->|"uses client"| node_http
node_developer -->|"requests documentation"| node_mcp
node_mcp -->|"uses parser"| node_docs_parser
node_portal -->|"applies theme"| node_theme

click node_components "https://github.com/po-ui/po-angular/blob/master/projects/ui/src/lib/components/components.module.ts"
click node_table_columns "https://github.com/po-ui/po-angular/blob/master/projects/ui/src/lib/components/po-table/po-table-column-manager/po-table-column-manager.component.ts"
click node_table_lists "https://github.com/po-ui/po-angular/blob/master/projects/ui/src/lib/components/po-table/po-table-list-manager/po-table-list-manager.component.ts"
click node_language "https://github.com/po-ui/po-angular/blob/master/projects/ui/src/lib/services/po-language/po-language.service.ts"
click node_theme "https://github.com/po-ui/po-angular/blob/master/projects/ui/src/lib/services/po-theme/po-theme.service.ts"
click node_templates "https://github.com/po-ui/po-angular/blob/master/projects/templates/src/lib/po-templates.module.ts"
click node_dynamic_pages "https://github.com/po-ui/po-angular/blob/master/projects/templates/src/lib/services/po-page-dynamic/po-page-dynamic.service.ts"
click node_customization "https://github.com/po-ui/po-angular/blob/master/projects/templates/src/lib/services/po-page-customization/po-page-customization.service.ts"
click node_login "https://github.com/po-ui/po-angular/blob/master/projects/templates/src/lib/components/po-page-login/po-page-login.component.ts"
click node_dynamic_table "https://github.com/po-ui/po-angular/blob/master/projects/templates/src/lib/components/po-page-dynamic-table/po-page-dynamic-table.component.ts"
click node_storage "https://github.com/po-ui/po-angular/blob/master/projects/storage/src/lib/services/po-storage.service.ts"
click node_loki "https://github.com/po-ui/po-angular/blob/master/projects/storage/src/lib/drivers/lokijs/po-loki-driver.ts"
click node_sync "https://github.com/po-ui/po-angular/blob/master/projects/sync/src/lib/services/po-sync/po-sync.service.ts"
click node_event_sourcing "https://github.com/po-ui/po-angular/blob/master/projects/sync/src/lib/services/po-event-sourcing/po-event-sourcing.service.ts"
click node_http "https://github.com/po-ui/po-angular/blob/master/projects/sync/src/lib/services/po-http-client/po-http-client.service.ts"
click node_schema "https://github.com/po-ui/po-angular/blob/master/projects/sync/src/lib/services/po-schema/po-schema.service.ts"
click node_editor "https://github.com/po-ui/po-angular/blob/master/projects/code-editor/src/lib/components/po-code-editor/po-code-editor.component.ts"
click node_mcp "https://github.com/po-ui/po-angular/blob/master/projects/mcp/src/server.ts"
click node_docs_parser "https://github.com/po-ui/po-angular/blob/master/projects/mcp/src/llms-parser.ts"
click node_portal "https://github.com/po-ui/po-angular/blob/master/projects/portal/src/app/app.component.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_components,node_table_columns,node_table_lists,node_language,node_theme toneBlue
class node_templates,node_dynamic_pages,node_customization,node_login,node_dynamic_table toneAmber
class node_storage,node_loki,node_sync,node_event_sourcing,node_http,node_schema toneMint
class node_editor,node_mcp,node_docs_parser toneRose
class node_portal,node_developer,node_app toneIndigo
```

## Components

### UI library

- [UI components](https://github.com/po-ui/po-angular/blob/master/projects/ui/src/lib/components/components.module.ts): `projects/ui/src/lib/components/components.module.ts`
- [Table columns](https://github.com/po-ui/po-angular/blob/master/projects/ui/src/lib/components/po-table/po-table-column-manager/po-table-column-manager.component.ts): `projects/ui/src/lib/components/po-table/po-table-column-manager/po-table-column-manager.component.ts`
- [Table lists](https://github.com/po-ui/po-angular/blob/master/projects/ui/src/lib/components/po-table/po-table-list-manager/po-table-list-manager.component.ts): `projects/ui/src/lib/components/po-table/po-table-list-manager/po-table-list-manager.component.ts`
- [Localization](https://github.com/po-ui/po-angular/blob/master/projects/ui/src/lib/services/po-language/po-language.service.ts): `projects/ui/src/lib/services/po-language/po-language.service.ts`
- [Theme service](https://github.com/po-ui/po-angular/blob/master/projects/ui/src/lib/services/po-theme/po-theme.service.ts): `projects/ui/src/lib/services/po-theme/po-theme.service.ts`

### Page templates

- [Page templates](https://github.com/po-ui/po-angular/blob/master/projects/templates/src/lib/po-templates.module.ts): `projects/templates/src/lib/po-templates.module.ts`
- [Dynamic pages](https://github.com/po-ui/po-angular/blob/master/projects/templates/src/lib/services/po-page-dynamic/po-page-dynamic.service.ts): `projects/templates/src/lib/services/po-page-dynamic/po-page-dynamic.service.ts`
- [Page customization](https://github.com/po-ui/po-angular/blob/master/projects/templates/src/lib/services/po-page-customization/po-page-customization.service.ts): `projects/templates/src/lib/services/po-page-customization/po-page-customization.service.ts`
- [Login page](https://github.com/po-ui/po-angular/blob/master/projects/templates/src/lib/components/po-page-login/po-page-login.component.ts): `projects/templates/src/lib/components/po-page-login/po-page-login.component.ts`
- [Dynamic table](https://github.com/po-ui/po-angular/blob/master/projects/templates/src/lib/components/po-page-dynamic-table/po-page-dynamic-table.component.ts): `projects/templates/src/lib/components/po-page-dynamic-table/po-page-dynamic-table.component.ts`

### Data services

- [Local storage](https://github.com/po-ui/po-angular/blob/master/projects/storage/src/lib/services/po-storage.service.ts): `projects/storage/src/lib/services/po-storage.service.ts`
- [Loki driver](https://github.com/po-ui/po-angular/blob/master/projects/storage/src/lib/drivers/lokijs/po-loki-driver.ts): `projects/storage/src/lib/drivers/lokijs/po-loki-driver.ts`
- [Data sync](https://github.com/po-ui/po-angular/blob/master/projects/sync/src/lib/services/po-sync/po-sync.service.ts): `projects/sync/src/lib/services/po-sync/po-sync.service.ts`
- [Event sourcing](https://github.com/po-ui/po-angular/blob/master/projects/sync/src/lib/services/po-event-sourcing/po-event-sourcing.service.ts): `projects/sync/src/lib/services/po-event-sourcing/po-event-sourcing.service.ts`
- [HTTP client](https://github.com/po-ui/po-angular/blob/master/projects/sync/src/lib/services/po-http-client/po-http-client.service.ts): `projects/sync/src/lib/services/po-http-client/po-http-client.service.ts`
- [Sync schemas](https://github.com/po-ui/po-angular/blob/master/projects/sync/src/lib/services/po-schema/po-schema.service.ts): `projects/sync/src/lib/services/po-schema/po-schema.service.ts`

### Developer tools

- [Code editor](https://github.com/po-ui/po-angular/blob/master/projects/code-editor/src/lib/components/po-code-editor/po-code-editor.component.ts): `projects/code-editor/src/lib/components/po-code-editor/po-code-editor.component.ts`
- [MCP server](https://github.com/po-ui/po-angular/blob/master/projects/mcp/src/server.ts): `projects/mcp/src/server.ts`
- [Docs parser](https://github.com/po-ui/po-angular/blob/master/projects/mcp/src/llms-parser.ts): `projects/mcp/src/llms-parser.ts`

### Portal

- [Documentation portal](https://github.com/po-ui/po-angular/blob/master/projects/portal/src/app/app.component.ts): `projects/portal/src/app/app.component.ts`

### Other components

- **Angular developer**
- **Angular application**

## Connections

- Angular developer → Angular application: creates project (evidence: `README.md`)
- Angular developer → UI components: adds library (evidence: `README.md`)
- Angular application → UI components: uses components
- Angular developer → Page templates: adds templates (evidence: `README.md`)
- Angular application → Page templates: uses templates (evidence: `README.md`)
- Table columns → Localization: reads language (evidence: `projects/ui/src/lib/components/po-table/po-table-column-manager/po-table-column-manager.component.ts`)
- Table lists → Localization: reads language (evidence: `projects/ui/src/lib/components/po-table/po-table-list-manager/po-table-list-manager.component.ts`)
- Dynamic pages → Page customization: uses options
- Page templates → Dynamic pages: includes service
- Page templates → Login page: provides page (evidence: `README.md`)
- Page templates → Dynamic table: provides page (evidence: `README.md`)
- Local storage → Loki driver: creates driver (evidence: `projects/storage/src/lib/services/po-storage.service.ts`)
- Data sync → Event sourcing: uses events (evidence: `projects/sync/src/lib/services/po-sync/po-sync.service.ts`)
- Data sync → HTTP client: uses client (evidence: `projects/sync/src/lib/services/po-sync/po-sync.service.ts`)
- Data sync → Sync schemas: uses schemas (evidence: `projects/sync/src/lib/services/po-sync/po-sync.service.ts`)
- Event sourcing → HTTP client: uses client (evidence: `projects/sync/src/lib/services/po-event-sourcing/po-event-sourcing.service.ts`)
- Angular developer → MCP server: requests documentation (evidence: `README.md`)
- MCP server → Docs parser: uses parser (evidence: `projects/mcp/src/server.ts`)
- Documentation portal → Theme service: applies theme (evidence: `projects/portal/src/app/app.component.ts`)
