Skip to content

Beautiful, AI-native markdown IDE and LLM wiki

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.md
new file mode 100644
index 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.mdx
index 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.tsx
index 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.tsx
index 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">
<NavigatorCard
title={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 ? (
<Button
type="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.tsx
index 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.json
index 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.po
index 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.tsx
msgid "<{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.tsx
msgid "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.tsx
msgid "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.tsx
msgid "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.ts
msgid "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.tsx
msgid "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/dark
msgid "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.tsx
msgid "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.tsx
msgid "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.tsx
msgid "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.tsx
msgid "What gets created"
msgstr "What gets created"
diff --git a/packages/app/src/locales/pseudo/messages.json b/packages/app/src/locales/pseudo/messages.json
index 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.po
index 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.tsx
msgid "<{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.tsx
msgid "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.tsx
msgid "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.tsx
msgid "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.ts
msgid "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.tsx
msgid "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.tsx
msgid "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.tsx
msgid "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.tsx
msgid "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.tsx
msgid "What gets created"
msgstr ""
diff --git a/packages/desktop/tests/smoke/_helpers/navigator-actions.ts b/packages/desktop/tests/smoke/_helpers/navigator-actions.ts
index 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.ts
index 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