Skip to content
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension


Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
25 changes: 25 additions & 0 deletions docs/superpowers/specs/2026-11-18-generation-logo-loader-design.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,25 @@
# Generate: playful logo loader while a mesh is generated

## Intent

While a mesh generates, the Generate viewer shows nothing but the small progress card. Showing the real mesh as it forms is not possible (generators work in latent space; the mesh exists only after the final decode, and extensions are black boxes). Instead, the maintainer wants an animated, playful Modly logo the user can play with while waiting.

## Approaches

- **A. Logo assembles with the progress.** Ties the animation to the %, but the maintainer preferred a free loop.
- **B. Decorative loop with hover and click (picked).** Slow rotation; hover highlights a piece; click detaches it, it floats away, then returns.

## Design

- An overlay over the Generate viewer, shown only while `currentJob.status` is `uploading` or `generating`. The scene behind is dimmed; `GenerationHUD` stays on top at the bottom. The overlay captures the pointer (no orbiting the scene meanwhile).
- Its own `@react-three/fiber` canvas, transparent background. The three pieces are the three paths of `src/shared/components/ui/ModlyLogo.tsx`, parsed (e.g. three's `SVGLoader`), centered, extruded thin.
- Look: violet wireframe with a visible triangulated mesh and small vertex dots, a soft glow, as in the reference image (dark background, `#c084fc` to `#9333ea` palette).
- Idle: the logo rotates slowly around the vertical axis.
- Hover: the hovered piece lights up (brighter violet fill and edges), cursor becomes a pointer.
- Click: the piece moves outward from the logo center (with a slight tilt) and leaves a short trail of particles, holds briefly, then returns and snaps back; total about 1.5 s. Clicks during its flight are ignored for that piece.
- End: the overlay fades out when the job leaves `uploading`/`generating`.
- `prefers-reduced-motion`: no rotation, no float-away; hover highlight stays.

## Left to the builder

Exact geometry (extrude depth, how the face is triangulated for the wireframe look), easing curves, glow technique (postprocessing bloom or additive materials), file layout under `src/areas/generate/components/`.
2 changes: 1 addition & 1 deletion package.json
Original file line number Diff line number Diff line change
Expand Up @@ -13,7 +13,7 @@
"prepare-resources": "node scripts/download-python-embed.js",
"test": "npm run test:py && npm run test:node",
"test:py": "node scripts/run-pytests.mjs",
"test:node": "node --test --experimental-strip-types --experimental-loader ./scripts/node-ts-extensionless-loader.mjs src/shared/types/assetLibrary.test.ts src/areas/generate/assetLibraryProjection.test.ts src/areas/generate/assetLibraryService.test.ts src/areas/generate/assetLibraryUi.test.ts src/areas/library/libraryView.test.ts src/areas/library/gridWindow.test.ts src/areas/generate/orcaSlicerLink.test.ts src/shared/utils/agentStream.test.ts src/shared/thumbnails/assetThumbnailQueue.test.ts src/shared/thumbnails/assetThumbnailStore.test.ts src/shared/components/agent/clientTools.test.ts src/shared/components/agent/agentContext.test.ts src/shared/utils/ollamaHealth.test.ts src/shared/utils/notification.test.ts src/shared/utils/agentConversations.test.ts electron/main/artifact-registry-service.test.ts electron/main/asset-thumbnail-cache.test.ts electron/main/extension-path-guard.test.ts electron/main/storage-directory-guard.test.ts electron/main/storage-ownership.test.ts electron/main/startup-error.test.ts electron/main/api-port.test.ts electron/main/api-guard.test.ts electron/main/agent-conversations.test.ts electron/main/gpu-memory.test.ts electron/preload/artifact-registry-preload.test.ts src/shared/stores/meshHistory.test.ts src/areas/generate/meshEditPanel.test.ts src/areas/generate/sculpt/SculptMesh.test.ts src/areas/generate/sculpt/SculptMesh.perf.test.ts src/areas/generate/sculpt/sculptLogic.test.ts src/shared/pages/pageRegistry.test.ts src/shared/pages/startPage.test.ts src/areas/home/recents.test.ts src/areas/workflows/workflowRunRecord.test.ts src/areas/queue/queueModel.test.ts electron/main/workspace-images.test.ts src/areas/image-studio/imageStudioStore.test.ts src/areas/image-studio/imageOps.test.ts src/areas/image-studio/cropGeometry.test.ts src/shared/utils/imageInput.test.ts src/areas/print/printBed.test.ts src/shared/three/viewScale.test.ts src/areas/workflows/nodes/mesh-exporter/obj.test.ts && node --test electron/main/*.test.mjs src/**/*.test.mjs",
"test:node": "node --test --experimental-strip-types --experimental-loader ./scripts/node-ts-extensionless-loader.mjs src/shared/types/assetLibrary.test.ts src/areas/generate/assetLibraryProjection.test.ts src/areas/generate/assetLibraryService.test.ts src/areas/generate/assetLibraryUi.test.ts src/areas/library/libraryView.test.ts src/areas/library/gridWindow.test.ts src/areas/generate/orcaSlicerLink.test.ts src/shared/utils/agentStream.test.ts src/shared/thumbnails/assetThumbnailQueue.test.ts src/shared/thumbnails/assetThumbnailStore.test.ts src/shared/components/agent/clientTools.test.ts src/shared/components/agent/agentContext.test.ts src/shared/utils/ollamaHealth.test.ts src/shared/utils/notification.test.ts src/shared/utils/agentConversations.test.ts electron/main/artifact-registry-service.test.ts electron/main/asset-thumbnail-cache.test.ts electron/main/extension-path-guard.test.ts electron/main/storage-directory-guard.test.ts electron/main/storage-ownership.test.ts electron/main/startup-error.test.ts electron/main/api-port.test.ts electron/main/api-guard.test.ts electron/main/agent-conversations.test.ts electron/main/gpu-memory.test.ts electron/preload/artifact-registry-preload.test.ts src/shared/stores/meshHistory.test.ts src/areas/generate/meshEditPanel.test.ts src/areas/generate/sculpt/SculptMesh.test.ts src/areas/generate/sculpt/SculptMesh.perf.test.ts src/areas/generate/sculpt/sculptLogic.test.ts src/shared/pages/pageRegistry.test.ts src/shared/pages/startPage.test.ts src/areas/home/recents.test.ts src/areas/workflows/workflowRunRecord.test.ts src/areas/queue/queueModel.test.ts electron/main/workspace-images.test.ts src/areas/image-studio/imageStudioStore.test.ts src/areas/image-studio/imageOps.test.ts src/areas/image-studio/cropGeometry.test.ts src/areas/generate/components/logoLoaderGeometry.test.ts src/areas/generate/components/logoLoaderMotion.test.ts src/shared/utils/imageInput.test.ts src/areas/print/printBed.test.ts src/shared/three/viewScale.test.ts src/areas/workflows/nodes/mesh-exporter/obj.test.ts && node --test electron/main/*.test.mjs src/**/*.test.mjs",
"package": "cross-env CSC_IDENTITY_AUTO_DISCOVERY=false npm run build && npm run prepare-resources && electron-builder",
"package:mac": "cross-env CSC_IDENTITY_AUTO_DISCOVERY=false npm run build && npm run prepare-resources && electron-builder --mac --arm64",
"lint": "eslint ."
Expand Down
2 changes: 2 additions & 0 deletions src/areas/generate/GeneratePage.tsx
Original file line number Diff line number Diff line change
Expand Up @@ -7,6 +7,7 @@ import { redoDepth, undoDepth } from '@shared/stores/meshHistory'
import { useApi } from '@shared/hooks/useApi'
import { ColorPicker } from '@shared/components/ui'
import GenerationHUD from './components/GenerationHUD'
import GenerationLogoLoader from './components/GenerationLogoLoader'
import Viewer3D from './components/Viewer3D'
import WorkflowPanel from './components/WorkflowPanel'
import EditPanel from './components/EditPanel'
Expand Down Expand Up @@ -1359,6 +1360,7 @@ export default function GeneratePage(): JSX.Element {
onSelectPointLight={handleSelectPointLight}
onPointLightsChange={setPointLights}
/>
<GenerationLogoLoader />
<GenerationHUD />
</div>
{editPanelOpen && <EditPanel onClose={() => { void closeEditPanel() }} />}
Expand Down
Loading
Loading