proto-plugin 0.1.1 → 0.1.3

package/src/components/platform-ui/controls-panel-select.tsx

@@ -116,21 +116,22 @@ export function ControlsPanelSelect<T extends string>({
   const isMiniPill = appearance === "miniPill";
   const isMenuList = appearance === "menuList";
   const review = usePrototypeReviewOptional();
+  const registerPreviewStates = review?.registerPreviewStates;
   const { commentTheme } = usePrototypeToolTheme();
   const triggerLabel = isMiniPill ? (miniPillLabel ?? activeLabel) : activeLabel;
   const [open, setOpen] = useState(false);
   const triggerRef = useRef<HTMLButtonElement>(null);
 
   useEffect(() => {
-    if (!isMenuList || !review) return;
+    if (!isMenuList || !registerPreviewStates) return;
 
-    review.registerPreviewStates(
+    registerPreviewStates(
       getSelectableOptions(options).map((option) => ({
         id: option.value,
         label: option.label,
       })),
     );
-  }, [isMenuList, options, review]);
+  }, [isMenuList, options, registerPreviewStates]);
 
   const selectSubmenuEntry = useCallback(
     (

package/src/components/platform-ui/prototype-tool-dialog.tsx

@@ -0,0 +1,117 @@
+"use client";
+
+import {
+  Dialog,
+  DialogClose,
+  DialogContent,
+  DialogTitle,
+} from "@prototype/components/ui/dialog";
+import { cn } from "@prototype/lib/utils";
+import { X } from "lucide-react";
+import type { ReactNode } from "react";
+
+export const PROTOTYPE_TOOL_MODAL_CLOSE_CLASS =
+  "text-muted-foreground hover:text-foreground inline-flex size-8 shrink-0 items-center justify-center rounded-sm border-0 bg-transparent p-0 opacity-70 transition-opacity duration-200 ease hover:opacity-100 outline-none focus:outline-hidden focus-visible:ring-2 focus-visible:ring-focus-ring focus-visible:ring-offset-0 disabled:pointer-events-none disabled:opacity-40 disabled:hover:opacity-40 disabled:hover:text-muted-foreground motion-reduce:transition-none [&_svg]:pointer-events-none [&_svg]:shrink-0 [&_svg:not([class*='size-'])]:size-4";
+
+export const PROTOTYPE_TOOL_MODAL_TEXTAREA_CLASS =
+  "field-sizing-content min-h-[min(50vh,20rem)] w-full resize-y border-0 bg-transparent px-0 py-0 text-sm leading-relaxed text-foreground shadow-none outline-none placeholder:text-muted-foreground focus-visible:ring-0";
+
+const MODAL_SIZE_CLASS = {
+  md: "w-[min(42rem,calc(100vw-2rem))] max-w-[min(42rem,calc(100vw-2rem))] sm:max-w-[min(42rem,calc(100vw-2rem))]",
+  wide: "w-[min(96rem,calc(100vw-2rem))] max-w-[min(96rem,calc(100vw-2rem))] sm:max-w-[min(96rem,calc(100vw-2rem))]",
+} as const;
+
+function PrototypeToolDialogSeparator() {
+  return (
+    <div
+      className="tool-dialog-separator h-px w-full shrink-0"
+      role="separator"
+      aria-hidden
+    />
+  );
+}
+
+export type PrototypeToolDialogProps = {
+  open: boolean;
+  onOpenChange: (open: boolean) => void;
+  title: ReactNode;
+  description?: ReactNode;
+  children: ReactNode;
+  footer?: ReactNode;
+  footerClassName?: string;
+  headerActions?: ReactNode;
+  size?: keyof typeof MODAL_SIZE_CLASS;
+  bodyClassName?: string;
+  className?: string;
+};
+
+export function PrototypeToolDialog({
+  open,
+  onOpenChange,
+  title,
+  description,
+  children,
+  footer,
+  footerClassName,
+  headerActions,
+  size = "md",
+  bodyClassName,
+  className,
+}: PrototypeToolDialogProps) {
+  return (
+    <Dialog open={open} onOpenChange={onOpenChange}>
+      <DialogContent
+        portalScope="tool"
+        showCloseButton={false}
+        className={cn(
+          "tool-dialog-surface flex max-h-[min(92svh,calc(100%-2rem))] flex-col gap-0 overflow-hidden border-0 p-0",
+          MODAL_SIZE_CLASS[size],
+          className,
+        )}
+      >
+        <div className="flex items-start justify-between gap-3 px-5 py-4">
+          <div className="flex min-w-0 flex-col gap-1">
+            <DialogTitle className="text-base font-medium text-foreground">
+              {title}
+            </DialogTitle>
+            {description ? (
+              <p className="text-sm text-muted-foreground">{description}</p>
+            ) : null}
+          </div>
+          <div className="flex shrink-0 items-center gap-0.5">
+            {headerActions}
+            <DialogClose className={PROTOTYPE_TOOL_MODAL_CLOSE_CLASS}>
+              <X />
+              <span className="sr-only">Close</span>
+            </DialogClose>
+          </div>
+        </div>
+
+        <PrototypeToolDialogSeparator />
+
+        <div
+          className={cn(
+            "flex min-h-0 flex-1 flex-col overflow-y-auto px-5 py-4",
+            bodyClassName,
+          )}
+        >
+          {children}
+        </div>
+
+        {footer ? (
+          <>
+            <PrototypeToolDialogSeparator />
+            <div
+              className={cn(
+                "flex items-center gap-2 px-5 py-3",
+                footerClassName,
+              )}
+            >
+              {footer}
+            </div>
+          </>
+        ) : null}
+      </DialogContent>
+    </Dialog>
+  );
+}

package/src/components/platform-ui/sidebar.tsx

@@ -20,11 +20,22 @@ export function clampSidebarWidth(width: number) {
   return Math.min(MAX_SIDEBAR_WIDTH, Math.max(MIN_SIDEBAR_WIDTH, width));
 }
 
+/** e.g. `data-comments-sidebar` + `"open"` → `data-comments-sidebar-open` */
+export function getSidebarStateAttribute(
+  dataAttribute: string,
+  suffix: "open" | "inline" | "resizing",
+): string {
+  const base = dataAttribute.startsWith("data-")
+    ? dataAttribute.slice(5)
+    : dataAttribute;
+  return `data-${base}-${suffix}`;
+}
+
 const SIDEBAR_TITLE_CLASS =
-  "font-display truncate text-sm font-semibold text-[var(--tool-chrome-icon-hover)]";
+  "font-display truncate text-sm font-semibold text-[var(--tool-chrome-text-heading)]";
 
 export const SIDEBAR_ICON_BUTTON_CLASS =
-  "text-[var(--tool-chrome-icon)] hover:bg-[var(--tool-chrome-gray-highlight)] hover:text-[var(--tool-chrome-icon-hover)] focus:outline-none focus-visible:ring-0 focus-visible:ring-offset-0";
+  "cursor-pointer text-[var(--tool-chrome-icon)] hover:bg-[var(--tool-chrome-gray-highlight)] hover:text-[var(--tool-chrome-icon-hover)] focus:outline-none focus-visible:ring-0 focus-visible:ring-offset-0";
 
 type SidebarProps = {
   open: boolean;
@@ -59,6 +70,9 @@ export function Sidebar({
   className,
   overlay = false,
 }: SidebarProps) {
+  const openAttr = getSidebarStateAttribute(dataAttribute, "open");
+  const inlineAttr = getSidebarStateAttribute(dataAttribute, "inline");
+  const resizingAttr = getSidebarStateAttribute(dataAttribute, "resizing");
   const [sidebarWidth, setSidebarWidth] = useState(DEFAULT_SIDEBAR_WIDTH);
   const [isResizing, setIsResizing] = useState(false);
   const resizeStartRef = useRef<{ startX: number; startWidth: number } | null>(
@@ -80,7 +94,9 @@ export function Sidebar({
   );
 
   useEffect(() => {
-    document.documentElement.setAttribute("data-platform-sidebar-inline", "");
+    if (!overlay) {
+      document.documentElement.setAttribute(inlineAttr, "");
+    }
     document.documentElement.style.setProperty(
       widthCssVar,
       `${DEFAULT_SIDEBAR_WIDTH}px`,
@@ -88,22 +104,19 @@ export function Sidebar({
 
     return () => {
       document.documentElement.style.removeProperty(widthCssVar);
-      document.documentElement.removeAttribute("data-platform-sidebar-open");
-      document.documentElement.removeAttribute("data-platform-sidebar-resizing");
-      document.documentElement.removeAttribute("data-platform-sidebar-inline");
+      document.documentElement.removeAttribute(openAttr);
+      document.documentElement.removeAttribute(resizingAttr);
+      document.documentElement.removeAttribute(inlineAttr);
     };
-  }, [widthCssVar]);
+  }, [inlineAttr, openAttr, overlay, resizingAttr, widthCssVar]);
 
   useEffect(() => {
-    document.documentElement.toggleAttribute("data-platform-sidebar-open", open);
-  }, [open]);
+    document.documentElement.toggleAttribute(openAttr, open);
+  }, [open, openAttr]);
 
   useEffect(() => {
-    document.documentElement.toggleAttribute(
-      "data-platform-sidebar-resizing",
-      isResizing,
-    );
-  }, [isResizing]);
+    document.documentElement.toggleAttribute(resizingAttr, isResizing);
+  }, [isResizing, resizingAttr]);
 
   const handleResizeStart = useCallback(
     (event: ReactPointerEvent<HTMLDivElement>) => {
@@ -152,7 +165,7 @@ export function Sidebar({
           : { width: open ? sidebarWidth : 0 }
       }
       className={cn(
-        "flex h-full shrink-0 flex-col overflow-hidden bg-[var(--tool-chrome-ground)] text-[var(--tool-chrome-icon)]",
+        "flex h-full shrink-0 flex-col overflow-hidden bg-[var(--tool-chrome-ground)] text-[var(--tool-chrome-text)]",
         isResizing && "select-none transition-none",
         overlay
           ? "absolute inset-y-0 right-0 shadow-2xl transition-transform duration-200 ease-out"
@@ -226,13 +239,18 @@ type SidebarResizeHandleProps = {
 export function SidebarResizeHandle({
   open,
   sidebarWidth,
+  isResizing,
   onResizeStart,
   onResizeMove,
   onResizeEnd,
 }: SidebarResizeHandleProps) {
   return (
     <div
-      className="absolute top-0 left-[-4px] z-[1] h-full w-2 cursor-col-resize touch-none before:absolute before:top-0 before:left-[3px] before:h-full before:w-0.5 before:bg-transparent before:transition-colors hover:before:bg-border [[data-platform-sidebar-resizing]_&]:before:bg-border"
+      data-resizing={isResizing ? "" : undefined}
+      className={cn(
+        "absolute top-0 left-[-4px] z-[1] h-full w-2 cursor-col-resize touch-none before:absolute before:top-0 before:left-[3px] before:h-full before:w-0.5 before:bg-transparent before:transition-colors hover:before:bg-border data-resizing:before:bg-border",
+        isResizing && "select-none",
+      )}
       onPointerDown={onResizeStart}
       onPointerMove={onResizeMove}
       onPointerUp={onResizeEnd}

package/src/components/prototype-gallery-client.tsx

@@ -1,57 +1,97 @@
 "use client";
 
-import Image from "next/image";
-import Link from "next/link";
-
+import { PrototypeCreatePrototypeModal } from "@prototype/components/prototypes/prototype-create-prototype-modal";
 import type { PrototypeMetadata } from "@prototype/lib/prototypes/prototype-config-types";
 import { screenshotSrc } from "@prototype/lib/prototypes/screenshot-src";
 import { cn } from "@prototype/lib/utils";
+import { Plus } from "lucide-react";
+import Image from "next/image";
+import Link from "next/link";
+import { useState } from "react";
 
 type PrototypeGalleryClientProps = {
   prototypes: PrototypeMetadata[];
   screenshotVersions: Record<string, number>;
 };
 
+const prototypeGalleryTitleClassName =
+  "mt-2 text-sm text-[var(--tool-chrome-text-muted)] transition-colors duration-300 ease-out group-hover:text-[var(--tool-chrome-text-heading)]";
+
+function PrototypeGalleryAddCard({ onClick }: { onClick: () => void }) {
+  return (
+    <button
+      type="button"
+      onClick={onClick}
+      aria-label="New prototype"
+      className="group block w-full cursor-pointer text-left"
+    >
+      <div
+        className={cn(
+          "rounded-xl",
+          "shadow-[var(--tool-review-card-shadow)]",
+          "translate-y-0 transition-[translate,box-shadow] duration-300 ease-out will-change-[translate]",
+          "group-hover:-translate-y-1 group-hover:shadow-[var(--tool-review-card-shadow-hover)]",
+        )}
+      >
+        <div className="relative flex aspect-video items-center justify-center overflow-hidden rounded-xl border border-dashed border-[var(--tool-chrome-border)] bg-[var(--tool-chrome-surface)] text-[var(--tool-chrome-text-muted)] transition-colors duration-300 ease-out group-hover:text-[var(--tool-chrome-text-heading)]">
+          <Plus size={20} strokeWidth={2} aria-hidden />
+        </div>
+      </div>
+      <p className={cn(prototypeGalleryTitleClassName, "invisible")} aria-hidden>
+        &nbsp;
+      </p>
+    </button>
+  );
+}
+
 export function PrototypeGalleryClient({
   prototypes,
   screenshotVersions,
 }: PrototypeGalleryClientProps) {
+  const [createModalOpen, setCreateModalOpen] = useState(false);
+
   return (
-    <div className="grid grid-cols-1 gap-4 md:grid-cols-2 lg:grid-cols-3">
-      {prototypes.map((prototype) => (
-        <Link
-          key={prototype.slug}
-          href={`/prototypes/${prototype.slug}`}
-          className="group"
-        >
-          <div
-            className={cn(
-              "rounded-xl",
-              "shadow-[0_1px_3px_0_rgb(0_0_0/0.06)]",
-              "translate-y-0 transition-[translate,box-shadow] duration-300 ease-out will-change-[translate]",
-              "group-hover:-translate-y-1 group-hover:shadow-[0_4px_12px_-4px_rgb(0_0_0/0.10)]",
-            )}
+    <>
+      <div className="grid grid-cols-1 gap-4 md:grid-cols-2 lg:grid-cols-3">
+        <PrototypeGalleryAddCard onClick={() => setCreateModalOpen(true)} />
+        {prototypes.map((prototype) => (
+          <Link
+            key={prototype.slug}
+            href={`/prototypes/${prototype.slug}`}
+            className="group"
           >
-            <div className="border-border bg-background relative aspect-video overflow-hidden rounded-xl border">
-              <Image
-                src={screenshotSrc(
-                  prototype.screenshot,
-                  screenshotVersions[prototype.slug],
-                )}
-                alt={prototype.title}
-                width={1600}
-                height={900}
-                quality={90}
-                sizes="(min-width: 1024px) 33vw, (min-width: 768px) 50vw, 100vw"
-                className="h-full w-full object-cover object-top"
-              />
+            <div
+              className={cn(
+                "rounded-xl",
+                "shadow-[var(--tool-review-card-shadow)]",
+                "translate-y-0 transition-[translate,box-shadow] duration-300 ease-out will-change-[translate]",
+                "group-hover:-translate-y-1 group-hover:shadow-[var(--tool-review-card-shadow-hover)]",
+              )}
+            >
+              <div className="relative aspect-video overflow-hidden rounded-xl border border-[var(--tool-chrome-border)] bg-[var(--tool-chrome-surface)]">
+                <Image
+                  src={screenshotSrc(
+                    prototype.screenshot,
+                    screenshotVersions[prototype.slug],
+                  )}
+                  alt={prototype.title}
+                  width={1600}
+                  height={900}
+                  quality={90}
+                  sizes="(min-width: 1024px) 33vw, (min-width: 768px) 50vw, 100vw"
+                  className="h-full w-full object-cover object-top"
+                />
+              </div>
             </div>
-          </div>
-          <p className="text-sm text-muted-foreground group-hover:text-foreground mt-2 transition-colors duration-300 ease-out">
-            {prototype.title}
-          </p>
-        </Link>
-      ))}
-    </div>
+            <p className={prototypeGalleryTitleClassName}>{prototype.title}</p>
+          </Link>
+        ))}
+      </div>
+
+      <PrototypeCreatePrototypeModal
+        open={createModalOpen}
+        onOpenChange={setCreateModalOpen}
+      />
+    </>
   );
 }

package/src/components/prototypes/design-exploration-variant-preview-shell.tsx

@@ -0,0 +1,43 @@
+"use client";
+
+import { cn } from "@prototype/lib/utils";
+import type { ReactNode } from "react";
+
+export type DesignExplorationVariantPreviewLayout = "inline" | "overlay";
+
+export type DesignExplorationVariantPreviewShellProps = {
+  /** Use `overlay` when the variant uses absolute positioning on the live page. */
+  layout?: DesignExplorationVariantPreviewLayout;
+  children: ReactNode;
+  className?: string;
+};
+
+/**
+ * Hosts a variant inside the design-brief preview card. Overlay layouts get a
+ * positioned shell so absolutely placed controls remain visible in the sidebar.
+ */
+export function DesignExplorationVariantPreviewShell({
+  layout = "inline",
+  children,
+  className,
+}: DesignExplorationVariantPreviewShellProps) {
+  const isOverlay = layout === "overlay";
+
+  return (
+    <div
+      className={cn(
+        "relative bg-white",
+        isOverlay ? "h-full w-full" : "w-full px-2 py-3",
+        className,
+      )}
+    >
+      {isOverlay ? (
+        <div
+          className="from-muted/25 to-muted/5 pointer-events-none absolute inset-0 bg-gradient-to-b"
+          aria-hidden
+        />
+      ) : null}
+      {children}
+    </div>
+  );
+}

package/src/components/prototypes/prototype-brief-field.tsx

@@ -0,0 +1,33 @@
+"use client";
+
+import { cn } from "@prototype/lib/utils";
+import type { ComponentPropsWithoutRef } from "react";
+
+/** Shared border/focus styling for prototype brief inputs (gallery modals + review sidebar). */
+export const PROTOTYPE_BRIEF_FIELD_BORDER_CLASS =
+  "border border-border shadow-none outline-none transition-colors focus-visible:border-muted-foreground/40 focus-visible:ring-1 focus-visible:ring-muted-foreground/20 focus-visible:ring-offset-0";
+
+const BRIEF_TEXTAREA_BASE_CLASS =
+  "field-sizing-content w-full resize-y rounded-md bg-transparent px-3 py-2 text-sm leading-relaxed text-foreground placeholder:text-muted-foreground";
+
+export type PrototypeBriefTextareaProps = ComponentPropsWithoutRef<"textarea"> & {
+  minHeightClass?: string;
+};
+
+export function PrototypeBriefTextarea({
+  className,
+  minHeightClass = "min-h-[min(40vh,14rem)]",
+  ...props
+}: PrototypeBriefTextareaProps) {
+  return (
+    <textarea
+      className={cn(
+        BRIEF_TEXTAREA_BASE_CLASS,
+        minHeightClass,
+        PROTOTYPE_BRIEF_FIELD_BORDER_CLASS,
+        className,
+      )}
+      {...props}
+    />
+  );
+}

package/src/components/prototypes/prototype-change-log-panel.tsx

@@ -4,22 +4,23 @@ import { filterAnnotationsByChannel } from "@prototype/lib/prototype-comments/co
 import { useCommentStore } from "@prototype/lib/prototype-comments/react/CommentProvider";
 import { useCommentCaptureBridgeOptional } from "@prototype/lib/prototype-comments/react/CommentCaptureToolbar";
 import { CommentsGrid } from "@prototype/lib/prototype-comments/ui/CommentsGrid";
-import { useChangelogMeta } from "@prototype/lib/prototypes/changelog-meta-context";
+import { buildChangelogDescriptionCopyText } from "@prototype/lib/prototypes/changelog-description-prompt";
 import { usePrototypeReview } from "@prototype/lib/prototypes/prototype-review-context";
+import {
+  prototypeReviewPreferenceKey,
+  usePersistedLocalString,
+} from "@prototype/lib/prototypes/use-persisted-local-state";
 import { ToolbarIconButton } from "@prototype/components/platform-ui/toolbar-icon-button";
+import { Button } from "@prototype/components/ui/button";
 import { Label } from "@prototype/components/ui/label";
 import { Switch } from "@prototype/components/ui/switch";
-import { Plus, Save } from "lucide-react";
+import useCopyToClipboard from "@prototype/lib/use-copy-to-clipboard";
+import { Plus } from "lucide-react";
 import { cn } from "@prototype/lib/utils";
-import {
-  useCallback,
-  useEffect,
-  useMemo,
-  useState,
-  type ChangeEvent,
-} from "react";
+import { useMemo } from "react";
 
 import { PrototypeReferenceDocs } from "./prototype-reference-docs";
+import { PrototypeCommentStorageEmptyState } from "./prototype-comment-storage-empty-state";
 
 const CHANGELOG_SECTION_TITLE_CLASS = "tool-section-label";
 
@@ -105,64 +106,65 @@ export function PrototypeChangeLogPanel({
     updateAnnotation,
     storageError,
     storageReady,
+    storageConfigured,
   } = useCommentStore();
-  const { overview, ready: metaReady, error: metaError, setOverview } =
-    useChangelogMeta();
-  const [draftOverview, setDraftOverview] = useState(overview);
+  const review = usePrototypeReview();
+  const { value: description, updateValue: updateDescription } =
+    usePersistedLocalString(
+      prototypeReviewPreferenceKey(review.slug, "changelog-description-brief"),
+      "",
+    );
+  const {
+    copy: copyDescriptionPrompt,
+    icon: copyDescriptionIcon,
+    isCopied: isDescriptionCopied,
+  } = useCopyToClipboard();
   const changelogAnnotations = useMemo(
     () => filterAnnotationsByChannel(annotations, "changelog"),
     [annotations],
   );
+  const canCopyDescription = description.trim().length > 0;
 
-  useEffect(() => {
-    if (metaReady) {
-      setDraftOverview(overview);
-    }
-  }, [metaReady, overview]);
-
-  const isOverviewDirty = draftOverview !== overview;
+  const handleCopyDescriptionPrompt = () => {
+    if (!canCopyDescription) return;
 
-  const handleOverviewChange = useCallback(
-    (event: ChangeEvent<HTMLTextAreaElement>) => {
-      setDraftOverview(event.target.value);
-    },
-    [],
-  );
+    const origin =
+      typeof window !== "undefined" ? window.location.origin : undefined;
 
-  const handleSaveOverview = useCallback(() => {
-    setOverview(draftOverview);
-  }, [draftOverview, setOverview]);
+    copyDescriptionPrompt(
+      buildChangelogDescriptionCopyText({
+        slug: review.slug,
+        description,
+        origin,
+      }),
+    );
+  };
 
   return (
     <div className="flex flex-col">
       <section className={CHANGELOG_SECTION_CLASS}>
-        <div className="flex items-center justify-between gap-2">
-          <span className={CHANGELOG_SECTION_TITLE_CLASS}>Description</span>
-          {metaReady && !metaError ? (
-            <ToolbarIconButton
-              onClick={handleSaveOverview}
-              disabled={!isOverviewDirty}
-              aria-label="Save description"
-            >
-              <Save size={16} strokeWidth={2} aria-hidden />
-            </ToolbarIconButton>
-          ) : null}
-        </div>
-        {!metaReady ? (
-          <p className="text-muted-foreground text-xs">Loading description…</p>
-        ) : metaError ? (
-          <p className="text-destructive text-xs">{metaError}</p>
-        ) : (
-          <textarea
-            id="prototype-changelog-overview"
-            value={draftOverview}
-            onChange={handleOverviewChange}
-            rows={1}
-            placeholder="Summarize what changed and why…"
-            aria-label="Description"
-            className={CHANGELOG_OVERVIEW_FIELD_CLASS}
-          />
-        )}
+        <span className={CHANGELOG_SECTION_TITLE_CLASS}>Description</span>
+        <textarea
+          id="prototype-changelog-overview"
+          value={description}
+          onChange={(event) => updateDescription(event.target.value)}
+          rows={3}
+          placeholder="Summarize what changed and why…"
+          aria-label="Description"
+          className={CHANGELOG_OVERVIEW_FIELD_CLASS}
+        />
+        <Button
+          type="button"
+          variant="chrome"
+          size="sm"
+          className="h-8 gap-1.5 self-start"
+          disabled={!canCopyDescription}
+          onClick={handleCopyDescriptionPrompt}
+          aria-label="Copy description prompt"
+        >
+          {isDescriptionCopied ? "Copied prompt" : "Copy prompt"}
+          {copyDescriptionIcon}
+        </Button>
       </section>
 
       <PrototypeReferenceDocs
@@ -182,6 +184,8 @@ export function PrototypeChangeLogPanel({
         </div>
         {!storageReady ? (
           <p className="text-muted-foreground text-xs">Loading changes…</p>
+        ) : storageConfigured === false ? (
+          <PrototypeCommentStorageEmptyState message={storageError ?? undefined} />
         ) : storageError ? (
           <p className="text-destructive text-xs">{storageError}</p>
         ) : (

package/src/components/prototypes/prototype-comment-provider.tsx

@@ -4,7 +4,6 @@ import type { ReactNode } from "react";
 
 import { PrototypeTargetIdProvider } from "@prototype/components/prototypes/prototype-target";
 import { CommentProvider } from "@prototype/lib/prototype-comments/react/CommentProvider";
-import { ChangelogMetaProvider } from "@prototype/lib/prototypes/changelog-meta-context";
 import type { PrototypeComponentRegistry } from "@prototype/lib/prototypes/prototype-component-registry";
 import { getPrototypeComponentRegistryForSlug } from "@prototype/lib/prototypes/create-prototype-registry";
 import {

package/src/components/prototypes/prototype-comment-storage-empty-state.tsx

@@ -0,0 +1,41 @@
+"use client";
+
+import { Button } from "@prototype/components/ui/button";
+import {
+  buildCommentStorageSetupCopyText,
+  COMMENT_STORAGE_NOT_CONFIGURED_MESSAGE,
+} from "@prototype/lib/prototypes/comment-storage-setup-prompt";
+import useCopyToClipboard from "@prototype/lib/use-copy-to-clipboard";
+
+type PrototypeCommentStorageEmptyStateProps = {
+  message?: string;
+  vercelProjectName?: string;
+};
+
+export function PrototypeCommentStorageEmptyState({
+  message = COMMENT_STORAGE_NOT_CONFIGURED_MESSAGE,
+  vercelProjectName,
+}: PrototypeCommentStorageEmptyStateProps) {
+  const { copy, icon, isCopied } = useCopyToClipboard();
+
+  return (
+    <div className="px-1 py-2">
+      <p className="text-sm text-muted-foreground">{message}</p>
+      <div className="mt-3">
+        <Button
+          type="button"
+          variant="outline"
+          size="sm"
+          className="h-8 cursor-pointer gap-1.5"
+          onClick={() => {
+            copy(buildCommentStorageSetupCopyText({ vercelProjectName }));
+          }}
+          aria-label="Copy comment storage setup prompt"
+        >
+          {isCopied ? "Copied prompt" : "Copy setup prompt"}
+          {icon}
+        </Button>
+      </div>
+    </div>
+  );
+}