Skip to content

feat(web): web UI v1 — list, search, tag management#37

Open
paperhurts wants to merge 19 commits into
mainfrom
feat/web-ui-v1
Open

feat(web): web UI v1 — list, search, tag management#37
paperhurts wants to merge 19 commits into
mainfrom
feat/web-ui-v1

Conversation

@paperhurts
Copy link
Copy Markdown
Owner

Summary

  • New @gitmarks/web package — Vite + React 18 + Tailwind 3 SPA, deploys to GitHub Pages or Cloudflare Pages.
  • Read-side scope per spec: list + client-side search + tag filter sidebar; tag manager (rename/recolor/add/delete) writing to tags.json only.
  • Setup flow with PAT entry, validate, and localStorage persistence. Hash routing (#/setup, #/, #/tags).
  • Reads both files via @gitmarks/core's GitHubClient with ETag conditional refresh and 409 retry-replay for writes.
  • Cyan/magenta on dark aesthetic per spec.md.

Closes #24.

Test plan

  • 67 new unit + component tests in @gitmarks/web (Vitest + jsdom + @testing-library/react)
  • Full monorepo: 228 tests pass, pnpm typecheck clean, pnpm build builds all 5 packages
  • Manual smoke test per packages/web/README.md against a real bookmarks repo
  • Deploy packages/web/dist/ to GitHub Pages and verify hash routing works under a subpath

Implementation notes

  • Plan: docs/superpowers/plans/2026-05-24-gitmarks-web-ui-v1.md (13 tasks, executed subagent-driven with per-task two-stage review).
  • Routing tests use MemoryRouter + Routes/Route rather than the production createHashRouter to sidestep a Node 24 / undici / jsdom AbortSignal instance-check incompatibility. Production wiring uses the real createHashRouter + <Navigate> redirect; the test indirection is documented inline in App.tsx and test/setup.ts.
  • useGitmarksData seeds an empty file on 404 for both bookmarks.json and tags.json so freshly-set-up users see the empty state, not a red error pill.

🤖 Generated with Claude Code

paperhurts and others added 19 commits May 24, 2026 19:47
Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
Restores <Navigate to="/setup" replace /> in RequireSettings (spec-compliant
URL sync). Tests are refactored to use MemoryRouter + Routes instead of the
data router (RouterProvider), bypassing the Node 24 undici/jsdom AbortSignal
incompatibility that caused the data router's async navigate() to throw and
leave the DOM empty. RequireSettings is now exported for test reuse.

Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
Wires up ListPage with SearchBar and TagFilter components; adds
memoized client in RequireSettings for stable useEffect deps; routing
test updated to use inline placeholder elements.

Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
Adds TagManager component with inline rename/color/delete per tag and
a new-tag row; validation errors surface inline without calling onMutate.
Wires TagsPage to use TagManager via useGitmarksData.writeTags.

Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
Add packages/web/README.md with dev/build/smoke-test/architecture
sections. Mark Web UI v1 complete in root README roadmap, append
@gitmarks/web to the packages table, update the architecture diagram.
Update CLAUDE.md package list and roadmap to reflect shipped status.

Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

Build: Web UI v1 — list / search / tag management (read-side)

1 participant