feat(desktop): add Pages onboarding and polish creation flows

Merged
KI
2mo ago
+491-534

What & why

Pages now offers a Create with AI action that opens an agent workspace with explicit instructions to load the Pages skill, check CLI authentication, publish a real page, and verify comment watching. Add a Pages guide and an in-app documentation link, and simplify the Pages and Automations headers and empty states with clearer primary and manual actions. Includes translations for all 17 supported locales.

Related: SUPER-2187 — Pages need onboarding.

How I tested it

  • Desktop typecheck, targeted Biome checks, bun run check:i18n, docs MDX generation, and git diff --check passed.
  • Verified real desktop navigation, Create with AI workspace launch, and Automations manual creation. Removed the test automation afterward.
  • A fresh agent launch visibly loaded superset:page and passed CLI support and authentication checks.
  • Before/after screenshots and walkthrough in Superset Pages. First-use empty states are explicitly labeled fixtures; the launch screenshots are actual app behavior.

Remaining verification: dev publishing fails with Unable to connect because R2_ENDPOINT targets localhost:9000 and no storage service is listening. Desktop and CLI use separate auth stores; the dev CLI login was repaired locally. The skill works in dev, but the publish → comment → agent update round trip still needs verification with working storage. The evidence page was published separately using the working production CLI; it does not prove the dev flow completed.

Checklist

  • PR title follows conventional commits (type(scope): subject)
  • bun run lint and bun run typecheck pass (targeted lint and desktop typecheck passed; full monorepo checks not run)
  • "Allow edits from maintainers" is checked on fork PRs (same-repository branch)

Summary by cubic

Adds Pages onboarding with a Create with AI action and simplifies the Pages and Automations headers and empty states. Related: SUPER-2187.

  • Create with AI opens an agent workspace seeded to load the Pages skill, check CLI authentication, publish a page, and verify comment watching.
  • Adds a Pages guide to the docs and links it from the Pages header.
  • Pages and Automations headers now use a shared FeatureHeader with Create with AI as the primary action and manual creation behind a dropdown.
  • Empty states now offer Create with AI plus a manual action instead of rotating placeholder text.
  • Updates translations in all 17 locales.

Summary by CodeRabbit

  • New Features

    • Added Superset Pages documentation covering sharing, commenting, versioning, CLI publishing, and MCP support.
    • Added agent-assisted page creation with loading states and readiness checks.
    • Added manual and AI-assisted creation actions to page and automation empty states.
    • Added reusable headers with documentation links and creation actions.

  • UI Improvements

    • Refined automation template cards and empty-state layouts.
    • Updated page controls based on organization state and active filters.

  • Documentation

    • Added Pages to product navigation, overview content, and skills guidance.

  • Localization

    • Added translations for new sharing and menu actions.