alexdevlabs/visualice

How alexdevlabs/visualice works

visualice crawls a target site into a reusable route/state catalogue, captures screenshots across configured devices, and serves or exports the resulting run for inspection. The main workflow is CLI or library entry → crawl orchestration → route and state discovery → manifest/routes intent → capture → run storage → viewer. The README also describes agent-guided exploration and replay; the supplied tree has no distinct agent runtime module, so the graph represents human/agent steering through the routes file. Connections are limited to README statements and sampled imports or calls; unsampled feature links are omitted.

Main entry points: orchestrator.ts Crawl orchestration · cli.ts CLI commands · capture.ts Screenshot capture · discover-routes.ts Route discovery

Components 23

Entry and configuration

CLI commands src/cli.ts
Library API src/index.ts
Config loading src/shared/config.ts

Discovery and capture

Crawl orchestration src/crawl/orchestrator.ts
Route discovery src/crawl/discover-routes.ts
State discovery src/crawl/discover-states.ts
Discovery coordinator src/crawl/discover.ts
Login and session src/crawl/auth.ts
Screenshot capture src/crawl/capture.ts
Screen stitching src/crawl/screens.ts
Accessibility checks src/crawl/accessibility.ts

Catalogue and run data

Editable routes file src/crawl/routes-file.ts
Site manifest src/crawl/manifest.ts
Navigation recipes src/crawl/recipe.ts
Run catalogue src/crawl/runs.ts
Shared crawl utilities src/shared

Results and viewer

Viewer data server src/serve.ts
Static report export src/export.ts
Viewer application viewer/src/App.tsx
Zoomable canvas viewer/src/Canvas.tsx
Viewer data loading viewer/src/load.ts

Other components

Engineer or agent
Target website

Connections 28

Engineer or agent → CLI commands: runs commands README.md
Engineer or agent → Library API: calls directly src/index.ts
CLI commands → Config loading: loads settings src/cli.ts
CLI commands → Crawl orchestration: starts crawl src/cli.ts
Library API → Crawl orchestration: exposes pipeline src/index.ts
Crawl orchestration → Login and session: ensures session src/crawl/orchestrator.ts
Crawl orchestration → Discovery coordinator: discovers site src/crawl/orchestrator.ts
Crawl orchestration → Screenshot capture: runs capture src/crawl/orchestrator.ts
Crawl orchestration → Editable routes file: applies route intent src/crawl/orchestrator.ts
Crawl orchestration → Site manifest: loads and merges src/crawl/orchestrator.ts
Crawl orchestration → Run catalogue: manages runs src/crawl/orchestrator.ts
Discovery coordinator → Route discovery: finds routes src/crawl/discover.ts
Discovery coordinator → State discovery: probes states src/crawl/discover.ts
Route discovery → Target website: navigates pages src/crawl/discover-routes.ts
Route discovery → Navigation recipes: navigates with src/crawl/discover-routes.ts
Login and session → Navigation recipes: replays login src/crawl/auth.ts
Screenshot capture → Screen stitching: captures screens src/crawl/capture.ts
Screenshot capture → Accessibility checks: checks captures src/crawl/capture.ts
Screenshot capture → Site manifest: records results src/crawl/capture.ts
Editable routes file → Site manifest: steers catalogue src/crawl/routes-file.ts
Crawl orchestration → Shared crawl utilities: uses shared helpers src/crawl/orchestrator.ts
Viewer data server → Run catalogue: lists run data src/serve.ts
CLI commands → Viewer data server: starts viewer src/cli.ts
Viewer data server → Viewer application: serves application src/serve.ts
Viewer application → Viewer data loading: loads catalogue viewer/src/App.tsx
Viewer application → Zoomable canvas: renders canvas viewer/src/App.tsx
CLI commands → Static report export: exports report src/cli.ts
Static report export → Run catalogue: exports run src/export.ts

Drawn by GitDiagram on November 12, 2026 from the repository's file tree, README and source files. Read as Markdown ·