mirror of
https://github.com/PerpetualSoftware/pad.git
synced 2026-10-25 22:10:25 +00:00
xarmian
13fa0c99e9
* fix(web): quick-add is `c`, and one switch turns every single-key shortcut off (BUG-3465) Mod+N reaches a page in no browser tab: Chromium reserves IDC_NEW_WINDOW (IsReservedCommandOrKey), Firefox declares accel+N reserved="true", and Safari reportedly does not dispatch it. Quick-add moves to `c` (Linear, GitHub and Jira's create key), outside editable fields and with no modifier held. Mod+N stays bound for installed-app windows but is no longer advertised. WCAG 2.1.4 needs a way to turn character-only shortcuts off, and the app already shipped `?` and j/k/h/l without one. characterKey() is now the single gate: `c`, `?`, j/k/h/l (mapped onto the arrow cases, so Ctrl+J no longer moves the list or swallows the browser's Downloads key) and the image viewer's + = - 0 read their key through it. A per-device "Single-key shortcuts" switch sits in the shortcuts modal and on the account settings page (the way back once `?` is off). Shortcut labels follow the platform: ⌘ on macOS, Ctrl elsewhere, in the modal and every tooltip. A source census fails on any raw single-character key comparison outside characterKey(), with a reasoned allow-list for focus-scoped input triggers; it is red on the unconverted bindings. Claude-Session: https://claude.ai/code/session_01Q9WssCjFuHjSfLABoW4tmS * test(e2e): the palette's dark-theme axe scan waits for the theme's transitions (BUG-3465) The scan ran the instant data-theme flipped, while the filter chips were still fading their colours (`transition: all 0.15s`), so axe read in-between values: #9b9baa on #3b3b44, 4.04:1, failing #1851's CI twice while passing 13/13 locally. Neither colour belongs to either theme. The scan now waits until no CSS transition is running. With every transition stretched to 2s, the old order fails with CI's assertion and the new one passes. Claude-Session: https://claude.ai/code/session_01Q9WssCjFuHjSfLABoW4tmS
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