mirror of https://github.com/PerpetualSoftware/pad.git synced 2026-09-21 10:03:29 +00:00

Files

T

xarmian 403cf6b149 feat(web): Blank-first picker + post-create /pad onboard guidance (TASK-1506) (#579 )

* feat(web): surface Blank as featured card + post-create /pad onboard guidance (TASK-1506)

The console workspace-creation page (web/src/routes/console/new) now
makes the agent-driven flow first-class on both the picker and the
post-create screen:

Picker:
- Blank template renders as a leading "featured" card above the
  grouped category list, with an "Agent-driven" badge so its
  positioning is intentional rather than visually accidental.
- The grouped category iteration filters Blank out so it doesn't
  render twice. Older server builds that don't ship Blank degrade
  silently — the featured card just doesn't appear.

Post-create success state:
- Replaces the pre-task immediate goto-redirect that took users
  straight to the dashboard, hiding the canonical /pad onboard
  entry point.
- Branches on template:
  - Blank: prominent onboard card with a heading, a copy/paste
    snippet (<pre><code>/pad onboard</code></pre>), and a help line
    pointing at the agent-connection docs.
  - Non-blank: subtle one-paragraph affordance — "want to customize
    further? run /pad onboard."
- "Open <workspace>" CTA renders as an <a> styled like .submit-btn
  so the success screen is one click from the workspace dashboard.

Implementation notes:
- Script uses $state for createdWorkspace + createdTemplate to swap
  the layout, $derived for blankTemplate / grouped / username,
  $derived.by for workspaceUrl (multi-statement derivation).
- 'goto' import removed (no longer needed — the swap replaces the
  redirect).

Verification:
- svelte-autofixer: 0 issues, 0 suggestions.
- svelte-check: 0 errors (pre-existing warnings in unrelated files).
- npm run build: clean.
- go test ./... + golangci-lint: clean (Go side untouched).

Parent: PLAN-1496.

* fix(web): repoint Connect-MCP link to existing getpad.dev docs (Codex round 1)

P2 finding on PR #579: /docs/agents is not a route in this app (no
/docs prefix exists; only the marketing site at getpad.dev owns the
docs surface). Clicking the link from the success state would land
on the app's 404 page.

Repointed to https://getpad.dev/docs — the same external URL the
+error.svelte page already uses for 'Browse docs' (known-good and
known-stable). Added target/rel attrs matching the existing external
getpad.dev links elsewhere in the codebase.

Parent: PLAN-1496, addressing Codex round 1 on PR #579 / TASK-1506.

2026-05-17 16:23:05 -04:00

.vscode

Initial release

2026-03-26 01:52:36 +00:00

e2e

refactor(e2e): extract demo data into shared module (TASK-1201) (#431 )

2026-05-07 10:32:52 -04:00

src

feat(web): Blank-first picker + post-create /pad onboard guidance (TASK-1506) (#579 )

2026-05-17 16:23:05 -04:00

static

feat(brand): new tagline — Project Management for the agent era (#351 )

2026-05-01 15:01:08 -04:00

.gitignore

test(e2e): Playwright smoke test infrastructure + 2 dashboard tests (TASK-689) (#225 )

2026-04-22 22:35:08 -04:00

.npmrc

Initial release

2026-03-26 01:52:36 +00:00

package-lock.json

feat(web): localSearch MiniSearch store (TASK-1363) (#508 )

2026-05-11 22:35:40 -04:00

package.json

feat(web): localSearch MiniSearch store (TASK-1363) (#508 )

2026-05-11 22:35:40 -04:00

playwright.config.ts

test(e2e): Playwright smoke test infrastructure + 2 dashboard tests (TASK-689) (#225 )

2026-04-22 22:35:08 -04:00

README.md

Initial release

2026-03-26 01:52:36 +00:00

svelte.config.js

Initial release

2026-03-26 01:52:36 +00:00

tsconfig.json

Initial release

2026-03-26 01:52:36 +00:00

vite.config.ts

Initial release

2026-03-26 01:52:36 +00:00

README.md

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
      activity/              ActivityFeed
    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