Skip to main content
This is an index. The real history lives in progres/*.md — read all of them, not just this page.
At the start of any session: cat PROGRES.md progres/status-core.md progres/status-detectors.md progres/status-web.md progres/status-infra.md progres/status-backlog.md progres/bugs.md progres/decisions.md progres/gotchas.md progres/collaborators.mdSkipping the detail files means missing most of what has actually been learned about this codebase.

​
What this is

ARCLUX is a codebase analysis tool: clone repo -> parse -> index -> build dependency graph -> interactive browser visualization. It shows how files and modules connect, what breaks if you change something, and which conventions are being violated.

​
Stack

  • Monorepo: apps/web (Next.js 16, App Router, Webpack — not Turbopack, unsupported on Termux arm64), packages/* (framework-agnostic core logic)
  • UI: React, Tailwind v4, shadcn/ui (Base UI variant) + Aceternity + Magic UI
  • Graph rendering: SVG + d3-force
  • Parsing: TypeScript Compiler API (TS/TSX) + web-tree-sitter (Python)
  • Environment: Termux on Android, not desktop
  • License: Apache 2.0

​
Progress detail

Core status

Pipeline, parser, indexer, graph, impact, incremental

Detectors status

All 18 structural detectors

Web status

apps/web, graph viewer, vendor-ui, theme

Infra status

CLI, collaborator tooling, testing, cleanup

Backlog

What is planned but not started

Bugs

Real bugs found in ARCLUX’s own code, and their fixes

Decisions

“We chose X over Y, here’s why” — design calls, not bugs

Gotchas

Environment/tooling traps, not bugs in ARCLUX’s code