Architecture: How should Live Preview handle empty universes (no modules)?

Documentation for Sessions

🏗️ Architecture: How should Live Preview handle empty universes (no modules)?

📋 Decision Context

Question:

How should Live Preview handle empty universes (no modules)?

Task: Not specified

🎯 Decision Made

Chosen:

Show clean empty state with guidance instead of misleading Editor Helper UI

Options Considered:

Show fake Editor Helper UI for navigation
Show clean empty state with guidance (chosen)
Show nothing at all (too stark)
Always show Editor Helper regardless of modules

💭 Reasoning

The Editor Helper UI (fake header, sidebar, breadcrumbs, Dashboard page) was confusing users by making it look like there was content when the universe was empty. The RuntimePreviewComponent now checks hasAnyModules() and shows a clean empty state directing users to the Structure tab. The Editor Helper only shows when modules exist but aren't placed in zones.

📁 Files Involved

libs/libs-space/universe-canvas/src/lib/components/runtime-preview/runtime-preview.component.ts
libs/libs-space/universe-canvas/src/lib/components/runtime-preview/runtime-preview.component.scss

🔗 Related

Decision ID: dev_1768492564246_vn1wpdq
Session: 45
Workspace: editor2

Auto-generated by MCP Smart Consolidation