Files
pad/web
xarmian 275efc17be fix(web): a starting copy preview cancels the debounce it already answers (BUG-3151) (#1440)
* fix(web): a starting copy preview cancels the debounce it already answers (BUG-3151)

copy-dialog.spec.ts' coalescing test failed in 2 of 3 full desktop runs
(4 preflights instead of 3) and passed in isolation. The CI traces show the
4th request's body is byte-identical to the 3rd's.

The runner reads the current state when a run starts, so that run answers
every edit made before it, including one whose debounce timer is still
pending. When edits are spaced wider than the 250ms debounce while a preview
is in flight, the earlier edit's timer queues the trailing run. The last
edit's own timer is then still pending when that trailing run starts, and it
fires afterwards to send the same body again. Suite load is what spaced the
test's picks that wide; a 300ms gap reproduces it with no load, every time.

runPreflight now cancels any pending debounce timer when it starts a run or
queues the trailing one. The spec runs the collapse test at two pick spacings
(0ms and 350ms). It waits out the debounce before counting, because the
duplicate arrives after the point where the count used to be read.

* test(e2e): derive the copy-dialog collapse spec's timings from the shared debounce constant (BUG-3151, lead condition)
2026-09-22 16:56:44 -04:00
..
2026-03-26 01:52:36 +00:00
2026-03-26 01:52:36 +00:00
2026-03-26 01:52:36 +00:00
2026-03-26 01:52:36 +00:00

Pad Web UI

SvelteKit 2 + Svelte 5 frontend for Pad, compiled to static files and embedded into the Go binary.

Development

npm install
npm run dev          # Dev server at localhost:5173 (proxies API to localhost:7777)
npm run build        # Production build to build/
npm run check        # Type checking with svelte-check

When developing, run the Go backend separately with make dev from the project root.

Building for Production

Do not build in isolation. Always use make build from the project root — this builds the web frontend, then compiles the Go binary with the build output embedded via //go:embed.

Stack

  • Svelte 5 with runes ($state, $derived, $effect)
  • SvelteKit 2 with adapter-static (SPA mode)
  • Tiptap block editor with markdown round-trip
  • svelte-dnd-action for drag-and-drop in board/list views
  • SSE for real-time updates
  • TypeScript throughout

Structure

src/
  routes/                    SvelteKit pages
    +layout.svelte           App shell (sidebar + main)
    +page.svelte             Landing/redirect
    [workspace]/
      +page.svelte           Dashboard (collections, phases, activity)
      +layout.svelte         SSE connection per workspace
      [collection]/
        +page.svelte         Collection view (board/list)
      [collection]/[item]/
        +page.svelte         Item detail + editor
      conventions/            Purpose-built conventions page
      playbooks/              Purpose-built playbooks page
      settings/               Workspace settings
  lib/
    api/client.ts            HTTP API client
    components/
      layout/                Sidebar, navigation
      editor/                Tiptap editor, raw markdown editor
      fields/                FieldEditor, relation picker
      items/                 ItemCard, ItemDetail
      collections/           BoardView, ListView
      common/                StatusBadge, badges, modals
      search/                CommandPalette
    stores/                  Svelte 5 reactive stores
      workspace.svelte.ts    Workspace state
      collections.svelte.ts  Collection + item state
      ui.svelte.ts           Sidebar, mobile state
    types/index.ts           TypeScript types and constants
  app.css                    Global styles and design tokens