id: idea — migrate the web UI from HTMX to Datastar #1073

Activity

1. dezren39

   added

   kind/refactorCode restructuring with no behavior changeCode restructuring with no behavior change

   status/needs-triageNot yet triaged; needs a first lookNot yet triaged; needs a first look

   source/humanFiled directly by a humanFiled directly by a human

   on Oct 27, 2026
2. developing-today commented on Oct 27, 2026

   

   developing-todayBot

   on Oct 27, 2026 – with developing.today

   Contributor

   More actions

   CODE-217
3. dezren39

   added

   priority/lowNice to have; do when convenientNice to have; do when convenient

   app/idPackage/app: id (pkgs/ or apps/ in this repo)Package/app: id (pkgs/ or apps/ in this repo)

   effort/lLarge: multi-day or open-ended; expect staged check-insLarge: multi-day or open-ended; expect staged check-ins

   on Oct 27, 2026
4. github-actions

   assigned

   dezren39

   on Oct 27, 2026
5. dezren39 commented on Oct 27, 2026

   

   dezren39

   on Oct 27, 2026

   MemberAuthor

   More actions

   Intake review

   Related: Plan: .opencode/plans/htmx-to-datastar-migration.md (in-repo) · source: planning/roadmaps/id.md (Ideas)

   Notes: Long-term idea at priority/low by Drew's 2026-10-26 reprioritization. The plan's state is unchecked and the web codebase has moved substantially since (the ProseMirror codec work alone) — the re-validation is the real first deliverable, not the migration.

   Risks: A stale plan adopted uncritically would mis-scope the whole migration; conversely, re-validating indefinitely is its own stall — the decision is the exit.

   Suggested approach: Diff the plan's assumptions against current web/ structure first; only then decide adopt/revise/drop.

   Labels were already normalized by the filer (kind, source/human, status/needs-triage, priority, effort, app/id all present); this pass appended the acceptance criteria above and adds meta/enriched.

   🤖 Agent note · filed

   • Agent: fleet monitor
   • Session / ID: repo-fleet-monitor run 2026-10-26 22:19 CDT
   • Found via: monitor reconciliation (intake enrichment, protocol §5)
   • Task: Intake review — verified still live (filed this evening as part of Drew's roadmap/validation batch; no merged PR or commit resolves it), appended acceptance criteria, posted this review.
   • Expectation: done when the acceptance criteria above are met (effort class as labelled by the filer).
6. dezren39

   added

   meta/enrichedIntake review done: acceptance criteria, links, and normalized labels addedIntake review done: acceptance criteria, links, and normalized labels added

   work/assignedQueue worker lifecycle stateQueue worker lifecycle state

   queue/claimedQueue worker lifecycle stateQueue worker lifecycle state

   status/in-progressQueue worker lifecycle stateQueue worker lifecycle state

   and removed

   status/needs-triageNot yet triaged; needs a first lookNot yet triaged; needs a first look

   on Oct 27, 2026
7. dezren39 commented on Oct 28, 2026

   

   dezren39

   on Oct 28, 2026

   MemberAuthor

   More actions

   🤖 Agent note · picked up

   • Agent: queue worker (repo-worker-code), lane C
   • Session / ID: queue task 2358
   • Found via: queue claim
   • Task: Triage id: idea — migrate the web UI from HTMX to Datastar #1073 — re-validate the HTMX-to-Datastar migration plan against the current web/ codebase at HEAD, record deltas and a decision (adopt / revise / drop)
   • Expectation: effort s; done = triage verdict with HEAD evidence posted and the issue routed per the decision
   • Links: queue task 2358 · plan .opencode/plans/htmx-to-datastar-migration.md
8. dezren39 commented on Oct 28, 2026

   

   dezren39

   on Oct 28, 2026

   MemberAuthor

   More actions

   🤖 Agent note · done

   • Agent: queue worker (repo-worker-code), lane C
   • Session / ID: queue task 2358
   • Found via: queue claim
   • Task: Triage verdict for id: idea — migrate the web UI from HTMX to Datastar #1073 — plan re-validated against current web/ at HEAD; decision recorded below; closing as superseded
   • Expectation: done — the migration's goal state is already on main via a revised route; no implementation follow-up needed. One docs spinoff filed: docs(id): WEB.md and ARCHITECTURE.md still describe the web UI as HTMX after the Datastar migration #1789
   • Links: plan .opencode/plans/htmx-to-datastar-migration.md · docs spinoff docs(id): WEB.md and ARCHITECTURE.md still describe the web UI as HTMX after the Datastar migration #1789

   Triage verdict: SUPERSEDED — the migration already happened; the plan as written is stale

   Re-validated at main HEAD e561ab58ff76ea8e84f2b9a1f108770ebe44a734:

   The plan's goal state is on main:

   1. HTMX is gone from the id UI. Repo-wide search finds no hx-* attributes and no HX-Request handling anywhere; the only HTMX mentions left under pkgs/id are stale docs (see spinoff below) and the plan itself. (HTMX hits in pkgs/identity/ are a different, Go/templ app — out of this issue's scope.)
   2. Datastar is the client framework. pkgs/id/web/package.json depends on @starfederation/datastar ^1.0.0-beta.11; web/src/main.ts line 6 imports it, and line ~445 documents "datastar SSE-based navigation" for token refresh.
   3. Plan Branch 2 + 3 landed literally. build:css runs Tailwind CLI v4 (tailwindcss -i src/input.css ...), daisyui ^5.7.47 is a devDependency, and web/src/input.css implements the plan's spec: DaisyUI plugin, @source scanning of ../../src/web/templates.rs + TS files, and the three custom CRT themes (sneak/arch/mech, pure-black base scale, zero border-radius). web/src/theme.ts switches via data-theme.
   4. WebSockets kept, as the plan required — src/web/ still has collab.rs and tags_ws.rs (plus a newer world_ws.rs the plan predates).

   Deltas — where reality diverged from the plan:

   • Branch 1 was NOT adopted as written. There is no Rust DatastarResponse builder and no datastar-merge-fragments SSE emission in src/web/ (templates.rs/routes.rs contain neither "datastar" nor "htmx"). Navigation/SSE handling lives in the TypeScript client (web/src/navigation.ts, main.ts) instead — the architecture moved client-side, largely through the ProseMirror/codec work this issue warned had changed web/ since the plan was written.
   • The plan's file-level todo list references a web/ layout that no longer exists (the current web/src/ is a full TS app: editor, collab, world surface, search panel, each with tests).

   Decision (per this issue's acceptance criteria)

   Drop the plan as a tracking artifact; the idea is adopted-in-effect and complete. The migration the plan described — HTMX → Datastar, custom CSS → Tailwind v4 + DaisyUI v5 with CRT themes, WebSockets untouched — is the current state of main, reached via a revised server/client split. No "first migration step" implementation issue is needed, so none is filed. This issue closes as superseded.

   Spinoff filed: #1789 — pkgs/id/WEB.md (3 mentions) and pkgs/id/ARCHITECTURE.md (1 diagram label) still describe the UI as HTMX-powered; docs-only fix.
9. dezren39

   closed this as completedon Oct 28, 2026
10. developing-today

    added

    status:done

    on Oct 28, 2026
11. dezren39

    removed

    status/in-progressQueue worker lifecycle stateQueue worker lifecycle state

    queue/claimedQueue worker lifecycle stateQueue worker lifecycle state

    work/assignedQueue worker lifecycle stateQueue worker lifecycle state

    on Oct 28, 2026