@graph8/sdk 0.370.0 → 0.374.0

package/stacks/hubspot/pages/contacts.tsx.tmpl

@@ -2,110 +2,50 @@
 
 // Generated by `graph8-sdk create {{stackId}}`. The {{block}} block's {{component}} (source in {{blockDir}}), with the
 // other blocks of this app plugged into its slots. Edit freely: this file is yours.
-import { useState } from "react";
-import Link from "next/link";
-import { Button, Sheet, SheetContent, SheetDescription, SheetHeader, SheetTitle, Skeleton } from "@graph8/sdk/ui";
-import { Handshake, ListPlus } from "lucide-react";
-import { ApiError } from "@/components/g8/_foundation/api-error";
-import { EmptyState } from "@/components/g8/_foundation/empty-state";
-import { useG8Query } from "@/components/g8/_foundation/hooks/use-g8-query";
-import { g8Get } from "@/components/g8/_foundation/lib/g8-client";
+import { RecordMeetingsTab } from "@/components/g8/appointments/record-meetings-tab";
+import { MemberPicker } from "@/components/g8/pickers/member-picker";
 import { ContactsScreen } from "@/components/g8/crm/contacts-screen";
-import { dataOf, formatMoney } from "@/components/g8/deals/lib/deals-types";
-import { EnrollDialog } from "@/components/g8/sequencer/enroll-dialog";
-import { listOf, statusGroup, type SequenceRow } from "@/components/g8/sequencer/lib/sequencer-utils";
-
-/** Every active sequence, paging through the whole list (the API answers one page at a time). */
-async function activeSequences(signal: AbortSignal): Promise<SequenceRow[]> {
-  const out: SequenceRow[] = [];
-  for (let page = 1; page <= 50; page++) {
-    const env = await g8Get("/sequences", { page, limit: 100 }, { signal });
-    const rows = listOf<SequenceRow>(env);
-    out.push(...rows.filter((s) => statusGroup(s.status) === "live"));
-    const more = (env as { pagination?: { has_next?: boolean } }).pagination?.has_next;
-    if (!more || rows.length === 0) break;
-  }
-  return out;
-}
-
-/** Pick a sequence, then enroll the contacts in it. The enroll dialog shows the sending preflight before anything is sent. */
-function AddToSequence({ contactIds, onEnrolled, variant = "outline" }: { contactIds: number[]; onEnrolled?: () => void; variant?: "outline" | "default" }) {
-  const [step, setStep] = useState<"closed" | "pick" | "enroll">("closed");
-  const [sequenceId, setSequenceId] = useState("");
-  const sequences = useG8Query(activeSequences, [], { enabled: step === "pick" });
-  const chosen = (sequences.data ?? []).find((s) => s.id === sequenceId);
-  return (
-    <>
-      <Button size="sm" variant={variant} disabled={contactIds.length === 0} onClick={() => { setSequenceId(""); setStep("pick"); }}>
-        <ListPlus className="mr-1 size-4" aria-hidden />
-        Add to sequence
-      </Button>
-      <Sheet open={step === "pick"} onOpenChange={(o) => { if (!o) setStep("closed"); }}>
-        <SheetContent className="w-full sm:max-w-md">
-          <SheetHeader>
-            <SheetTitle>Add to sequence</SheetTitle>
-            <SheetDescription>{contactIds.length === 1 ? "1 contact" : `${contactIds.length} contacts`} will be enrolled in the sequence you pick.</SheetDescription>
-          </SheetHeader>
-          <div className="space-y-3 p-4">
-            {sequences.error ? <ApiError error={sequences.error} title="Could not load sequences" onRetry={() => void sequences.refetch()} /> : null}
-            {sequences.loading && !sequences.data ? <Skeleton className="h-9 w-full" aria-label="Loading sequences" /> : null}
-            {sequences.data && sequences.data.length === 0 ? <EmptyState compact title="No active sequences" description="Launch a sequence on the Sequences page first." /> : null}
-            {sequences.data && sequences.data.length > 0 ? (
-              <>
-                <label htmlFor="enroll-sequence" className="text-sm font-medium">Sequence</label>
-                <select id="enroll-sequence" className="h-9 w-full rounded-md border bg-background px-2 text-sm" value={sequenceId} onChange={(e) => setSequenceId(e.target.value)}>
-                  <option value="">Choose a sequence</option>
-                  {sequences.data.map((s) => <option key={s.id} value={s.id}>{s.name || s.id}</option>)}
-                </select>
-                <Button disabled={!sequenceId} onClick={() => setStep("enroll")}>Continue</Button>
-              </>
-            ) : null}
-          </div>
-        </SheetContent>
-      </Sheet>
-      {step === "enroll" && chosen ? (
-        <EnrollDialog open sequenceId={chosen.id} sequenceName={chosen.name ?? undefined} contactIds={contactIds} onClose={() => setStep("closed")} onEnrolled={() => { setStep("closed"); onEnrolled?.(); }} />
-      ) : null}
-    </>
-  );
-}
-
-/** One row of GET /contacts/{id}/deals and GET /companies/{id}/deals (the API's ContactDealResponse). */
-interface LinkedDeal { deal_id?: string | null; name?: string | null; stage?: string | null; value?: number | null; currency?: string | null; role?: string | null }
-
-/** The deals linked to one contact or company, each opening in the Deals page. */
-function LinkedDeals({ kind, id }: { kind: "contacts" | "companies"; id: number }) {
-  const q = useG8Query(async (signal) => {
-    const inner = dataOf<{ items?: LinkedDeal[] } | LinkedDeal[]>(await g8Get(`/${kind}/${id}/deals`, undefined, { signal }));
-    return (Array.isArray(inner) ? inner : (inner.items ?? [])).filter((d) => d.deal_id);
-  }, [kind, id]);
-  if (q.error) return <ApiError error={q.error} title="Could not load deals" onRetry={() => void q.refetch()} />;
-  if (!q.data) return <Skeleton className="h-24 w-full" aria-label="Loading deals" />;
-  if (q.data.length === 0) return <EmptyState compact icon={<Handshake className="size-8" />} title="No deals yet" description="Deals linked to this record show up here." />;
-  return (
-    <ul className="divide-y rounded-md border" aria-label="Deals">
-      {q.data.map((d) => (
-        <li key={d.deal_id}>
-          <Link href={`/deals?id=${encodeURIComponent(d.deal_id as string)}`} className="flex items-center justify-between gap-3 p-3 text-sm hover:bg-muted">
-            <span className="min-w-0 truncate font-medium">{d.name || "Untitled deal"}</span>
-            <span className="shrink-0 text-xs text-muted-foreground">{[d.stage, d.value != null ? formatMoney(d.value, d.currency) : null].filter(Boolean).join(" · ")}</span>
-          </Link>
-        </li>
-      ))}
-    </ul>
-  );
-}
+import { RecordEngagementTab } from "@/components/g8/crm/record-engagement-tab";
+import { CreateDealButton } from "@/components/g8/deals/create-deal-button";
+import { RecordDealsTab } from "@/components/g8/deals/record-deals-tab";
+import { RecordDocumentsTab } from "@/components/g8/documents/record-documents-tab";
+import { RecordConversationsTab } from "@/components/g8/inbox/record-conversations-tab";
+import { AddToListButton } from "@/components/g8/lists/add-to-list-button";
+import { RecordListsTab } from "@/components/g8/lists/record-lists-tab";
+import { RecordQuotesTab } from "@/components/g8/quotes/record-quotes-tab";
+import { AddToSequenceButton } from "@/components/g8/sequencer/add-to-sequence-button";
+import { RecordSequencesTab } from "@/components/g8/sequencer/record-sequences-tab";
+import { useRouter } from "next/navigation";
 
 export default function Page() {
+  const router = useRouter();
   return (
     <ContactsScreen
-      renderBulkActions={({ ids, clear }) => <AddToSequence contactIds={ids} onEnrolled={clear} />}
+      renderOwnerPicker={(picker) => <MemberPicker label="New owner" {...picker} />}
+      onOpenCompany={(id) => router.push(`/companies?id=${id}`)}
+      renderBulkActions={({ ids, clear }) => (
+        <>
+          <AddToSequenceButton contactIds={ids} onEnrolled={clear} />
+          <AddToListButton contactIds={ids} onAdded={clear} />
+        </>
+      )}
       renderDetailActions={(c) => (
         <>
-          <AddToSequence contactIds={[c.id]} />
+          <AddToSequenceButton contactIds={[c.id]} />
+          <AddToListButton contactIds={[c.id]} />
+          <CreateDealButton contactId={c.id} onCreated={(id) => router.push(`/deals?id=${encodeURIComponent(id)}`)} />
         </>
       )}
-      extraDetailTabs={[{ id: "deals", label: "Deals", render: (c) => <LinkedDeals kind="contacts" id={c.id} /> }]}
+      extraDetailTabs={[
+        { id: "lists", label: "Lists", render: (c) => <RecordListsTab contactId={c.id} onOpenList={(id) => router.push(`/lists?id=${id}`)} /> },
+        { id: "sequences", label: "Sequences", render: (c) => <RecordSequencesTab contactId={c.id} onOpenSequence={(id) => router.push(`/sequences?id=${encodeURIComponent(id)}`)} /> },
+        { id: "meetings", label: "Meetings", render: (c) => <RecordMeetingsTab contactId={c.id} onOpenMeeting={(sel) => router.push(`/meetings?sel=${encodeURIComponent(sel)}`)} /> },
+        { id: "quotes", label: "Quotes", render: (c) => <RecordQuotesTab kind="contacts" id={c.id} onOpenQuote={(id) => router.push(`/quotes?id=${encodeURIComponent(id)}`)} /> },
+        { id: "deals", label: "Deals", render: (c) => <RecordDealsTab kind="contacts" id={c.id} onOpenDeal={(id) => router.push(`/deals?id=${encodeURIComponent(id)}`)} /> },
+        { id: "conversations", label: "Conversations", render: (c) => <RecordConversationsTab email={c.work_email} alsoEmails={[c.personal_emails]} onOpenThread={(sel) => router.push(`/inbox?id=${encodeURIComponent(sel)}`)} /> },
+        { id: "documents", label: "Documents", render: (c) => <RecordDocumentsTab contactId={c.id} onOpenDocuments={(href) => router.push(href)} /> },
+        { id: "engagement", label: "Engagement", render: (c) => <RecordEngagementTab kind="contacts" id={c.id} /> },
+      ]}
     />
   );
 }

package/stacks/hubspot/pages/deals.tsx.tmpl

@@ -4,8 +4,21 @@
 // other blocks of this app plugged into its slots. Edit freely: this file is yours.
 import { useRouter } from "next/navigation";
 import { DealsScreen } from "@/components/g8/deals/deals-screen";
+import { RecordDocumentsTab } from "@/components/g8/documents/record-documents-tab";
+import { CreateQuoteFromDeal } from "@/components/g8/quotes/create-quote-from-deal";
 
+/** A deal opens its quotes, its contacts and (from a contact) their company. */
 export default function Page() {
   const router = useRouter();
-  return <DealsScreen onOpenQuote={(quoteId) => router.push(`/quotes?id=${encodeURIComponent(quoteId)}`)} />;
+  return (
+    <DealsScreen
+      onOpenQuote={(quoteId) => router.push(`/quotes?id=${encodeURIComponent(quoteId)}`)}
+      renderQuoteActions={(deal) => <CreateQuoteFromDeal dealId={deal.id} />}
+      onOpenContact={(id) => router.push(`/contacts?id=${id}`)}
+      onOpenCompany={(id) => router.push(`/companies?id=${id}`)}
+      extraDetailTabs={[
+        { id: "documents", label: "Documents", render: (d) => <RecordDocumentsTab contactId={d.primary_contact?.id} scope="account" onOpenDocuments={(href) => router.push(href)} /> },
+      ]}
+    />
+  );
 }

package/stacks/hubspot/pages/forms.tsx.tmpl

@@ -0,0 +1,36 @@
+"use client";
+
+// Generated by `graph8-sdk create {{stackId}}`. The {{block}} block's {{component}} (source in {{blockDir}}), with the
+// other blocks of this app plugged into its slots. Edit freely: this file is yours.
+import { useRouter } from "next/navigation";
+import { ContactLookupLink, splitName } from "@/components/g8/crm/contact-lookup-link";
+import { FormsScreen } from "@/components/g8/forms/forms-screen";
+
+/** The first email-looking value a person typed into the form. Identifying fields are redacted for some keys: then there is no email and no button. */
+function emailOf(data: Record<string, unknown> | undefined): string | null {
+  for (const [key, value] of Object.entries(data ?? {})) {
+    if (/e-?mail/i.test(key) && typeof value === "string" && value.includes("@") && !value.includes("*")) return value.trim();
+  }
+  return null;
+}
+
+/** The submitter's name when the form asked for one. */
+function nameOf(data: Record<string, unknown> | undefined): { firstName?: string; lastName?: string } {
+  const get = (re: RegExp) => Object.entries(data ?? {}).find(([k, v]) => re.test(k) && typeof v === "string" && v.trim())?.[1] as string | undefined;
+  const first = get(/^first[ _-]?name$/i);
+  const last = get(/^last[ _-]?name$/i);
+  if (first || last) return { firstName: first?.trim(), lastName: last?.trim() };
+  return splitName(get(/^(full[ _-]?)?name$/i));
+}
+
+/** A submission opens the contact it created, or adds the person when no contact has that email. */
+export default function Page() {
+  const router = useRouter();
+  return (
+    <FormsScreen
+      renderSubmissionActions={(submission) => (
+        <ContactLookupLink email={emailOf(submission.form_data)} createIfMissing={nameOf(submission.form_data)} onOpen={(id) => router.push(`/contacts?id=${id}`)} />
+      )}
+    />
+  );
+}

package/stacks/hubspot/pages/inbox.tsx.tmpl

@@ -10,6 +10,7 @@ import { ApiError } from "@/components/g8/_foundation/api-error";
 import { EmptyState } from "@/components/g8/_foundation/empty-state";
 import { useG8Query } from "@/components/g8/_foundation/hooks/use-g8-query";
 import { g8Get } from "@/components/g8/_foundation/lib/g8-client";
+import { ContactLookupLink, splitName } from "@/components/g8/crm/contact-lookup-link";
 import { DealDetail } from "@/components/g8/deals/deal-detail";
 import { useDefaultOwner } from "@/components/g8/deals/hooks/use-default-owner";
 import { InboxScreen } from "@/components/g8/inbox/inbox-screen";
@@ -88,5 +89,15 @@ function CreateDeal({ thread }: { thread: InboxThread }) {
 }
 
 export default function Page() {
-  return <InboxScreen renderDetailActions={(thread) => <CreateDeal thread={thread} />} />;
+  const router = useRouter();
+  return (
+    <InboxScreen
+      renderDetailActions={(thread) => (
+        <>
+          <ContactLookupLink email={thread.contact?.email} createIfMissing={splitName(thread.contact?.name)} onOpen={(id) => router.push(`/contacts?id=${id}`)} />
+          <CreateDeal thread={thread} />
+        </>
+      )}
+    />
+  );
 }

package/stacks/hubspot/pages/lifecycle.tsx.tmpl

@@ -0,0 +1,23 @@
+"use client";
+
+// Generated by `graph8-sdk create {{stackId}}`. The {{block}} block's {{component}} (source in {{blockDir}}), with the
+// other blocks of this app plugged into its slots. Edit freely: this file is yours.
+import { useRouter } from "next/navigation";
+import { Button } from "@graph8/sdk/ui";
+import { Building2, UserRound } from "lucide-react";
+import { LifecycleScreen } from "@/components/g8/lifecycle/lifecycle-screen";
+
+/** A lifecycle record opens its company or contact record. */
+export default function Page() {
+  const router = useRouter();
+  return (
+    <LifecycleScreen
+      renderDetailActions={(record) => (
+        <Button size="sm" variant="outline" onClick={() => router.push(`/${record.kind === "company" ? "companies" : "contacts"}?id=${record.id}`)}>
+          {record.kind === "company" ? <Building2 className="mr-1 size-4" aria-hidden /> : <UserRound className="mr-1 size-4" aria-hidden />}
+          {record.kind === "company" ? "Open company" : "Open contact"}
+        </Button>
+      )}
+    />
+  );
+}

package/stacks/hubspot/pages/lists.tsx.tmpl

@@ -0,0 +1,12 @@
+"use client";
+
+// Generated by `graph8-sdk create {{stackId}}`. The {{block}} block's {{component}} (source in {{blockDir}}), with the
+// other blocks of this app plugged into its slots. Edit freely: this file is yours.
+import { useRouter } from "next/navigation";
+import { ListsScreen } from "@/components/g8/lists/lists-screen";
+
+/** A list member opens in Contacts. */
+export default function Page() {
+  const router = useRouter();
+  return <ListsScreen onOpenContact={(id) => router.push(`/contacts?id=${id}`)} />;
+}

package/stacks/hubspot/pages/meetings.tsx.tmpl

@@ -0,0 +1,13 @@
+"use client";
+
+// Generated by `graph8-sdk create {{stackId}}`. The {{block}} block's {{component}} (source in {{blockDir}}), with the
+// other blocks of this app plugged into its slots. Edit freely: this file is yours.
+import { useRouter } from "next/navigation";
+import { MeetingContactLinks } from "@/components/g8/appointments/meeting-contact-links";
+import { MeetingsScreen } from "@/components/g8/appointments/meetings-screen";
+
+/** A meeting opens the attendees who are contacts in your CRM. */
+export default function Page() {
+  const router = useRouter();
+  return <MeetingsScreen renderDetailActions={(selection) => <MeetingContactLinks selection={selection} onOpenContact={(id) => router.push(`/contacts?id=${id}`)} />} />;
+}

package/stacks/hubspot/pages/sequences.tsx.tmpl

@@ -0,0 +1,18 @@
+"use client";
+
+// Generated by `graph8-sdk create {{stackId}}`. The {{block}} block's {{component}} (source in {{blockDir}}), with the
+// other blocks of this app plugged into its slots. Edit freely: this file is yours.
+import { useRouter } from "next/navigation";
+import { SequenceCampaignLink } from "@/components/g8/sequencer/sequence-campaign-link";
+import { SequencesScreen } from "@/components/g8/sequencer/sequences-screen";
+
+/** An enrolled person opens in Contacts; a sequence opens, links or unlinks its campaign. */
+export default function Page() {
+  const router = useRouter();
+  return (
+    <SequencesScreen
+      onOpenContact={(id) => router.push(`/contacts?id=${id}`)}
+      renderDetailActions={(sequence) => <SequenceCampaignLink sequence={sequence} onOpenCampaign={(id) => router.push(`/campaigns?id=${encodeURIComponent(id)}`)} />}
+    />
+  );
+}

package/stacks/hubspot/pages/tasks.tsx.tmpl

@@ -0,0 +1,20 @@
+"use client";
+
+// Generated by `graph8-sdk create {{stackId}}`. The {{block}} block's {{component}} (source in {{blockDir}}), with the
+// other blocks of this app plugged into its slots. Edit freely: this file is yours.
+import { useRouter } from "next/navigation";
+import { TasksScreen } from "@/components/g8/crm/tasks-screen";
+
+/** A task's linked record opens in the screen that owns it. */
+export default function Page() {
+  const router = useRouter();
+  return (
+    <TasksScreen
+      onOpenRecord={(record) => {
+        if (record.entity_type === "contact") router.push(`/contacts?id=${encodeURIComponent(record.entity_id)}`);
+        if (record.entity_type === "company") router.push(`/companies?id=${encodeURIComponent(record.entity_id)}`);
+    if (record.entity_type === "deal") router.push(`/deals?id=${encodeURIComponent(record.entity_id)}`);
+      }}
+    />
+  );
+}

package/stacks/hubspot/pages/web-analytics.tsx.tmpl

@@ -0,0 +1,14 @@
+"use client";
+
+// Generated by `graph8-sdk create {{stackId}}`. The {{block}} block's {{component}} (source in {{blockDir}}), with the
+// other blocks of this app plugged into its slots. Edit freely: this file is yours.
+import { useRouter } from "next/navigation";
+import { WebAnalyticsScreen } from "@/components/g8/web-analytics/web-analytics-screen";
+import { useLandingPagePaths } from "@/components/g8/pages/hooks/use-landing-page-paths";
+
+/** A page in the reports opens its landing page, matched by the published address only (never by name). */
+export default function Page() {
+  const router = useRouter();
+  const landing = useLandingPagePaths();
+  return <WebAnalyticsScreen resolveLandingPage={landing.resolve} onOpenLandingPage={(id) => router.push(`/pages?id=${encodeURIComponent(id)}`)} />;
+}

package/stacks/hubspot.json

@@ -6,24 +6,30 @@
   "status": "available",
   "blocks": [
     "foundation",
+    "pickers",
     "crm",
     "objects",
     "lists",
     "visitors",
+    "web-analytics",
     "forms",
     "mailboxes",
+    "email-signatures",
     "sequencer",
     "campaigns",
     "inbox",
     "newsletter",
     "nurture",
+    "surveys",
     "webchat",
     "appointments",
     "pages",
+    "programmatic-pages",
     "social-ads",
     "lifecycle",
     "deals",
     "quotes",
+    "documents",
     "analytics",
     "workflows"
   ],
@@ -65,7 +71,8 @@
       "component": "ListsScreen",
       "icon": "ListChecks",
       "group": "Prospect",
-      "description": "Saved audiences you can sequence or sync"
+      "description": "Saved audiences you can sequence or sync",
+      "page": "pages/lists.tsx.tmpl"
     },
     {
       "label": "Visitors",
@@ -76,6 +83,16 @@
       "group": "Signals",
       "description": "Who is on your website right now"
     },
+    {
+      "label": "Web analytics",
+      "path": "/web-analytics",
+      "block": "web-analytics",
+      "component": "WebAnalyticsScreen",
+      "icon": "ChartNoAxesCombined",
+      "group": "Signals",
+      "description": "Traffic, audience, engagement and conversions for your sites",
+      "page": "pages/web-analytics.tsx.tmpl"
+    },
     {
       "label": "Inbox",
       "path": "/inbox",
@@ -102,7 +119,8 @@
       "component": "SequencesScreen",
       "icon": "Workflow",
       "group": "Engage",
-      "description": "Multi-step outreach cadences"
+      "description": "Multi-step outreach cadences",
+      "page": "pages/sequences.tsx.tmpl"
     },
     {
       "label": "Meetings",
@@ -111,7 +129,8 @@
       "component": "MeetingsScreen",
       "icon": "CalendarCheck",
       "group": "Engage",
-      "description": "Booked, held and missed meetings"
+      "description": "Booked, held and missed meetings",
+      "page": "pages/meetings.tsx.tmpl"
     },
     {
       "label": "Scheduling",
@@ -129,7 +148,8 @@
       "component": "CampaignsScreen",
       "icon": "Rocket",
       "group": "Engage",
-      "description": "Campaigns from brief to launch"
+      "description": "Campaigns from brief to launch",
+      "page": "pages/campaigns.tsx.tmpl"
     },
     {
       "label": "Newsletter",
@@ -149,6 +169,15 @@
       "group": "Marketing",
       "description": "Automated nurture tracks"
     },
+    {
+      "label": "Surveys",
+      "path": "/surveys",
+      "block": "surveys",
+      "component": "SurveysScreen",
+      "icon": "ClipboardCheck",
+      "group": "Marketing",
+      "description": "NPS and CSAT: ask, score and read the answers"
+    },
     {
       "label": "Forms",
       "path": "/forms",
@@ -156,7 +185,8 @@
       "component": "FormsScreen",
       "icon": "ClipboardList",
       "group": "Marketing",
-      "description": "Forms and their submissions"
+      "description": "Forms and their submissions",
+      "page": "pages/forms.tsx.tmpl"
     },
     {
       "label": "Pages",
@@ -167,6 +197,15 @@
       "group": "Marketing",
       "description": "Landing pages, brand kit and content"
     },
+    {
+      "label": "Programmatic pages",
+      "path": "/programmatic-pages",
+      "block": "programmatic-pages",
+      "component": "ProgrammaticPagesScreen",
+      "icon": "Layers",
+      "group": "Marketing",
+      "description": "A page per row: render, preview, publish and roll back"
+    },
     {
       "label": "Social",
       "path": "/social",
@@ -212,7 +251,8 @@
       "component": "LifecycleScreen",
       "icon": "GitBranch",
       "group": "Pipeline",
-      "description": "Move records through lifecycle stages"
+      "description": "Move records through lifecycle stages",
+      "page": "pages/lifecycle.tsx.tmpl"
     },
     {
       "label": "Tasks",
@@ -221,7 +261,17 @@
       "component": "TasksScreen",
       "icon": "CheckSquare",
       "group": "Work",
-      "description": "Follow-ups due across your records"
+      "description": "Follow-ups due across your records",
+      "page": "pages/tasks.tsx.tmpl"
+    },
+    {
+      "label": "Documents",
+      "path": "/documents",
+      "block": "documents",
+      "component": "DocumentsScreen",
+      "icon": "FileText",
+      "group": "Work",
+      "description": "Library, security questionnaires and account correspondence"
     },
     {
       "label": "Workflows",
@@ -250,6 +300,15 @@
       "group": "Setup",
       "description": "Sending mailboxes and warmup health"
     },
+    {
+      "label": "Email signatures",
+      "path": "/email-signatures",
+      "block": "email-signatures",
+      "component": "EmailSignaturesScreen",
+      "icon": "PenLine",
+      "group": "Setup",
+      "description": "One signature for the team, kept on every mailbox"
+    },
     {
       "label": "Suppressions",
       "path": "/suppressions",

package/stacks/intercom/pages/companies.tsx.tmpl

@@ -0,0 +1,19 @@
+"use client";
+
+// Generated by `graph8-sdk create {{stackId}}`. The {{block}} block's {{component}} (source in {{blockDir}}), with the
+// other blocks of this app plugged into its slots. Edit freely: this file is yours.
+import { CompaniesScreen } from "@/components/g8/crm/companies-screen";
+import { RecordEngagementTab } from "@/components/g8/crm/record-engagement-tab";
+import { useRouter } from "next/navigation";
+
+export default function Page() {
+  const router = useRouter();
+  return (
+    <CompaniesScreen
+      onOpenContact={(contact) => router.push(`/contacts?id=${contact.id}`)}
+      extraDetailTabs={[
+        { id: "engagement", label: "Engagement", render: (c) => <RecordEngagementTab kind="companies" id={c.id} /> },
+      ]}
+    />
+  );
+}

package/stacks/intercom/pages/contacts.tsx.tmpl

@@ -0,0 +1,21 @@
+"use client";
+
+// Generated by `graph8-sdk create {{stackId}}`. The {{block}} block's {{component}} (source in {{blockDir}}), with the
+// other blocks of this app plugged into its slots. Edit freely: this file is yours.
+import { ContactsScreen } from "@/components/g8/crm/contacts-screen";
+import { RecordEngagementTab } from "@/components/g8/crm/record-engagement-tab";
+import { RecordConversationsTab } from "@/components/g8/inbox/record-conversations-tab";
+import { useRouter } from "next/navigation";
+
+export default function Page() {
+  const router = useRouter();
+  return (
+    <ContactsScreen
+      onOpenCompany={(id) => router.push(`/companies?id=${id}`)}
+      extraDetailTabs={[
+        { id: "conversations", label: "Conversations", render: (c) => <RecordConversationsTab email={c.work_email} alsoEmails={[c.personal_emails]} onOpenThread={(sel) => router.push(`/inbox?id=${encodeURIComponent(sel)}`)} /> },
+        { id: "engagement", label: "Engagement", render: (c) => <RecordEngagementTab kind="contacts" id={c.id} /> },
+      ]}
+    />
+  );
+}

package/stacks/intercom/pages/inbox-contact.tsx.tmpl

@@ -0,0 +1,13 @@
+"use client";
+
+// Generated by `graph8-sdk create {{stackId}}`. The {{block}} block's {{component}} (source in {{blockDir}}), with the
+// other blocks of this app plugged into its slots. Edit freely: this file is yours.
+import { useRouter } from "next/navigation";
+import { ContactLookupLink, splitName } from "@/components/g8/crm/contact-lookup-link";
+import { InboxScreen } from "@/components/g8/inbox/inbox-screen";
+
+/** A conversation opens the sender when they are a contact in your CRM, or adds them when they are new. */
+export default function Page() {
+  const router = useRouter();
+  return <InboxScreen renderDetailActions={(thread) => <ContactLookupLink email={thread.contact?.email} createIfMissing={splitName(thread.contact?.name)} onOpen={(id) => router.push(`/contacts?id=${id}`)} />} />;
+}

package/stacks/intercom/pages/tasks.tsx.tmpl

@@ -0,0 +1,19 @@
+"use client";
+
+// Generated by `graph8-sdk create {{stackId}}`. The {{block}} block's {{component}} (source in {{blockDir}}), with the
+// other blocks of this app plugged into its slots. Edit freely: this file is yours.
+import { useRouter } from "next/navigation";
+import { TasksScreen } from "@/components/g8/crm/tasks-screen";
+
+/** A task's linked record opens in the screen that owns it. */
+export default function Page() {
+  const router = useRouter();
+  return (
+    <TasksScreen
+      onOpenRecord={(record) => {
+        if (record.entity_type === "contact") router.push(`/contacts?id=${encodeURIComponent(record.entity_id)}`);
+        if (record.entity_type === "company") router.push(`/companies?id=${encodeURIComponent(record.entity_id)}`);
+      }}
+    />
+  );
+}