Beautiful, AI-native markdown IDE and LLM wiki
TypeScript 2nd-brainagent-skillsclaudecodexcompany-braindocsknowledge-knowledge-baseknowledge-managementllmllm-wikillm-wiki-karpathymarkdownmarkdown-editormdmdxnotespkmsecond-brainskills
feat(ok): one launcher layout, with a starter-pack line on first run (#2887)
sarah7014caedff4b
diff --git a/.changeset/launcher-starter-pack-line.md b/.changeset/launcher-starter-pack-line.mdnew file mode 100644index 000000000..b516cb568--- /dev/null+++ b/.changeset/launcher-starter-pack-line.md@@ -0,0 +1,9 @@+---+"@inkeep/open-knowledge": patch+---++The launcher now leads with the same four actions whether or not you have recent projects.++Previously a brand-new user got a different screen: a grid of starter-pack cards, with Open folder, Open file, Clone from GitHub, and Blank project demoted to a row of small links underneath. Anyone who came back after creating a project saw a layout that shared nothing with the one they had learned.++Create new project, Open folder on disk, Open file on disk, and Clone from GitHub are now the primary actions in both states. When there are no recent projects, a subtle line takes the Recent list's place: the first three starter packs as pills, plus a count that opens a picker with the full set and their descriptions. Picking a pack from either place opens the create dialog with that pack selected, exactly as before.diff --git a/docs/content/get-started/quickstart.mdx b/docs/content/get-started/quickstart.mdxindex 9c34c851b..8a20118b7 100644--- a/docs/content/get-started/quickstart.mdx+++ b/docs/content/get-started/quickstart.mdx@@ -29,7 +29,7 @@ Download the latest version of the OpenKnowledge desktop app for macOS.### Create a new project- Open the OpenKnowledge app. On first launch, approve the **Connect your AI tools to OpenKnowledge** dialog — it wires up your AI editors and can add the `ok` command to your terminal. If you skip it, re-open it later from **File → Set up OpenKnowledge integrations…**.-- You'll then land on the starter-pack picker ("What do you want to build?"). To follow this guide, choose **Blank project** under "Have something else in mind?" — or pick a starter pack (for example **Knowledge base**) to scaffold ready-made folders and templates up front and skip the Initialize step below.+- You'll then land on the launcher. To follow this guide, choose **Create new project** — or pick a starter pack from the **or use a starter pack** line beneath the cards (for example **Knowledge base**) to scaffold ready-made folders and templates up front and skip the Initialize step below. The count at the end of that line opens the full set of packs.- Type a name for your project (for example, *Team Wiki*).- Optionally click **Browse** to change where the project is saved, then click **Create**.diff --git a/packages/app/src/components/NavigatorApp.first-run.dom.test.tsx b/packages/app/src/components/NavigatorApp.first-run.dom.test.tsxindex 445219cdc..9f15afe1b 100644--- a/packages/app/src/components/NavigatorApp.first-run.dom.test.tsx+++ b/packages/app/src/components/NavigatorApp.first-run.dom.test.tsx@@ -8,19 +8,27 @@ let createDialogProps: Array<{packs?: Array<{ id: string }>;onOpenChange?: (next: boolean) => void;}> = [];-let listPacksImpl: () => Promise<unknown> = () =>- Promise.resolve({- ok: true,- packs: [- {- id: 'knowledge-base',- name: 'Knowledge base',- description: '',- folders: [],- entryCounts: { files: 0, folders: 0 },- },- ],- });+const PACK_IDS = [+ 'knowledge-base',+ 'software-lifecycle',+ 'codebase-wiki',+ 'plain-notes',+ 'worldbuilding',+] as const;++function packFixture() {+ return PACK_IDS.map((id) => ({+ id,+ name: id,+ description: '',+ folders: [],+ entryCounts: { files: 0, folders: 0 },+ }));+}++const okPacks = () => Promise.resolve({ ok: true, packs: packFixture() });++let listPacksImpl: () => Promise<unknown> = okPacks;vi.doMock('next-themes', () => ({useTheme: () => ({ theme: undefined }),@@ -48,30 +56,33 @@ vi.doMock('./ui/badge', () => ({),}));-// Stub the pack grid: expose a single card whose click fires onPackSelect so-// the launcher's pack → dialog wiring can be asserted without the real grid.-// The card only renders once `packs` has loaded (mirrors the real grid, which-// shows skeletons while null) — so `findByTestId(card)` waits for the launcher's-// listPacks fetch to settle before a click, and the resolved pack name is-// available by then (avoids racing the async fetch under full-suite timing).+// Stub the pack grid: one card per pack whose click fires onPackSelect, so the+// picker dialog's wiring can be asserted without the real grid. `iconForPack` is+// stubbed too — NavigatorApp imports it for the pill row.vi.doMock('./PackCardGrid', () => ({+ iconForPack: () => () => null,PackCardGrid: ({onPackSelect,packs,}: {onPackSelect: (id: string) => void;- packs?: unknown[] | null;+ packs?: Array<{ id: string }> | null;}) =>packs == null ? (<div data-testid="pack-grid-loading" />) : (- <button- type="button"- data-testid="pack-card-knowledge-base"- onClick={() => onPackSelect('knowledge-base')}- >- Knowledge base- </button>+ <div>+ {packs.map((pack) => (+ <button+ key={pack.id}+ type="button"+ data-testid={`pack-card-${pack.id}`}+ onClick={() => onPackSelect(pack.id)}+ >+ {pack.id}+ </button>+ ))}+ </div>),}));@@ -152,66 +163,105 @@ async function renderNavigator(bridge: ReturnType<typeof createBridge>) {// dependencies bind to the stubs rather than the real modules.const { NavigatorApp } = await import('./NavigatorApp');-describe('NavigatorApp first-run packs-forward launcher', () => {+describe('NavigatorApp launcher — starter-pack line', () => {beforeEach(() => {cleanup();Reflect.deleteProperty(window, 'okDesktop');createDialogProps = [];+ listPacksImpl = okPacks;+ });++ afterEach(() => cleanup());++ test('shows the four launcher cards plus the starter-pack line when there are no recents', async () => {+ const bridge = createBridge([]);+ await renderNavigator(bridge);++ // The four doors are the primary actions on first run, same as for a+ // returning user — the layout no longer swaps between the two states.+ expect(await screen.findByTestId('nav-create-new')).not.toBeNull();+ expect(screen.getByTestId('nav-open')).not.toBeNull();+ expect(screen.getByTestId('nav-open-file')).not.toBeNull();+ expect(screen.getByTestId('nav-clone')).not.toBeNull();++ // Starter-pack line: first three packs as pills, rest behind the count.+ const row = await screen.findByTestId('nav-starter-packs');+ expect(row.textContent).toContain('or use a starter pack');+ expect(screen.getByTestId('nav-pack-pill-knowledge-base')).not.toBeNull();+ expect(screen.getByTestId('nav-pack-pill-software-lifecycle')).not.toBeNull();+ expect(screen.getByTestId('nav-pack-pill-codebase-wiki')).not.toBeNull();+ // Packs 4 and 5 are not pills — they live behind the overflow affordance.+ expect(screen.queryByTestId('nav-pack-pill-plain-notes')).toBeNull();+ expect(screen.getByTestId('nav-pack-more').textContent).toContain('2');+ });++ test('the overflow count carries an accessible name naming the total', async () => {+ const bridge = createBridge([]);+ await renderNavigator(bridge);++ // "+2 more" alone is a vague label out of visual context; the accessible+ // name has to say what the count refers to.+ const more = await screen.findByTestId('nav-pack-more');+ expect(more.getAttribute('aria-label')).toBe('See all 5 starter packs');+ });++ test('no overflow affordance when every pack fits in the pill row', async () => {listPacksImpl = () =>Promise.resolve({ok: true,- packs: [- {- id: 'knowledge-base',- name: 'Knowledge base',- description: '',- folders: [],- entryCounts: { files: 0, folders: 0 },- },- ],+ packs: packFixture().slice(0, 3),});- });+ const bridge = createBridge([]);+ await renderNavigator(bridge);- afterEach(() => cleanup());+ await screen.findByTestId('nav-pack-pill-codebase-wiki');+ expect(screen.queryByTestId('nav-pack-more')).toBeNull();+ });- test('leads with the pack grid + demoted secondary row when there are no recents', async () => {+ test('pill click opens the create dialog with the pack pre-selected + the pack list', async () => {const bridge = createBridge([]);await renderNavigator(bridge);- // Packs-forward view present; three-card launcher absent.- const firstRun = await screen.findByTestId('nav-first-run');- expect(firstRun.textContent).toContain('What do you want to build?');- expect(screen.queryByTestId('nav-create-new')).toBeNull();+ fireEvent.click(await screen.findByTestId('nav-pack-pill-knowledge-base'));- // Secondary row keeps all three original doors.- expect(screen.getByTestId('nav-first-run-open')).not.toBeNull();- expect(screen.getByTestId('nav-first-run-clone')).not.toBeNull();- expect(screen.getByTestId('nav-first-run-blank')).not.toBeNull();+ await waitFor(() => {+ const dialog = screen.getByTestId('create-project-dialog');+ expect(dialog.getAttribute('data-open')).toBe('true');+ expect(dialog.getAttribute('data-pack-id')).toBe('knowledge-base');+ // The full pack list (not a name string) threads through so the dialog+ // can look up the chosen pack's display metadata.+ expect(dialog.getAttribute('data-pack-count')).toBe('5');+ });});- test('pack click opens the create dialog with the pack pre-selected + the pack list', async () => {+ test('the overflow count opens the picker, and picking there opens the create dialog', async () => {const bridge = createBridge([]);await renderNavigator(bridge);- const card = await screen.findByTestId('pack-card-knowledge-base');+ fireEvent.click(await screen.findByTestId('nav-pack-more'));++ // The picker shows every pack — including the ones the pill row omitted.+ const card = await screen.findByTestId('pack-card-plain-notes');fireEvent.click(card);await waitFor(() => {const dialog = screen.getByTestId('create-project-dialog');expect(dialog.getAttribute('data-open')).toBe('true');- expect(dialog.getAttribute('data-pack-id')).toBe('knowledge-base');- // The full pack list (not a name string) threads through so the dialog- // can look up the chosen pack's display metadata — the stub listPacks- // returns one pack.- expect(dialog.getAttribute('data-pack-count')).toBe('1');+ expect(dialog.getAttribute('data-pack-id')).toBe('plain-notes');+ // Same assertion as the pill path: both routes must thread the full list,+ // not just the chosen id, or the dialog loses the pack's display metadata.+ expect(dialog.getAttribute('data-pack-count')).toBe('5');});+ // Picking dismisses the picker rather than stacking it under the create+ // dialog.+ await waitFor(() => expect(screen.queryByTestId('nav-pack-picker')).toBeNull());});- test('secondary Blank project opens the create dialog with no pack selected', async () => {+ test('Create new project opens the create dialog with no pack selected', async () => {const bridge = createBridge([]);await renderNavigator(bridge);- fireEvent.click(await screen.findByTestId('nav-first-run-blank'));+ fireEvent.click(await screen.findByTestId('nav-create-new'));await waitFor(() => {const dialog = screen.getByTestId('create-project-dialog');expect(dialog.getAttribute('data-open')).toBe('true');@@ -219,11 +269,11 @@ describe('NavigatorApp first-run packs-forward launcher', () => {});});- test('secondary Open folder routes through the pick-existing entry point', async () => {+ test('Open folder on disk routes through the pick-existing entry point', async () => {const bridge = createBridge([]);await renderNavigator(bridge);- fireEvent.click(await screen.findByTestId('nav-first-run-open'));+ fireEvent.click(await screen.findByTestId('nav-open'));await waitFor(() => {expect(bridge.project.open).toHaveBeenCalledWith({path: '/picked/folder',@@ -233,12 +283,12 @@ describe('NavigatorApp first-run packs-forward launcher', () => {});});- test('pack selection clears on dialog close — reopening Blank carries no stale pack', async () => {+ test('pack selection clears on dialog close — reopening Create carries no stale pack', async () => {const bridge = createBridge([]);await renderNavigator(bridge);- // Open via a pack card → dialog carries the pre-selected pack.- fireEvent.click(await screen.findByTestId('pack-card-knowledge-base'));+ // Open via a pack pill → dialog carries the pre-selected pack.+ fireEvent.click(await screen.findByTestId('nav-pack-pill-knowledge-base'));await waitFor(() => {const dialog = screen.getByTestId('create-project-dialog');expect(dialog.getAttribute('data-open')).toBe('true');@@ -251,9 +301,9 @@ describe('NavigatorApp first-run packs-forward launcher', () => {expect(screen.getByTestId('create-project-dialog').getAttribute('data-open')).toBe('false');});- // Reopen via the secondary "Blank project" door — the stale packId must+ // Reopen via the blank "Create new project" door — the stale packId must// not leak in, or the blank-create path would silently seed a pack.- fireEvent.click(screen.getByTestId('nav-first-run-blank'));+ fireEvent.click(screen.getByTestId('nav-create-new'));await waitFor(() => {const dialog = screen.getByTestId('create-project-dialog');expect(dialog.getAttribute('data-open')).toBe('true');@@ -261,38 +311,82 @@ describe('NavigatorApp first-run packs-forward launcher', () => {});});- test('listPacks error still renders a usable first-run state (secondary row intact)', async () => {- listPacksImpl = () =>- Promise.resolve({ ok: false, error: { kind: 'internal', message: 'boom' } });+ test('listPacks failure drops the pack line entirely, leaving the four cards', async () => {+ // Deferred so the test owns the settle moment. The row renders nothing for+ // BOTH the in-flight and the failed state, so an absence assertion is only+ // meaningful once the fetch has provably settled — otherwise it passes+ // because the fetch never finished, not because the component degraded.+ // `waitFor` cannot supply that proof: it resolves on the first non-throwing+ // check, so wrapping an already-true absence assertion in it is a no-op.+ let settle: (result: unknown) => void = () => {};+ const listPacks = vi.fn(+ () =>+ new Promise((resolve) => {+ settle = resolve;+ }),+ );+ listPacksImpl = listPacks;+ // The failure path logs before it clears the pack list, so the log is the+ // observable edge of the settle — and that it logs at all is the contract+ // (a silently swallowed fetch failure would be the defect).+ const errorSpy = vi.spyOn(console, 'error').mockImplementation(() => {});const bridge = createBridge([]);await renderNavigator(bridge);- // The packs-forward view still mounts; the demoted secondary row remains- // the user's path forward even when the pack fetch fails.- const firstRun = await screen.findByTestId('nav-first-run');- expect(firstRun).not.toBeNull();- expect(screen.getByTestId('nav-first-run-secondary')).not.toBeNull();- expect(screen.getByTestId('nav-first-run-open')).not.toBeNull();- expect(screen.getByTestId('nav-first-run-clone')).not.toBeNull();- expect(screen.getByTestId('nav-first-run-blank')).not.toBeNull();+ // In flight: the row holds its space empty rather than flashing a stub.+ await waitFor(() => expect(listPacks).toHaveBeenCalled());+ expect(screen.queryByTestId('nav-starter-packs')).toBeNull();++ settle({ ok: false, error: { kind: 'internal', message: 'boom' } });+ await waitFor(() =>+ expect(errorSpy).toHaveBeenCalledWith(+ '[NavigatorApp] listPacks returned error:',+ expect.anything(),+ ),+ );++ // Settled and degraded: still nothing, and the four cards are already a+ // complete path forward without it.+ expect(await screen.findByTestId('nav-create-new')).not.toBeNull();+ expect(screen.queryByTestId('nav-starter-packs')).toBeNull();+ expect(screen.queryByTestId('nav-pack-more')).toBeNull();+ errorSpy.mockRestore();+ });++ test('a thrown listPacks drops the pack line too, leaving the four cards', async () => {+ // Structurally distinct from the `ok: false` case above: a transport-level+ // throw lands in the catch, not the else. Both must degrade the same way,+ // and only a test per branch keeps that true through a refactor.+ const errorSpy = vi.spyOn(console, 'error').mockImplementation(() => {});+ listPacksImpl = () => Promise.reject(new Error('network down'));+ const bridge = createBridge([]);+ await renderNavigator(bridge);++ await waitFor(() =>+ expect(errorSpy).toHaveBeenCalledWith('[NavigatorApp] listPacks failed:', expect.any(Error)),+ );++ expect(await screen.findByTestId('nav-create-new')).not.toBeNull();+ expect(screen.queryByTestId('nav-starter-packs')).toBeNull();+ expect(screen.queryByTestId('nav-pack-more')).toBeNull();+ errorSpy.mockRestore();});- test('renders the returning-user three-card launcher unchanged when recents exist', async () => {+ test('a returning user gets the Recent list in place of the starter-pack line', async () => {const bridge = createBridge([{ path: '/projects/recent', name: 'Recent Project' }]);await renderNavigator(bridge);- // Three-card launcher present; packs-forward view absent.expect(await screen.findByTestId('nav-create-new')).not.toBeNull();expect(screen.getByTestId('nav-open')).not.toBeNull();expect(screen.getByTestId('nav-clone')).not.toBeNull();- expect(screen.queryByTestId('nav-first-run')).toBeNull();expect(await screen.findByTestId('nav-recent-list')).not.toBeNull();+ expect(screen.queryByTestId('nav-starter-packs')).toBeNull();});test('listRecent failure falls back to the three-card launcher, not the packs view', async () => {// A rejected listRecent leaves `recents` empty — but an empty-because-failed- // fetch must NOT read as "brand-new user" and show the first-run packs- // onboarding. It falls back to the returning-user three-card launcher.+ // fetch must NOT read as "brand-new user" and offer scaffolding to someone+ // who already has projects.const bridge = createBridge([]);bridge.project.listRecent = vi.fn(() => Promise.reject(new Error('boom')));await renderNavigator(bridge);@@ -300,8 +394,8 @@ describe('NavigatorApp first-run packs-forward launcher', () => {expect(await screen.findByTestId('nav-create-new')).not.toBeNull();expect(screen.getByTestId('nav-open')).not.toBeNull();expect(screen.getByTestId('nav-clone')).not.toBeNull();- // The first-run packs view must be absent.- expect(screen.queryByTestId('nav-first-run')).toBeNull();+ // The starter-pack line must be absent.+ expect(screen.queryByTestId('nav-starter-packs')).toBeNull();// The failure surfaces the error banner.expect(screen.getByTestId('nav-error-banner')).not.toBeNull();});diff --git a/packages/app/src/components/NavigatorApp.tsx b/packages/app/src/components/NavigatorApp.tsxindex 0036c6c42..91544fcea 100644--- a/packages/app/src/components/NavigatorApp.tsx+++ b/packages/app/src/components/NavigatorApp.tsx@@ -57,12 +57,20 @@ import { FeedbackFormDialog } from './FeedbackFormDialog';import { GithubIcon } from './icons/github';import { OkIcon } from './icons/ok';import { McpConsentDialog } from './McpConsentDialog';-import { PackCardGrid } from './PackCardGrid';+import { iconForPack, PackCardGrid } from './PackCardGrid';import { basenameOf } from './project-switcher-recents';import { ReportBugDialog } from './ReportBugDialog';import { RecentItemContextMenu } from './recent-remove-controls';import { Badge } from './ui/badge';import { Button } from './ui/button';+import {+ Dialog,+ DialogBody,+ DialogContent,+ DialogDescription,+ DialogHeader,+ DialogTitle,+} from './ui/dialog';// Cold-path launcher surface: renders nothing until main fires// `ok:share:received`. Lazy so its clone / auth-preflight / Q2-picker code@@ -98,10 +106,10 @@ export function NavigatorApp({ bridge }: { bridge: OkDesktopBridge }) {const [recents, setRecents] = useState<RecentProject[]>([]);const [recentBranches, setRecentBranches] = useState<Map<string, string | null>>(new Map());const [loading, setLoading] = useState(true);- // Whether the `listRecent()` fetch rejected. A fetch failure must fall back- // to the returning-user three-card launcher, NOT the first-run packs view —- // otherwise a transient error would show a returning user the first-run- // onboarding (`recents` stays `[]` on failure).+ // Whether the `listRecent()` fetch rejected. A fetch failure leaves `recents`+ // empty, which must NOT be read as "brand-new user" — otherwise a transient+ // error would offer first-run scaffolding to someone who already has+ // projects.const [recentsLoadFailed, setRecentsLoadFailed] = useState(false);const [error, setError] = useState<string | null>(null);// Non-null while a project open is in flight. `bridge.project.open` stays@@ -114,10 +122,10 @@ export function NavigatorApp({ bridge }: { bridge: OkDesktopBridge }) {const [createDialogOpen, setCreateDialogOpen] = useState(false);const [reportBugOpen, setReportBugOpen] = useState(false);const [feedbackOpen, setFeedbackOpen] = useState(false);- // Starter pack chosen on the packs-forward first-run grid, plus the pack- // list. Threaded into CreateProjectDialog so it can name the pack as+ // Starter pack chosen on the first-run pack line (pill or picker), plus the+ // pack list. Threaded into CreateProjectDialog so it can name the pack as// read-only context in its description and seed the fresh project with it;- // both clear on dialog close so the blank-create path (secondary row /+ // both clear on dialog close so the blank-create path (Create new project /// File → New project) never inherits a stale selection.const [createPackId, setCreatePackId] = useState<OkPackId | undefined>(undefined);const [createPacks, setCreatePacks] = useState<OkSeedPackInfo[] | undefined>(undefined);@@ -201,9 +209,9 @@ export function NavigatorApp({ bridge }: { bridge: OkDesktopBridge }) {console.error('[NavigatorApp] listRecent failed:', err);if (!cancelled) {setError(err instanceof Error ? err.message : t`Failed to load recent projects.`);- // Mark the fetch as failed so the launcher falls back to the- // three-card view rather than the first-run packs onboarding (an- // empty `recents` on failure would otherwise read as "brand-new user").+ // Mark the fetch as failed so the launcher keeps the starter-pack+ // line hidden (an empty `recents` on failure would otherwise read as+ // "brand-new user" and offer scaffolding to someone who has projects).setRecentsLoadFailed(true);}})@@ -398,21 +406,15 @@ export function NavigatorApp({ bridge }: { bridge: OkDesktopBridge }) {</div></header>- {/* First run (no recents, load settled) leads with the starter- packs; everyone else sees today's three-card launcher unchanged.- During loading we render neither so neither the packs grid nor the- three-card launcher flashes in before a returning user's recents- resolve. */}- {loading ? null : !recentsLoadFailed && recents.length === 0 ? (- <FirstRunPacksView- onPackSelect={onPackSelect}- onOpenFolder={onOpenFolder}- onOpenFile={onOpenFile}- onClone={onClone}- onCreate={onCreate}- />- ) : (- <section className="grid shrink-0 sm:grid-cols-2 gap-3">+ {/* The four doors are the primary actions for everyone — first-run+ and returning alike. Keeping one layout across both states means+ nothing a user learned on their first launch moves on their+ second, and there's no card-vs-packs swap to flash through while+ `listRecent` resolves. What varies is only what sits BELOW: the+ starter-pack line for a brand-new user, the Recent list for+ everyone else. */}+ <div className="shrink-0 space-y-6">+ <section className="grid sm:grid-cols-2 gap-3"><NavigatorCardtitle={t`Create new project`}description={t`Start a new OpenKnowledge project.`}@@ -442,7 +444,17 @@ export function NavigatorApp({ bridge }: { bridge: OkDesktopBridge }) {Icon={GithubIcon}/></section>- )}++ {/* Brand-new user (no recents, load settled): a subtle pack line+ takes the slot the Recent list occupies for everyone else. A+ failed `listRecent` deliberately does NOT qualify — an+ empty-because-failed fetch would otherwise read as "brand-new+ user" and offer scaffolding to someone who already has+ projects. */}+ {!loading && !recentsLoadFailed && recents.length === 0 ? (+ <StarterPackRow onPackSelect={onPackSelect} />+ ) : null}+ </div>{error !== null ? (<div@@ -622,7 +634,7 @@ function NavigatorCard({ title, description, onClick, dataTestId, Icon }: Naviga><div className="flex items-center gap-2">{Icon ? <Icon className="size-4 shrink-0 text-muted-foreground" /> : null}- <span className="font-medium text-gray-700 dark:text-foreground text-sm">{title}</span>+ <span className="font-medium text-foreground text-sm">{title}</span></div><span className="line-clamp-2 text-muted-foreground text-xs leading-snug">{description}</span></Button>@@ -630,31 +642,37 @@ function NavigatorCard({ title, description, onClick, dataTestId, Icon }: Naviga}/**- * Packs-forward first-run launcher. Leads with the same starter-pack grid the- * empty editor shows (6 visible + "Show more" for `okf`/`entity-vault`) so a- * brand-new user's first action produces a project that already has content in- * it. Below it, a demoted secondary row keeps the three original doors for- * people who arrive with their own content. Only mounted when there are no- * recent projects — returning users never see it.+ * Number of starter packs surfaced as pills before the overflow affordance.+ * Three keeps the line subordinate to the four primary cards above it; the+ * rest live one click away behind `+N more`.+ */+const PILL_PACK_COUNT = 3;++/**+ * Subtle starter-pack line shown to brand-new users in the slot the Recent+ * list occupies for everyone else. The first few packs render as pills in+ * registry order — fixed, never ranked by recency or popularity, so the row+ * doesn't rearrange itself between launches — and the remainder open in a+ * picker dialog.+ *+ * `+N more` opens the full grid rather than revealing the rest in place: pack+ * names alone ("Personal CRM", "Open Knowledge Format") don't tell a first-time+ * user what they scaffold, so the overflow needs the card grid's descriptions+ * to be a decidable choice.*- * Fetches the pack list here (not in `PackCardGrid`, which can self-fetch) so- * `onPackSelect` can hand the full list to the create dialog's Select without a- * second round-trip.+ * Fetches the pack list here (rather than letting `PackCardGrid` self-fetch) so+ * both the pills and `onPackSelect` share one round-trip. A failed or empty+ * fetch renders nothing at all — the four cards above are already a complete+ * path forward, and a broken-looking stub row would be worse than no row.*/-function FirstRunPacksView({+function StarterPackRow({onPackSelect,- onOpenFolder,- onOpenFile,- onClone,- onCreate,}: {onPackSelect: (packId: OkPackId, packs: OkSeedPackInfo[]) => void;- onOpenFolder: () => void;- onOpenFile: () => void;- onClone: () => void;- onCreate: () => void;}) {+ const { t } = useLingui();const [packs, setPacks] = useState<OkSeedPackInfo[] | null>(null);+ const [pickerOpen, setPickerOpen] = useState(false);useEffect(() => {let cancelled = false;@@ -662,8 +680,6 @@ function FirstRunPacksView({try {const result = await seedClient().listPacks();if (cancelled) return;- // `[]` short-circuits PackCardGrid's spinner into its labelled- // empty-state; the secondary row below still gives the user a path.if (result.ok) {setPacks(result.packs);} else {@@ -681,82 +697,77 @@ function FirstRunPacksView({};}, []);+ // Null (in flight) and empty (fetch failed / registry empty) both render+ // nothing. No skeleton: this line is secondary, and a placeholder that+ // resolves to nothing would shift the layout under the user's cursor.+ if (packs === null || packs.length === 0) return null;++ const pillPacks = packs.slice(0, PILL_PACK_COUNT);+ const overflowCount = packs.length - pillPacks.length;++ const selectPack = (packId: OkPackId) => {+ setPickerOpen(false);+ onPackSelect(packId, packs);+ };+return (- <section className="flex min-h-0 shrink flex-col gap-6" data-testid="nav-first-run">- <div className="flex shrink-0 flex-col gap-1">- <h2 className="text-xl font-light tracking-tighter text-balance">- <Trans>What do you want to build?</Trans>- </h2>- <p className="text-muted-foreground text-sm">- <Trans>- Pick a starter pack to scaffold your project with ready-made folders and templates.- </Trans>- </p>- </div>- {/* Grid scrolls inside its own container so the header + secondary row- stay anchored on the default 920×680 Navigator window. The 6 visible- packs fit without scrolling; expanding "Show more" can overflow, so- this stays a scroll container. The `-m-1 p-1` widens the overflow clip- box by the card focus-ring width, then pulls it back, so a focused- card's ring on the edge rows isn't shaved off. No `scroll-fade-mask`- here: its 1rem edge fade clipped that same ring. */}- <div className="-m-1 min-h-0 flex-1 overflow-y-auto subtle-scrollbar p-1">- <PackCardGrid- packs={packs}- onPackSelect={(packId) => onPackSelect(packId, packs ?? [])}- collapsedPackIds={['okf', 'entity-vault']}- />- </div>- <div- className="flex shrink-0 flex-wrap items-center gap-x-3 gap-y-1"- data-testid="nav-first-run-secondary"- >- <span className="text-muted-foreground text-sm">- <Trans>Have something else in mind?</Trans>- </span>- <div className="flex flex-wrap items-center gap-x-1 gap-y-1">- <Button- type="button"- variant="link-muted"- size="sm"- onClick={onOpenFolder}- data-testid="nav-first-run-open"- >- <FolderOpenIcon aria-hidden="true" className="size-3.5" />- <Trans>Open folder</Trans>- </Button>- <Button- type="button"- variant="link-muted"- size="sm"- onClick={onOpenFile}- data-testid="nav-first-run-open-file"- >- <FileText aria-hidden="true" className="size-3.5" />- <Trans>Open file</Trans>- </Button>- <Button- type="button"- variant="link-muted"- size="sm"- onClick={onClone}- data-testid="nav-first-run-clone"- >- <GithubIcon aria-hidden="true" className="size-3.5" />- <Trans>Clone from GitHub</Trans>- </Button>+ <section+ className="flex flex-wrap items-center gap-x-3 gap-y-2"+ data-testid="nav-starter-packs"+ >+ <span className="text-muted-foreground text-sm">+ <Trans>or use a starter pack</Trans>+ </span>+ <div className="flex flex-wrap items-center gap-2">+ {pillPacks.map((pack) => {+ const Icon = iconForPack(pack.id);+ return (+ <Button+ key={pack.id}+ type="button"+ variant="outline"+ size="sm"+ className="rounded-full"+ onClick={() => selectPack(pack.id)}+ data-testid={`nav-pack-pill-${pack.id}`}+ >+ <Icon className="size-3.5 text-muted-foreground" />+ {pack.name}+ </Button>+ );+ })}+ {overflowCount > 0 ? (<Buttontype="button"- variant="link-muted"+ variant="ghost"size="sm"- onClick={onCreate}- data-testid="nav-first-run-blank"+ className="rounded-full"+ onClick={() => setPickerOpen(true)}+ // Visible text is a bare count; the accessible name has to say what+ // the count refers to and what activating it does.+ aria-label={t`See all ${packs.length} starter packs`}+ data-testid="nav-pack-more">- <PlusIcon aria-hidden="true" className="size-3.5" />- <Trans>Blank project</Trans>+ <Trans>+{overflowCount} more</Trans></Button>- </div>+ ) : null}</div>++ <Dialog open={pickerOpen} onOpenChange={setPickerOpen}>+ <DialogContent className="sm:max-w-3xl" data-testid="nav-pack-picker">+ <DialogHeader>+ <DialogTitle>+ <Trans>Starter packs</Trans>+ </DialogTitle>+ <DialogDescription>+ <Trans>Each pack scaffolds your project with ready-made folders and templates.</Trans>+ </DialogDescription>+ </DialogHeader>+ <DialogBody>+ <PackCardGrid packs={packs} onPackSelect={selectPack} />+ </DialogBody>+ </DialogContent>+ </Dialog></section>);}diff --git a/packages/app/src/components/PackCardGrid.tsx b/packages/app/src/components/PackCardGrid.tsxindex 367784583..dda208576 100644--- a/packages/app/src/components/PackCardGrid.tsx+++ b/packages/app/src/components/PackCardGrid.tsx@@ -37,7 +37,12 @@ const PACK_ICONS: Record<OkPackId, React.ComponentType<{ className?: string }>>okf: FileCheck,};-function iconForPack(id: string): React.ComponentType<{ className?: string }> {+/**+ * Exported so surfaces that render packs outside this grid (the Navigator's+ * starter-pack pill row) show the same icon per pack. A pack whose id has no+ * entry in `PACK_ICONS` falls back to `Library` rather than rendering nothing.+ */+export function iconForPack(id: string): React.ComponentType<{ className?: string }> {return (PACK_ICONS as Record<string, React.ComponentType<{ className?: string }>>)[id] ?? Library;}diff --git a/packages/app/src/locales/en/messages.json b/packages/app/src/locales/en/messages.jsonindex f1519cd48..c2ba6cb34 100644--- a/packages/app/src/locales/en/messages.json+++ b/packages/app/src/locales/en/messages.json@@ -567,6 +567,7 @@{ "one": ["#", " file conflicted"], "other": ["#", " files conflicted"] }]],+ "B6Lac2": ["+", ["overflowCount"], " more"],"BAH4qX": ["Selected graph item"],"BBqGS9": ["Desktop"],"BD0XSC": ["Failed to load project templates"],@@ -598,6 +599,7 @@"Bx4EXG": ["Actions for ", ["label"]],"By-7Pn": ["Toggle a bullet list."],"BymzO4": ["Document outline"],+ "C-xgad": ["or use a starter pack"],"C0hoX6": ["Always included"],"C62P6b": ["Editor selection"],"C7XjNB": ["Global Skill"],@@ -1315,7 +1317,6 @@"Qj4RL5": ["Completed:"],"QlAG4m": ["Tell us more (optional)"],"QlxHAH": ["Showing results for \"", ["semanticResultsLabel"], "\""],- "QnjpOq": ["What do you want to build?"],"QqBQu1": ["Label <0>(visible link text)</0>"],"Qvls7J": ["Eng specs"],"Qw-7Ie": [@@ -1383,7 +1384,6 @@" has been moved, renamed, or deleted in your local copy, and that change hasn't synced yet."],"S33tz3": ["Not connected"],- "S34Vju": ["Have something else in mind?"],"S48xcO": ["pending"],"S60KvX": ["Delete this conversation?"],"S6l5dv": ["Could not start creating a new item"],@@ -1838,6 +1838,7 @@],"b4itZn": ["Working"],"b5aNbi": ["The ", ["targetNoun"], " could not be opened — try navigating to it manually."],+ "b6Fgpe": ["Each pack scaffolds your project with ready-made folders and templates."],"bBE5tC": ["Detected on this machine"],"bBcFK_": ["Open emoji picker for ", ["keyName"]],"bD8I7O": ["Complete"],@@ -1963,6 +1964,7 @@"e0NrBM": ["Project"],"e1Rn_k": ["Open containing folder"],"e1hptq": ["Embed a video with native player controls."],+ "e4FxjG": ["See all ", ["0"], " starter packs"],"e4GHWP": ["Pull"],"e4PbgC": ["Duplicate the file-tree item copied from the Files sidebar."],"e8L17t": ["A non-empty folder already exists at this path. Pick a different folder."],@@ -2056,9 +2058,6 @@" could not be opened — try navigating to it manually."],"gUlRQj": ["Orphans"],- "gYuDfu": [- "Pick a starter pack to scaffold your project with ready-made folders and templates."- ],"gYz2ep": ["Expires in ", ["timeLabel"]],"gZElfU": ["Fixing ", ["0"], " of ", ["1"], " files"],"gbHcbI": ["Failed to delete property"],@@ -2181,7 +2180,6 @@"iqIDv4": ["Sync status unavailable"],"iqugog": ["Initialize failed: ", ["errorDetail"]],"irFGwu": ["Template list"],- "ircigK": ["Blank project"],"irrm_E": ["Remove selection"],"isRobC": ["New"],"itxlnr": [@@ -2717,6 +2715,7 @@"tP5DDk": ["Apply link"],"tUvUfp": ["Use a folder you already have."],"t_YqKh": ["Remove"],+ "tcjTlU": ["Starter packs"],"teD0H9": ["Couldn't open a worktree for that branch."],"ten9en": ["Recent project"],"tfDRzk": ["Save"],diff --git a/packages/app/src/locales/en/messages.po b/packages/app/src/locales/en/messages.poindex 31dcb0bdd..0a0e39880 100644--- a/packages/app/src/locales/en/messages.po+++ b/packages/app/src/locales/en/messages.po@@ -621,6 +621,10 @@ msgstr "+ {overflow} more"msgid "+ Add {addChildName}"msgstr "+ Add {addChildName}"+#: src/components/NavigatorApp.tsx+msgid "+{overflowCount} more"+msgstr "+{overflowCount} more"+#: src/editor/extensions/JsxComponentView.tsxmsgid "<{componentName}> isn't a known component. Copy the source to use it elsewhere, or delete the block."msgstr "<{componentName}> isn't a known component. Copy the source to use it elsewhere, or delete the block."@@ -1330,10 +1334,6 @@ msgstr "Bird wiki"msgid "Blank note"msgstr "Blank note"-#: src/components/NavigatorApp.tsx-msgid "Blank project"-msgstr "Blank project"-#: src/editor/slash-command/component-items.tsxmsgid "Block math equation rendered with KaTeX from a LaTeX source string."msgstr "Block math equation rendered with KaTeX from a LaTeX source string."@@ -3212,6 +3212,10 @@ msgstr "e.g. Switching projects while a sync was running"msgid "e.g. The editor froze after I pasted a large table"msgstr "e.g. The editor froze after I pasted a large table"+#: src/components/NavigatorApp.tsx+msgid "Each pack scaffolds your project with ready-made folders and templates."+msgstr "Each pack scaffolds your project with ready-made folders and templates."+#: src/components/CreateProjectDialog.tsxmsgid "Each selected tool gets an OpenKnowledge MCP entry."msgstr "Each selected tool gets an OpenKnowledge MCP entry."@@ -4187,10 +4191,6 @@ msgstr "Hard break"msgid "Hard to use"msgstr "Hard to use"-#: src/components/NavigatorApp.tsx-msgid "Have something else in mind?"-msgstr "Have something else in mind?"-#: src/editor/slash-command/items.tsxmsgid "Heading 1"msgstr "Heading 1"@@ -6020,7 +6020,6 @@ msgid "Open emoji picker for {keyName}"msgstr "Open emoji picker for {keyName}"#: src/components/AssetPreview.tsx-#: src/components/NavigatorApp.tsx#: src/components/ProjectSwitcher.tsx#: src/components/ViewerStatusPane.tsx#: src/lib/keyboard-shortcuts.ts@@ -6032,7 +6031,6 @@ msgstr "Open file"msgid "Open file on disk"msgstr "Open file on disk"-#: src/components/NavigatorApp.tsx#: src/components/ProjectSwitcher.tsx#: src/lib/keyboard-shortcuts.tsmsgid "Open folder"@@ -6249,6 +6247,10 @@ msgstr "or paste a token"msgid "Or to use browser sign-in instead:"msgstr "Or to use browser sign-in instead:"+#: src/components/NavigatorApp.tsx+msgid "or use a starter pack"+msgstr "or use a starter pack"+#: src/components/EmptyEditorState.tsxmsgid "Or use a starter pack"msgstr "Or use a starter pack"@@ -6492,10 +6494,6 @@ msgstr "Pick a built-in IDE palette. The dark IDE themes override the light/darkmsgid "Pick a name"msgstr "Pick a name"-#: src/components/NavigatorApp.tsx-msgid "Pick a starter pack to scaffold your project with ready-made folders and templates."-msgstr "Pick a starter pack to scaffold your project with ready-made folders and templates."-#: src/components/ShareReceiveDialog.tsxmsgid "Pick the folder where you've cloned it."msgstr "Pick the folder where you've cloned it."@@ -7542,6 +7540,11 @@ msgstr "See <0>#design-docs</0> for the latest specs."msgid "See <0>Architecture</0> for the system overview."msgstr "See <0>Architecture</0> for the system overview."+#. placeholder {0}: packs.length+#: src/components/NavigatorApp.tsx+msgid "See all {0} starter packs"+msgstr "See all {0} starter packs"+#: src/components/InstallInClaudeDesktopDialog.tsxmsgid "See the full install guide"msgstr "See the full install guide"@@ -8198,6 +8201,10 @@ msgstr "Starter content"msgid "starter pack"msgstr "starter pack"+#: src/components/NavigatorApp.tsx+msgid "Starter packs"+msgstr "Starter packs"+#: src/components/acp/ThreadView.tsxmsgid "Starting {agentName}…"msgstr "Starting {agentName}…"@@ -9502,10 +9509,6 @@ msgstr "What agents match on to decide when to use the skill."msgid "What config sharing covers"msgstr "What config sharing covers"-#: src/components/NavigatorApp.tsx-msgid "What do you want to build?"-msgstr "What do you want to build?"-#: src/components/CreatedItemsList.tsxmsgid "What gets created"msgstr "What gets created"diff --git a/packages/app/src/locales/pseudo/messages.json b/packages/app/src/locales/pseudo/messages.jsonindex e77170eaf..d744f21cb 100644--- a/packages/app/src/locales/pseudo/messages.json+++ b/packages/app/src/locales/pseudo/messages.json@@ -567,6 +567,7 @@{ "one": ["#", " ƒĩĺē ćōńƒĺĩćţēď"], "other": ["#", " ƒĩĺēś ćōńƒĺĩćţēď"] }]],+ "B6Lac2": ["+", ["overflowCount"], " ḿōŕē"],"BAH4qX": ["Śēĺēćţēď ĝŕàƥĥ ĩţēḿ"],"BBqGS9": ["Ďēśķţōƥ"],"BD0XSC": ["Ƒàĩĺēď ţō ĺōàď ƥŕōĴēćţ ţēḿƥĺàţēś"],@@ -598,6 +599,7 @@"Bx4EXG": ["Àćţĩōńś ƒōŕ ", ["label"]],"By-7Pn": ["Ţōĝĝĺē à ƀũĺĺēţ ĺĩśţ."],"BymzO4": ["Ďōćũḿēńţ ōũţĺĩńē"],+ "C-xgad": ["ōŕ ũśē à śţàŕţēŕ ƥàćķ"],"C0hoX6": ["Àĺŵàŷś ĩńćĺũďēď"],"C62P6b": ["Ēďĩţōŕ śēĺēćţĩōń"],"C7XjNB": ["Ĝĺōƀàĺ Śķĩĺĺ"],@@ -1315,7 +1317,6 @@"Qj4RL5": ["Ćōḿƥĺēţēď:"],"QlAG4m": ["Ţēĺĺ ũś ḿōŕē (ōƥţĩōńàĺ)"],"QlxHAH": ["Śĥōŵĩńĝ ŕēśũĺţś ƒōŕ \"", ["semanticResultsLabel"], "\""],- "QnjpOq": ["Ŵĥàţ ďō ŷōũ ŵàńţ ţō ƀũĩĺď?"],"QqBQu1": ["Ĺàƀēĺ <0>(vĩśĩƀĺē ĺĩńķ ţēxţ)</0>"],"Qvls7J": ["Ēńĝ śƥēćś"],"Qw-7Ie": [@@ -1383,7 +1384,6 @@" ĥàś ƀēēń ḿōvēď, ŕēńàḿēď, ōŕ ďēĺēţēď ĩń ŷōũŕ ĺōćàĺ ćōƥŷ, àńď ţĥàţ ćĥàńĝē ĥàśń'ţ śŷńćēď ŷēţ."],"S33tz3": ["Ńōţ ćōńńēćţēď"],- "S34Vju": ["Ĥàvē śōḿēţĥĩńĝ ēĺśē ĩń ḿĩńď?"],"S48xcO": ["ƥēńďĩńĝ"],"S60KvX": ["Ďēĺēţē ţĥĩś ćōńvēŕśàţĩōń?"],"S6l5dv": ["Ćōũĺď ńōţ śţàŕţ ćŕēàţĩńĝ à ńēŵ ĩţēḿ"],@@ -1838,6 +1838,7 @@],"b4itZn": ["Ŵōŕķĩńĝ"],"b5aNbi": ["Ţĥē ", ["targetNoun"], " ćōũĺď ńōţ ƀē ōƥēńēď — ţŕŷ ńàvĩĝàţĩńĝ ţō ĩţ ḿàńũàĺĺŷ."],+ "b6Fgpe": ["Ēàćĥ ƥàćķ śćàƒƒōĺďś ŷōũŕ ƥŕōĴēćţ ŵĩţĥ ŕēàďŷ-ḿàďē ƒōĺďēŕś àńď ţēḿƥĺàţēś."],"bBE5tC": ["Ďēţēćţēď ōń ţĥĩś ḿàćĥĩńē"],"bBcFK_": ["Ōƥēń ēḿōĴĩ ƥĩćķēŕ ƒōŕ ", ["keyName"]],"bD8I7O": ["Ćōḿƥĺēţē"],@@ -1963,6 +1964,7 @@"e0NrBM": ["ƤŕōĴēćţ"],"e1Rn_k": ["Ōƥēń ćōńţàĩńĩńĝ ƒōĺďēŕ"],"e1hptq": ["Ēḿƀēď à vĩďēō ŵĩţĥ ńàţĩvē ƥĺàŷēŕ ćōńţŕōĺś."],+ "e4FxjG": ["Śēē àĺĺ ", ["0"], " śţàŕţēŕ ƥàćķś"],"e4GHWP": ["Ƥũĺĺ"],"e4PbgC": ["Ďũƥĺĩćàţē ţĥē ƒĩĺē-ţŕēē ĩţēḿ ćōƥĩēď ƒŕōḿ ţĥē Ƒĩĺēś śĩďēƀàŕ."],"e8L17t": ["À ńōń-ēḿƥţŷ ƒōĺďēŕ àĺŕēàďŷ ēxĩśţś àţ ţĥĩś ƥàţĥ. Ƥĩćķ à ďĩƒƒēŕēńţ ƒōĺďēŕ."],@@ -2056,9 +2058,6 @@" ćōũĺď ńōţ ƀē ōƥēńēď — ţŕŷ ńàvĩĝàţĩńĝ ţō ĩţ ḿàńũàĺĺŷ."],"gUlRQj": ["Ōŕƥĥàńś"],- "gYuDfu": [- "Ƥĩćķ à śţàŕţēŕ ƥàćķ ţō śćàƒƒōĺď ŷōũŕ ƥŕōĴēćţ ŵĩţĥ ŕēàďŷ-ḿàďē ƒōĺďēŕś àńď ţēḿƥĺàţēś."- ],"gYz2ep": ["Ēxƥĩŕēś ĩń ", ["timeLabel"]],"gZElfU": ["Ƒĩxĩńĝ ", ["0"], " ōƒ ", ["1"], " ƒĩĺēś"],"gbHcbI": ["Ƒàĩĺēď ţō ďēĺēţē ƥŕōƥēŕţŷ"],@@ -2181,7 +2180,6 @@"iqIDv4": ["Śŷńć śţàţũś ũńàvàĩĺàƀĺē"],"iqugog": ["Ĩńĩţĩàĺĩźē ƒàĩĺēď: ", ["errorDetail"]],"irFGwu": ["Ţēḿƥĺàţē ĺĩśţ"],- "ircigK": ["ßĺàńķ ƥŕōĴēćţ"],"irrm_E": ["Ŕēḿōvē śēĺēćţĩōń"],"isRobC": ["Ńēŵ"],"itxlnr": [@@ -2717,6 +2715,7 @@"tP5DDk": ["Àƥƥĺŷ ĺĩńķ"],"tUvUfp": ["Ũśē à ƒōĺďēŕ ŷōũ àĺŕēàďŷ ĥàvē."],"t_YqKh": ["Ŕēḿōvē"],+ "tcjTlU": ["Śţàŕţēŕ ƥàćķś"],"teD0H9": ["Ćōũĺďń'ţ ōƥēń à ŵōŕķţŕēē ƒōŕ ţĥàţ ƀŕàńćĥ."],"ten9en": ["Ŕēćēńţ ƥŕōĴēćţ"],"tfDRzk": ["Śàvē"],diff --git a/packages/app/src/locales/pseudo/messages.po b/packages/app/src/locales/pseudo/messages.poindex cbfe7d14c..7144c5c22 100644--- a/packages/app/src/locales/pseudo/messages.po+++ b/packages/app/src/locales/pseudo/messages.po@@ -617,6 +617,10 @@ msgstr ""msgid "+ Add {addChildName}"msgstr ""+#: src/components/NavigatorApp.tsx+msgid "+{overflowCount} more"+msgstr ""+#: src/editor/extensions/JsxComponentView.tsxmsgid "<{componentName}> isn't a known component. Copy the source to use it elsewhere, or delete the block."msgstr ""@@ -1326,10 +1330,6 @@ msgstr ""msgid "Blank note"msgstr ""-#: src/components/NavigatorApp.tsx-msgid "Blank project"-msgstr ""-#: src/editor/slash-command/component-items.tsxmsgid "Block math equation rendered with KaTeX from a LaTeX source string."msgstr ""@@ -3208,6 +3208,10 @@ msgstr ""msgid "e.g. The editor froze after I pasted a large table"msgstr ""+#: src/components/NavigatorApp.tsx+msgid "Each pack scaffolds your project with ready-made folders and templates."+msgstr ""+#: src/components/CreateProjectDialog.tsxmsgid "Each selected tool gets an OpenKnowledge MCP entry."msgstr ""@@ -4183,10 +4187,6 @@ msgstr ""msgid "Hard to use"msgstr ""-#: src/components/NavigatorApp.tsx-msgid "Have something else in mind?"-msgstr ""-#: src/editor/slash-command/items.tsxmsgid "Heading 1"msgstr ""@@ -6016,7 +6016,6 @@ msgid "Open emoji picker for {keyName}"msgstr ""#: src/components/AssetPreview.tsx-#: src/components/NavigatorApp.tsx#: src/components/ProjectSwitcher.tsx#: src/components/ViewerStatusPane.tsx#: src/lib/keyboard-shortcuts.ts@@ -6028,7 +6027,6 @@ msgstr ""msgid "Open file on disk"msgstr ""-#: src/components/NavigatorApp.tsx#: src/components/ProjectSwitcher.tsx#: src/lib/keyboard-shortcuts.tsmsgid "Open folder"@@ -6245,6 +6243,10 @@ msgstr ""msgid "Or to use browser sign-in instead:"msgstr ""+#: src/components/NavigatorApp.tsx+msgid "or use a starter pack"+msgstr ""+#: src/components/EmptyEditorState.tsxmsgid "Or use a starter pack"msgstr ""@@ -6488,10 +6490,6 @@ msgstr ""msgid "Pick a name"msgstr ""-#: src/components/NavigatorApp.tsx-msgid "Pick a starter pack to scaffold your project with ready-made folders and templates."-msgstr ""-#: src/components/ShareReceiveDialog.tsxmsgid "Pick the folder where you've cloned it."msgstr ""@@ -7538,6 +7536,11 @@ msgstr ""msgid "See <0>Architecture</0> for the system overview."msgstr ""+#. placeholder {0}: packs.length+#: src/components/NavigatorApp.tsx+msgid "See all {0} starter packs"+msgstr ""+#: src/components/InstallInClaudeDesktopDialog.tsxmsgid "See the full install guide"msgstr ""@@ -8194,6 +8197,10 @@ msgstr ""msgid "starter pack"msgstr ""+#: src/components/NavigatorApp.tsx+msgid "Starter packs"+msgstr ""+#: src/components/acp/ThreadView.tsxmsgid "Starting {agentName}…"msgstr ""@@ -9498,10 +9505,6 @@ msgstr ""msgid "What config sharing covers"msgstr ""-#: src/components/NavigatorApp.tsx-msgid "What do you want to build?"-msgstr ""-#: src/components/CreatedItemsList.tsxmsgid "What gets created"msgstr ""diff --git a/packages/desktop/tests/smoke/_helpers/navigator-actions.ts b/packages/desktop/tests/smoke/_helpers/navigator-actions.tsindex 54d0be416..505f36fe3 100644--- a/packages/desktop/tests/smoke/_helpers/navigator-actions.ts+++ b/packages/desktop/tests/smoke/_helpers/navigator-actions.ts@@ -1,25 +1,17 @@import type { Page } from '@playwright/test';/**- * Navigator entry-point clicks that work in both launcher states: a fresh- * profile (no recent projects) renders the packs-forward first-run launcher,- * whose secondary-row buttons wire to the same handlers as the returning-user- * three-card grid (nav-first-run-blank → onCreate, nav-first-run-open →- * onOpenFolder; see NavigatorApp.tsx). Smoke tests launch with a fresh tmp- * home, so they land on the first-run view; specs that reopen the Navigator- * after a project exists get the three-card grid. The two views are mutually- * exclusive, so the .or() locator resolves to exactly one element.+ * Navigator entry-point clicks. The launcher renders the same four cards+ * whether or not the profile has recent projects, so these locators resolve in+ * every launcher state — a fresh tmp home (what smoke tests launch with) and a+ * profile that already has projects alike. Only what sits below the cards+ * varies: the starter-pack line for a brand-new user, the Recent list+ * otherwise (see NavigatorApp.tsx).*/export async function clickNavCreateNew(navigator: Page): Promise<void> {- await navigator- .locator('[data-testid="nav-create-new"]')- .or(navigator.locator('[data-testid="nav-first-run-blank"]'))- .click();+ await navigator.locator('[data-testid="nav-create-new"]').click();}export async function clickNavOpen(navigator: Page): Promise<void> {- await navigator- .locator('[data-testid="nav-open"]')- .or(navigator.locator('[data-testid="nav-first-run-open"]'))- .click();+ await navigator.locator('[data-testid="nav-open"]').click();}diff --git a/packages/desktop/tests/smoke/create-new-project.e2e.ts b/packages/desktop/tests/smoke/create-new-project.e2e.tsindex ddf969e9d..5daf69a59 100644--- a/packages/desktop/tests/smoke/create-new-project.e2e.ts+++ b/packages/desktop/tests/smoke/create-new-project.e2e.ts@@ -3,11 +3,10 @@* Navigator → blank-create affordance → in-app CreateProjectDialog flow and* asserts the three end-to-end cascade UX states.*- * Every test seeds zero recents (`seedTmpHome`), so the Navigator opens on the- * first-run packs-forward view — the blank-create affordance there is- * `nav-first-run-blank`, NOT the returning-user `nav-create-new` card (which- * renders only once recents exist). Both fire the same `onCreate` → the same- * dialog. The cascade states asserted:+ * Every test seeds zero recents (`seedTmpHome`), which changes only what sits+ * below the launcher cards (the starter-pack line rather than the Recent+ * list). `nav-create-new` is the blank-create door in every launcher state.+ * The cascade states asserted:** 1. Free path (happy submit): no banner, Create enabled. After submit,* .ok/config.yml lands at parent/<name> and the editor window opens