Skip to content

Self-hosted, Self-Improving, Federated Everything App — dev management, agent orchestration, persistent mind, digital twin, second brain, and creative pipeline from a single dashboard over Tailscale to port the user into the OS

fix: guide empty 3D libraries and collapse re-render options (#11011)

Adam Eivyd5e6752c3457
diff --git a/client/src/pages/Media3D.jsx b/client/src/pages/Media3D.jsx
index 4c3a4eeb0e..fee5ef7ece 100644
--- a/client/src/pages/Media3D.jsx
+++ b/client/src/pages/Media3D.jsx
@@ -2,6 +2,7 @@ import { useCallback, useEffect, useMemo, useState } from 'react';
import { Link } from 'react-router';
import { Boxes, CheckCircle2, AlertTriangle, Loader2, ImagePlus, Sparkles, Settings2, ChevronDown } from 'lucide-react';
import PageHeader from '../components/PageHeader';
+import EmptyState from '../components/EmptyState';
import { createImageTo3dModel, getImageTo3dModel, listImageTo3dModels } from '../services/api';
import { useModelLifecycle } from '../hooks/useModelLifecycle';
import { useImageTo3dTargets } from '../hooks/useImageTo3dTargets';
@@ -50,15 +51,23 @@ export default function Media3D() {
// Existing image-to-3D records (newest-first) so the page doubles as a library:
// each links to its `/3d/:id` detail view.
const [records, setRecords] = useState([]);
+ const [recordsLoading, setRecordsLoading] = useState(true);
+ const [recordsError, setRecordsError] = useState(false);
// Central HF-token status (stored / env / cli) for the gated-model notice. `present`
// is tri-state — see useHfTokenStatus; `null` means unknown, not absent.
const { present: hfTokenPresent, source: hfTokenSource, refresh: refreshHfToken } = useHfTokenStatus();
const mountedRef = useMounted(); // gate setState after the create awaits
const loadRecords = useCallback(() => {
+ setRecordsLoading(true);
+ setRecordsError(false);
listImageTo3dModels({ silent: true })
- .then((data) => { if (mountedRef.current) setRecords(Array.isArray(data) ? data : []); })
- .catch(() => { /* the library section just stays empty on a transient failure */ });
+ .then((data) => {
+ if (!Array.isArray(data)) throw new Error('Invalid model list');
+ if (mountedRef.current) setRecords(data);
+ })
+ .catch(() => { if (mountedRef.current) setRecordsError(true); })
+ .finally(() => { if (mountedRef.current) setRecordsLoading(false); });
}, [mountedRef]);
// Reactively fold a created/updated record into the library instead of
@@ -320,45 +329,67 @@ export default function Media3D() {
{/* Library of existing renders — each opens its `/3d/:id` detail
view (GLB viewer + download). URL is the source of truth for what's
open, so every card is a deep link. */}
- {records.length > 0 && (
- <section className="mb-6">
+ <section className="mb-6">
<h2 className="mb-2 text-xs font-medium uppercase tracking-wide text-gray-400">Your 3D models</h2>
- <div className="grid grid-cols-2 gap-3 sm:grid-cols-3 md:grid-cols-4">
- {records.map((record) => {
- const status = imageTo3dStatusMeta(record.status);
- return (
- <Link
- key={record.id}
- to={`/3d/${record.id}`}
- className="group overflow-hidden rounded-lg border border-port-border bg-port-card hover:border-port-accent"
- >
- <div className="relative aspect-square bg-port-bg">
- {record.sourceImage?.path && (
- <MediaImage
- src={record.sourceImage.path}
- alt={record.name || 'Source image'}
- className="h-full w-full object-cover opacity-90 group-hover:opacity-100"
- />
- )}
- {record.status === 'ready' && (
- <span className="port-media-overlay-strong absolute right-1.5 top-1.5 rounded p-1 text-port-success">
- <Boxes className="h-3.5 w-3.5" />
- </span>
- )}
- </div>
- <div className="p-2">
- <p className="truncate text-xs font-medium text-white" title={record.name}>{record.name || 'Untitled'}</p>
- <div className="mt-0.5 flex items-center justify-between gap-1">
- <span className={`text-[11px] ${status.className}`}>{status.label}</span>
- <span className="text-[11px] text-gray-500">{timeAgo(record.updatedAt)}</span>
+ {recordsLoading ? (
+ <p role="status" className="py-4 text-sm text-gray-400">Loading your 3D models…</p>
+ ) : recordsError ? (
+ <EmptyState
+ icon={AlertTriangle}
+ headingLevel={3}
+ title="Could not load your 3D models"
+ message="Retry to load your model collection."
+ actionLabel="Retry loading models"
+ onAction={loadRecords}
+ />
+ ) : records.length === 0 ? (
+ <div className="rounded-xl border border-port-border bg-port-card">
+ <EmptyState
+ icon={Boxes}
+ headingLevel={3}
+ title="No 3D models yet"
+ message="Your generated models will appear here. Select a source image above and click Generate 3D to create your first model."
+ actionLabel="Select a source image"
+ onAction={() => setPickerOpen(true)}
+ />
+ </div>
+ ) : (
+ <div className="grid grid-cols-2 gap-3 sm:grid-cols-3 md:grid-cols-4">
+ {records.map((record) => {
+ const status = imageTo3dStatusMeta(record.status);
+ return (
+ <Link
+ key={record.id}
+ to={`/3d/${record.id}`}
+ className="group overflow-hidden rounded-lg border border-port-border bg-port-card hover:border-port-accent"
+ >
+ <div className="relative aspect-square bg-port-bg">
+ {record.sourceImage?.path && (
+ <MediaImage
+ src={record.sourceImage.path}
+ alt={record.name || 'Source image'}
+ className="h-full w-full object-cover opacity-90 group-hover:opacity-100"
+ />
+ )}
+ {record.status === 'ready' && (
+ <span className="port-media-overlay-strong absolute right-1.5 top-1.5 rounded p-1 text-port-success">
+ <Boxes className="h-3.5 w-3.5" />
+ </span>
+ )}
</div>
- </div>
- </Link>
- );
- })}
- </div>
- </section>
- )}
+ <div className="p-2">
+ <p className="truncate text-xs font-medium text-white" title={record.name}>{record.name || 'Untitled'}</p>
+ <div className="mt-0.5 flex items-center justify-between gap-1">
+ <span className={`text-[11px] ${status.className}`}>{status.label}</span>
+ <span className="text-[11px] text-gray-500">{timeAgo(record.updatedAt)}</span>
+ </div>
+ </div>
+ </Link>
+ );
+ })}
+ </div>
+ )}
+ </section>
{/* Install/repair lives under Models → 3D — these are on-device runtimes, not
renders — so the generate flow just names the state and links there (#4728). */}
diff --git a/client/src/pages/Media3D.test.jsx b/client/src/pages/Media3D.test.jsx
index be88de9795..e2b6c2e1c6 100644
--- a/client/src/pages/Media3D.test.jsx
+++ b/client/src/pages/Media3D.test.jsx
@@ -301,6 +301,23 @@ describe('Media3D — generation workspace', () => {
expect(await screen.findByTestId('glb-viewer')).toHaveTextContent('/data/models3d/robot.glb');
});
+ it('distinguishes a pending or failed library from empty and lets users recover and select an image', async () => {
+ let rejectList;
+ listImageTo3dModels.mockReturnValueOnce(new Promise((resolve, reject) => { rejectList = reject; }));
+ renderAt();
+ expect(screen.getByText('Loading your 3D models…')).toBeInTheDocument();
+ expect(screen.queryByText('No 3D models yet')).not.toBeInTheDocument();
+ await act(async () => rejectList(new Error('offline')));
+ expect(await screen.findByText('Could not load your 3D models')).toBeInTheDocument();
+ expect(screen.queryByText('No 3D models yet')).not.toBeInTheDocument();
+
+ listImageTo3dModels.mockResolvedValueOnce([]);
+ fireEvent.click(screen.getByRole('button', { name: 'Retry loading models' }));
+ expect(await screen.findByText('No 3D models yet')).toBeInTheDocument();
+ fireEvent.click(screen.getByRole('button', { name: 'Select a source image' }));
+ expect(screen.getByRole('button', { name: 'Pick hero' })).toBeInTheDocument();
+ });
+
it('lists existing 3D records as deep links to their detail route', async () => {
listImageTo3dModels.mockResolvedValue([
{ id: 'image3d-abc', name: 'Example Beacon', status: 'ready', updatedAt: new Date(0).toISOString(), sourceImage: { path: '/data/images/beacon.png' } },
diff --git a/client/src/pages/Media3DDetail.jsx b/client/src/pages/Media3DDetail.jsx
index f3ab802c4b..c378951374 100644
--- a/client/src/pages/Media3DDetail.jsx
+++ b/client/src/pages/Media3DDetail.jsx
@@ -1,6 +1,6 @@
import { useCallback, useEffect, useRef, useState } from 'react';
import { Link, useNavigate, useParams } from 'react-router';
-import { ArrowLeft, Boxes, AlertTriangle, Loader2, RefreshCw, Trash2 } from 'lucide-react';
+import { ArrowLeft, Boxes, AlertTriangle, Loader2, RefreshCw, Trash2, ChevronDown } from 'lucide-react';
import { getImageTo3dModel, generateImageTo3dModel, deleteImageTo3dModel, imageTo3dAssetUrl, imageTo3dFullMeshUrl } from '../services/api';
import useMounted from '../hooks/useMounted';
import { useModelLifecycle } from '../hooks/useModelLifecycle';
@@ -207,30 +207,36 @@ export default function Media3DDetail() {
</p>
</header>
- <div className="mb-4 rounded-lg border border-port-border bg-port-card p-3">
- <ImageTo3dRenderOptions
- stepsSupported={record.supportsRenderOptions?.steps !== false}
- detailSupported={record.supportsRenderOptions?.detail !== false}
- alphaModeSupported={record.supportsRenderOptions?.alphaMode !== false}
- steps={steps}
- onStepsChange={setSteps}
- seed={seed}
- onSeedChange={setSeed}
- keyBackground={keyBackground}
- onKeyBackgroundChange={setKeyBackground}
- detail={detail}
- onDetailChange={setDetail}
- alphaMode={alphaMode}
- onAlphaModeChange={setAlphaMode}
- normalMapSupported={record.supportsRenderOptions?.normalMap !== false}
- normalMap={normalMap}
- onNormalMapChange={setNormalMap}
- subjectScale={subjectScale}
- onSubjectScaleChange={setSubjectScale}
- sourcePreviewUrl={record.sourceImage?.path || null}
- disabled={busy || isGenerating}
- />
- </div>
+ <details className="group mb-4 rounded-lg border border-port-border bg-port-card p-3">
+ <summary className="flex min-h-[44px] cursor-pointer list-none items-center justify-between text-sm font-medium text-gray-300">
+ Re-render options
+ <ChevronDown className="h-4 w-4 transition-transform group-open:rotate-180" aria-hidden="true" />
+ </summary>
+ <div className="mt-3">
+ <ImageTo3dRenderOptions
+ stepsSupported={record.supportsRenderOptions?.steps !== false}
+ detailSupported={record.supportsRenderOptions?.detail !== false}
+ alphaModeSupported={record.supportsRenderOptions?.alphaMode !== false}
+ steps={steps}
+ onStepsChange={setSteps}
+ seed={seed}
+ onSeedChange={setSeed}
+ keyBackground={keyBackground}
+ onKeyBackgroundChange={setKeyBackground}
+ detail={detail}
+ onDetailChange={setDetail}
+ alphaMode={alphaMode}
+ onAlphaModeChange={setAlphaMode}
+ normalMapSupported={record.supportsRenderOptions?.normalMap !== false}
+ normalMap={normalMap}
+ onNormalMapChange={setNormalMap}
+ subjectScale={subjectScale}
+ onSubjectScaleChange={setSubjectScale}
+ sourcePreviewUrl={record.sourceImage?.path || null}
+ disabled={busy || isGenerating}
+ />
+ </div>
+ </details>
{confirmingDelete && (
<InlineConfirmRow