feat(routing): serve the pages the manifest declares

[rubenvdlinde]

LaunchPad declared nine pages and served one. /store, /reports and /flows each redirected to /dashboard, and /reports/dashboards rendered the workspace grid — because there was no vue-router at all. createRouter appeared nowhere in src/: navigation was Pinia state that never touched the URL, and this was the only app in the fleet that did not root on CnAppRoot.

main.js has named this change since Tier 1 adoption landed, and its own file header already described the intent — "App.vue watches it and passes the live value down to CnAppRoot" — while the implementation stopped short. #549 filed the gap; this closes it.

The shell

App.vue roots on CnAppRoot. The route table is derived from manifest.pages, so a declared page is a routed page by construction. / and /dashboards/:id render WorkspaceApp; the rest render their declared page types.

The org navigation rail stays exactly where it is. It is not an app menu — it renders an org-wide tree from GET /api/admin/org-navigation, group-filtered, with its own position setting (REQ-ONAV-002/004/005). It coexists with CnAppNav rather than folding into it, and shouldRender is false on an empty tree, so a default instance has one navigation and not two.

The bespoke skip link is gone. It existed because this app did not root on NcContent; CnAppRoot renders it, and two bypass links are worse than one. #launchpad-main-content keeps tabindex="-1", which the quick-search Esc contract needs independently of any link.

A dashboard has an address

/dashboards/:id was declared in the manifest all along and routed nowhere. WorkspaceApp watches the route param — immediate, so a cold deep link selects on arrival — and calls switchDashboard. An absent or unknown id is left alone deliberately: the store's resolver already picks a sensible active dashboard, and overriding it would make a bad link empty the page instead of falling back.

Two of the nine were not pages at all

admin-settings named a component, AdminSettingsPage, that has never existed. admin-templates-index named TemplatesPage, which is a tab inside the Nextcloud admin section (lib/Settings/LaunchPadAdmin.php, mounted by src/admin.js). Routing them would have rendered half an admin surface beside the real one.

Both resolve to AdminSettingsRedirect, which sends the operator to /settings/admin/launchpad. It renders a real anchor as well as navigating, because a redirect that only runs in mounted leaves a blank page for anyone whose navigation is slow or blocked.

Tests

The four test.fail() markers come off — this is the change that earns them. Playwright fails a run when a test.fail() test passes, which is exactly the notification that was wanted.

The tripwire is inverted, not deleted. It asserted the absence of CnAppNav and existed for this moment; it now asserts the shared chrome renders with the workspace still inside it, because a shell that rendered without the grid would be a regression the nav assertion alone would not catch.

A new test asserts a dashboard has an address. It asks the app which dashboards the user has rather than seeding an id, since a hardcoded id passes on the instance it was written against and nowhere else.

Verified

check	result
check:manifest, format, check:schema-l10n, lint	all pass — this repo's four CI checks
npm run build	webpack exit 0; the 3 warnings are the pre-existing bundle-size ones
vitest WorkspaceApp	14 passed
playwright test --list	9 tests collect

The E2E leg runs only on the development push, so that run is where routing is actually proven. Two things are deliberately left for later and written into tasks.md: the org rail renders only inside WorkspaceApp, so it appears on the dashboard routes and not the others (which matches today's behaviour exactly, since there were no other routes, but is now a visible inconsistency); and DashboardsReport has never rendered, so whether its widgets resolve is unproven until that run.

🤖 Generated with Claude Code

[github-actions]

Quality Report — ConductionNL/launchpad @ a77f903

Check	PHP	Vue	Security	License	Tests
lint	✅
phpcs	✅
phpmd	✅
psalm	✅
phpstan	✅
phpmetrics	✅
eslint		✅
stylelint		✅
build		✅
check-manifest		✅
format		✅
check-schema-l10n		✅
composer			✅	✅ 104/104
npm			✅	✅ 527/527
app:check-code	⏭️
info.xml	✅
REUSE	❌
PHPUnit					✅
Newman					✅
Playwright					⏭️ deferred — runs on the promotion into beta/main, not on a pull request into development
Hydra gates					❌

---

Quality workflow — 2026-09-05 16:11 UTC

Download the full PDF report from the workflow artifacts.

[github-actions]

Quality Report — ConductionNL/launchpad @ cd31ddc

Check	PHP	Vue	Security	License	Tests
lint	✅
phpcs	✅
phpmd	✅
psalm	✅
phpstan	✅
phpmetrics	✅
eslint		✅
stylelint		✅
build		✅
check-manifest		✅
format		✅
check-schema-l10n		✅
composer			✅	✅ 104/104
npm			✅	✅ 527/527
app:check-code	⏭️
info.xml	✅
REUSE	❌
PHPUnit					✅
Newman					✅
Playwright					⏭️ deferred — runs on the promotion into beta/main, not on a pull request into development
Hydra gates					✅

---

Quality workflow — 2026-09-05 16:27 UTC

Download the full PDF report from the workflow artifacts.