# panhakrengg/frontend-experience-analyzer architecture

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

- Interactive diagram: https://gitdiagram.com/panhakrengg/frontend-experience-analyzer
- Repository: https://github.com/panhakrengg/frontend-experience-analyzer

## Overview

FEA audits frontend projects through offline source scanning or live-browser capture, applies configurable diagnostic rules, and produces reports, AI advice, and CI regression outputs. The CLI excerpt shows the live-scan orchestration and report writing; README statements support the broader static-scan, dashboard, and CI capabilities. Unsampled modules are represented at their exact package directories, and optional or undocumented wiring is not inferred.

Main entry points: [`apps/cli/src/index.ts`](https://github.com/panhakrengg/frontend-experience-analyzer/blob/master/apps/cli/src/index.ts) (FEA CLI), [`apps/dashboard/src/App.tsx`](https://github.com/panhakrengg/frontend-experience-analyzer/blob/master/apps/dashboard/src/App.tsx) (Dashboard app), [`packages/rules-engine/src/engine.ts`](https://github.com/panhakrengg/frontend-experience-analyzer/blob/master/packages/rules-engine/src/engine.ts) (Rules engine), [`packages/browser/src/browser.ts`](https://github.com/panhakrengg/frontend-experience-analyzer/blob/master/packages/browser/src/browser.ts) (Browser session)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_entry["User entrypoints"]
  node_cli["FEA CLI<br/>[index.ts]"]
  node_dashboard["Dashboard app<br/>[App.tsx]"]
end

subgraph group_capture["Scanning and capture"]
  node_static["Static source scanner<br/>[static-scanner.ts]"]
  node_framework["Framework detection<br/>[detector.ts]"]
  node_browser["Browser session<br/>[browser.ts]"]
  node_pagecapture["Page snapshot capture<br/>[page.ts]"]
  node_interactions["Interaction checks<br/>[interaction.ts]"]
  node_journeys["User journeys<br/>[journey.ts]"]
end

subgraph group_analysis["Diagnostic analysis"]
  node_plugins["Config and plugins"]
  node_designrules["Design system rules"]
  node_rules["Diagnostic rule set"]
  node_engine["Rules engine<br/>[engine.ts]"]
  node_core["Analysis data model"]
end

subgraph group_insights["Advice and reporting"]
  node_advisor["AI advisor<br/>[advisor.ts]"]
  node_providers["AI providers"]
  node_reporter["Report generation<br/>[html.ts]"]
end

subgraph group_consumption["Review and CI"]
  node_ci["Regression and gates"]
  node_dashboardviews["Report visualizations"]
  node_reportfile["Analysis report"]
end

node_developer(("Project maintainer"))

node_developer -->|"runs audits"| node_cli
node_developer -->|"scans source"| node_static
node_developer -->|"opens report"| node_dashboard
node_cli -->|"loads config"| node_plugins
node_cli -->|"creates engine"| node_engine
node_cli -->|"opens session"| node_browser
node_cli -->|"captures pages"| node_pagecapture
node_cli -->|"writes reports"| node_reporter
node_cli -->|"adds advice"| node_advisor
node_cli -->|"compares baseline"| node_ci
node_static -.->|"detects framework"| node_framework
node_plugins -.->|"loads rules"| node_designrules
node_engine -->|"evaluates rules"| node_rules
node_engine -->|"normalizes findings"| node_core
node_pagecapture -->|"runs checks"| node_interactions
node_browser -.->|"captures page"| node_pagecapture
node_journeys -->|"uses session"| node_browser
node_advisor -->|"selects provider"| node_providers
node_reporter -->|"renders report"| node_reportfile
node_ci -->|"reads baseline"| node_reportfile
node_dashboard -->|"loads JSON"| node_reportfile
node_dashboard -->|"renders views"| node_dashboardviews
node_reportfile -->|"presents results"| node_developer

click node_cli "https://github.com/panhakrengg/frontend-experience-analyzer/blob/master/apps/cli/src/index.ts"
click node_dashboard "https://github.com/panhakrengg/frontend-experience-analyzer/blob/master/apps/dashboard/src/App.tsx"
click node_static "https://github.com/panhakrengg/frontend-experience-analyzer/blob/master/packages/framework-adapters/src/static-scanner.ts"
click node_framework "https://github.com/panhakrengg/frontend-experience-analyzer/blob/master/packages/framework-adapters/src/detector.ts"
click node_browser "https://github.com/panhakrengg/frontend-experience-analyzer/blob/master/packages/browser/src/browser.ts"
click node_pagecapture "https://github.com/panhakrengg/frontend-experience-analyzer/blob/master/packages/browser/src/page.ts"
click node_interactions "https://github.com/panhakrengg/frontend-experience-analyzer/blob/master/packages/browser/src/interaction.ts"
click node_journeys "https://github.com/panhakrengg/frontend-experience-analyzer/blob/master/packages/browser/src/journey.ts"
click node_plugins "https://github.com/panhakrengg/frontend-experience-analyzer/tree/master/packages/plugin-system/src"
click node_designrules "https://github.com/panhakrengg/frontend-experience-analyzer/tree/master/packages/plugin-system/src/design-system-rules"
click node_rules "https://github.com/panhakrengg/frontend-experience-analyzer/tree/master/packages/rules/src/rules"
click node_engine "https://github.com/panhakrengg/frontend-experience-analyzer/blob/master/packages/rules-engine/src/engine.ts"
click node_core "https://github.com/panhakrengg/frontend-experience-analyzer/tree/master/packages/core/src/types"
click node_advisor "https://github.com/panhakrengg/frontend-experience-analyzer/blob/master/packages/ai-advisor/src/advisor.ts"
click node_providers "https://github.com/panhakrengg/frontend-experience-analyzer/tree/master/packages/ai-advisor/src/providers"
click node_reporter "https://github.com/panhakrengg/frontend-experience-analyzer/blob/master/packages/reporter/src/html.ts"
click node_ci "https://github.com/panhakrengg/frontend-experience-analyzer/tree/master/packages/ci/src"
click node_dashboardviews "https://github.com/panhakrengg/frontend-experience-analyzer/tree/master/apps/dashboard/src/components"

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_cli,node_dashboard toneBlue
class node_static,node_framework,node_browser,node_pagecapture,node_interactions,node_journeys toneAmber
class node_plugins,node_designrules,node_rules,node_engine,node_core toneMint
class node_advisor,node_providers,node_reporter toneRose
class node_ci,node_dashboardviews,node_reportfile,node_developer toneIndigo
```

## Components

### User entrypoints

- [FEA CLI](https://github.com/panhakrengg/frontend-experience-analyzer/blob/master/apps/cli/src/index.ts): `apps/cli/src/index.ts`
- [Dashboard app](https://github.com/panhakrengg/frontend-experience-analyzer/blob/master/apps/dashboard/src/App.tsx): `apps/dashboard/src/App.tsx`

### Scanning and capture

- [Static source scanner](https://github.com/panhakrengg/frontend-experience-analyzer/blob/master/packages/framework-adapters/src/static-scanner.ts): `packages/framework-adapters/src/static-scanner.ts`
- [Framework detection](https://github.com/panhakrengg/frontend-experience-analyzer/blob/master/packages/framework-adapters/src/detector.ts): `packages/framework-adapters/src/detector.ts`
- [Browser session](https://github.com/panhakrengg/frontend-experience-analyzer/blob/master/packages/browser/src/browser.ts): `packages/browser/src/browser.ts`
- [Page snapshot capture](https://github.com/panhakrengg/frontend-experience-analyzer/blob/master/packages/browser/src/page.ts): `packages/browser/src/page.ts`
- [Interaction checks](https://github.com/panhakrengg/frontend-experience-analyzer/blob/master/packages/browser/src/interaction.ts): `packages/browser/src/interaction.ts`
- [User journeys](https://github.com/panhakrengg/frontend-experience-analyzer/blob/master/packages/browser/src/journey.ts): `packages/browser/src/journey.ts`

### Diagnostic analysis

- [Config and plugins](https://github.com/panhakrengg/frontend-experience-analyzer/tree/master/packages/plugin-system/src): `packages/plugin-system/src`
- [Design system rules](https://github.com/panhakrengg/frontend-experience-analyzer/tree/master/packages/plugin-system/src/design-system-rules): `packages/plugin-system/src/design-system-rules`
- [Diagnostic rule set](https://github.com/panhakrengg/frontend-experience-analyzer/tree/master/packages/rules/src/rules): `packages/rules/src/rules`
- [Rules engine](https://github.com/panhakrengg/frontend-experience-analyzer/blob/master/packages/rules-engine/src/engine.ts): `packages/rules-engine/src/engine.ts`
- [Analysis data model](https://github.com/panhakrengg/frontend-experience-analyzer/tree/master/packages/core/src/types): `packages/core/src/types`

### Advice and reporting

- [AI advisor](https://github.com/panhakrengg/frontend-experience-analyzer/blob/master/packages/ai-advisor/src/advisor.ts): `packages/ai-advisor/src/advisor.ts`
- [AI providers](https://github.com/panhakrengg/frontend-experience-analyzer/tree/master/packages/ai-advisor/src/providers): `packages/ai-advisor/src/providers`
- [Report generation](https://github.com/panhakrengg/frontend-experience-analyzer/blob/master/packages/reporter/src/html.ts): `packages/reporter/src/html.ts`

### Review and CI

- [Regression and gates](https://github.com/panhakrengg/frontend-experience-analyzer/tree/master/packages/ci/src): `packages/ci/src`
- [Report visualizations](https://github.com/panhakrengg/frontend-experience-analyzer/tree/master/apps/dashboard/src/components): `apps/dashboard/src/components`
- **Analysis report**

### Other components

- **Project maintainer**

## Connections

- Project maintainer → FEA CLI: runs audits (evidence: `README.md`)
- Project maintainer → Static source scanner: scans source (evidence: `README.md`)
- Project maintainer → Dashboard app: opens report (evidence: `README.md`)
- FEA CLI → Config and plugins: loads config (evidence: `apps/cli/src/index.ts`)
- FEA CLI → Rules engine: creates engine (evidence: `apps/cli/src/index.ts`)
- FEA CLI → Browser session: opens session (evidence: `apps/cli/src/index.ts`)
- FEA CLI → Page snapshot capture: captures pages (evidence: `apps/cli/src/index.ts`)
- FEA CLI → Report generation: writes reports (evidence: `apps/cli/src/index.ts`)
- FEA CLI → AI advisor: adds advice (evidence: `apps/cli/src/index.ts`)
- FEA CLI → Regression and gates: compares baseline (evidence: `README.md`)
- Static source scanner → Framework detection: detects framework
- Config and plugins → Design system rules: loads rules
- Rules engine → Diagnostic rule set: evaluates rules (evidence: `packages/rules-engine/src/engine.ts`)
- Rules engine → Analysis data model: normalizes findings (evidence: `packages/rules-engine/src/engine.ts`)
- Page snapshot capture → Interaction checks: runs checks (evidence: `packages/browser/src/page.ts`)
- Browser session → Page snapshot capture: captures page
- User journeys → Browser session: uses session (evidence: `packages/browser/src/journey.ts`)
- AI advisor → AI providers: selects provider (evidence: `packages/ai-advisor/src/advisor.ts`)
- Report generation → Analysis report: renders report
- Regression and gates → Analysis report: reads baseline (evidence: `README.md`)
- Dashboard app → Analysis report: loads JSON (evidence: `apps/dashboard/src/App.tsx`)
- Dashboard app → Report visualizations: renders views (evidence: `apps/dashboard/src/App.tsx`)
- Analysis report → Project maintainer: presents results (evidence: `README.md`)
