feat(app): tap an idea on the welcome screen

Four crew templates show as cards under the first-run checks; tapping one
opens the new-crew dialog already on that template.

Author: httpsphl

app/src/features/crews/CrewDialog.tsx

@@ -16,16 +16,30 @@ import { WorkFolderField } from "./WorkFolderField";
 
 const MODELS: BotModel[] = ["default", "fable", "opus", "sonnet", "haiku"];
 
-/** Creates a crew with its chief, or renames `crew`. */
-export function CrewDialog({ crew, onClose }: { crew?: Crew; onClose(): void }) {
+/**
+ * Creates a crew with its chief, or renames `crew`. `start` opens a new crew
+ * already on that template, as when the owner taps an idea on the welcome
+ * screen.
+ */
+export function CrewDialog({
+  crew,
+  start,
+  onClose,
+}: {
+  crew?: Crew;
+  start?: CrewTemplate | undefined;
+  onClose(): void;
+}) {
   const t = useT();
   const api = useApi();
   const putCrew = useApp((state) => state.putCrew);
   const selectCrew = useApp((state) => state.selectCrew);
-  const [name, setName] = useState(crew?.name ?? "");
+  const [name, setName] = useState(
+    crew?.name ?? (start ? t.crewTemplates.items[start.id].name : ""),
+  );
   const [color, setColor] = useState<string | null>(crew?.color ?? null);
   const [folder, setFolder] = useState<string | null>(null);
-  const [goal, setGoal] = useState("");
+  const [goal, setGoal] = useState(start ? t.crewTemplates.items[start.id].goal : "");
   const [chiefModel, setChiefModel] = useState<BotModel>("default");
   const selectBot = useApp((state) => state.selectBot);
   const putBot = useApp((state) => state.putBot);
@@ -34,7 +48,7 @@ export function CrewDialog({ crew, onClose }: { crew?: Crew; onClose(): void })
   // A new crew starts from a template (spec 29.1) when the catalog loaded:
   // `undefined` is the list of templates, `null` an empty crew.
   const { roles, failed: catalogFailed } = useCatalog(!crew);
-  const [template, setTemplate] = useState<CrewTemplate | null | undefined>(undefined);
+  const [template, setTemplate] = useState<CrewTemplate | null | undefined>(start);
   const loading = !crew && roles === null && !catalogFailed;
   const choosing = !crew && template === undefined && roles !== null;
 

app/src/features/onboarding/Welcome.tsx

@@ -8,14 +8,21 @@ import { Button } from "../../ui/Button";
 import { useDaemonSettings } from "../account/useDaemonSettings";
 import { BotAvatar } from "../bots/BotAvatar";
 import { CrewDialog } from "../crews/CrewDialog";
+import { CREW_TEMPLATES, type CrewTemplate } from "../crews/crewTemplates";
 import { ClaudeCodeHelp } from "./ClaudeCodeHelp";
 import { SignInButton } from "./SignIn";
 
+/** Templates shown as ideas on the first screen. */
+const IDEAS = 4;
+
 /** First run: what is ready, what is not, and the first crew. */
 export function Welcome() {
-  const w = useT().onboarding.welcome;
+  const t = useT();
+  const w = t.onboarding.welcome;
+  const ideas = t.crewTemplates.items;
   const system = useApp((state) => state.system);
   const [creating, setCreating] = useState(false);
+  const [idea, setIdea] = useState<CrewTemplate | undefined>(undefined);
   const whenClosed = usePref(prefs.whenClosed);
   const { settings } = useDaemonSettings();
   const running =
@@ -82,11 +89,42 @@ export function Welcome() {
           <p className="font-semibold">{w.askFirstTitle}</p>
           <p className="mt-1 text-ink-soft">{w.askFirstBody}</p>
         </div>
-        <Button className="mt-6" variant="primary" icon={Plus} onClick={() => setCreating(true)}>
+        <section aria-label={w.ideasTitle} className="mt-6">
+          <h2 className="font-semibold text-sm">{w.ideasTitle}</h2>
+          <ul className="m-0 mt-2 grid list-none grid-cols-1 gap-2 p-0 sm:grid-cols-2">
+            {CREW_TEMPLATES.slice(0, IDEAS).map((template) => {
+              const item = ideas[template.id];
+              return (
+                <li key={template.id} className="flex">
+                  <button
+                    type="button"
+                    onClick={() => {
+                      setIdea(template);
+                      setCreating(true);
+                    }}
+                    className="flex w-full flex-col gap-0.5 rounded-xl border border-line bg-panel p-3 text-left transition-colors hover:border-line-strong hover:bg-sunken"
+                  >
+                    <span className="font-semibold text-sm">{item.name}</span>
+                    <span className="line-clamp-2 text-ink-soft text-sm">{item.summary}</span>
+                  </button>
+                </li>
+              );
+            })}
+          </ul>
+        </section>
+        <Button
+          className="mt-4"
+          variant="primary"
+          icon={Plus}
+          onClick={() => {
+            setIdea(undefined);
+            setCreating(true);
+          }}
+        >
           {w.createCrew}
         </Button>
       </div>
-      {creating && <CrewDialog onClose={() => setCreating(false)} />}
+      {creating && <CrewDialog start={idea} onClose={() => setCreating(false)} />}
     </main>
   );
 }

app/src/features/onboarding/ideas.test.tsx

@@ -0,0 +1,25 @@
+import { cleanup, fireEvent, screen, within } from "@testing-library/react";
+import { afterEach, describe, expect, test } from "vitest";
+import { FakeBotloft } from "../../lib/fake";
+import { renderApp } from "../../test/app";
+
+afterEach(cleanup);
+
+describe("ideas on the welcome screen", () => {
+  test("tapping an idea opens a new crew already set up from that template", async () => {
+    renderApp(new FakeBotloft());
+    const ideas = await screen.findByRole("region", { name: "Or tap an idea" });
+    expect(within(ideas).getAllByRole("listitem")).toHaveLength(4);
+
+    fireEvent.click(within(ideas).getByRole("button", { name: /Software team/ }));
+    const dialog = await screen.findByRole("dialog", { name: "New crew" });
+    expect((within(dialog).getByLabelText("Name") as HTMLInputElement).value).toBe("Software team");
+    expect(within(dialog).getByText(/This team adds/)).toBeDefined();
+  });
+
+  test("the plain button still starts at the list of templates", async () => {
+    renderApp(new FakeBotloft());
+    fireEvent.click(await screen.findByRole("button", { name: "Create your first crew" }));
+    expect(await screen.findByRole("dialog", { name: "Start from a template" })).toBeDefined();
+  });
+});

app/src/i18n/en/onboarding.ts

@@ -65,6 +65,7 @@ export const onboarding = {
     askFirstTitle: "Bots ask before they change things",
     askFirstBody:
       "When a bot wants to run a command or edit a file, it asks in its chat and waits for you to allow or deny it.",
+    ideasTitle: "Or tap an idea",
     createCrew: "Create your first crew",
   },
   claudeCode: {

app/src/i18n/es/onboarding.ts

@@ -65,6 +65,7 @@ export const onboarding: Messages["onboarding"] = {
     askFirstTitle: "Los bots preguntan antes de cambiar cosas",
     askFirstBody:
       "Cuando un bot quiere ejecutar un comando o editar un archivo, lo pregunta en su chat y espera a que lo permitas o lo deniegues.",
+    ideasTitle: "O toca una idea",
     createCrew: "Crear tu primer equipo",
   },
   claudeCode: {

app/src/i18n/pt-BR/onboarding.ts

@@ -64,6 +64,7 @@ export const onboarding: Messages["onboarding"] = {
     askFirstTitle: "Os bots perguntam antes de mudar as coisas",
     askFirstBody:
       "Quando um bot quer rodar um comando ou editar um arquivo, ele pergunta no chat e espera você permitir ou negar.",
+    ideasTitle: "Ou toque em uma ideia",
     createCrew: "Criar sua primeira equipe",
   },
   claudeCode: {