Skip to content
ArclensArclens

Roadmap

Arclens development is organized in phases. This page summarizes progress from roadmap.md at the repository root.

Phase 1: Foundations

Section titled “Phase 1: Foundations”
  • Parse a single TS file
  • Read import declarations
  • Read exports
  • Understand AST traversal

Phase 2: Static analysis engine

Section titled “Phase 2: Static analysis engine”

Goal: extract architecture from code.

  • Detect React components
  • Detect hooks
  • Detect contexts
  • Detect services
  • Detect utilities

Phase 3: Relationships

Section titled “Phase 3: Relationships”

Goal: connect code together.

  • Imports
  • Uses (hook calls)
  • Renders (JSX)
  • Calls (general function call graph)
  • Exports

Phase 4: Graph engine

Section titled “Phase 4: Graph engine”

Goal: generate graph data.

  • Build nodes
  • Build edges
  • Export JSON (slim export + pre-layout)

Phase 5: Visualization

Section titled “Phase 5: Visualization”

Goal: explore architecture.

  • React Flow viewer
  • Dagre / grid layout (CLI pre-layout + viewer fallback)
  • Search (subgraph mode for large graphs)
  • Node details panel
  • Highlight dependencies (selection dimming + path from entry)
  • Folder / module clustering
  • Fit / focus on selected node
  • Save & restore viewport
  • CLI insights in sidebar
  • Entry-point shortcut (“From entry”)
  • Helper lines when dragging nodes
  • Node toolbar (focus, copy name, copy path)
  • Draggable / resizable floating panels
  • Component props in details panel

Phase 6: Intelligence

Section titled “Phase 6: Intelligence”

Goal: generate engineering insights.

  • Circular dependency detection
  • Orphan detection
  • Highly coupled modules
  • Largest components
  • Most imported / referenced modules (report + top connections)
  • Rules of Hooks violations
  • Component / hook naming hints

Phase 7: Advanced

Section titled “Phase 7: Advanced”
  • Monorepo support
  • Git integration
  • AI explanations
  • Impact analysis (--focus is a start; full impact UI pending)
  • Architecture scoring
  • Prop-flow edges (who passes what to whom)
  • Incremental analyze / watch perf

Near-term focus

Section titled “Near-term focus”

Based on open roadmap items, likely next investments include:

  1. Service detection and richer module typing
  2. Circular dependency and coupling insights
  3. npm publish workflow (arclens analyze + bundled view command)
  4. Watch performance for incremental re-analysis

Contributions welcome, see CONTRIBUTING.md in the repo root.