Start Screen & Workspace Hub

Last changes: Documentation changelog

The Control Room Start Screen (apps/control-room/src/modules/start/StartScreen.tsx) is the non-blocking workspace hub served at /home. When an active session is already loaded in the same Control Room instance, opening Home overlays the workspace rather than closing or halting the running session, so switching back to the active session tab restores the live workspace immediately.

Control Room Start Screen overview with navigation rail, launch tiles, active simulations, and compute environment widget

Model Templates and Script Creation

Selecting a card in the Templates section previews the template summary, estimated grid/mesh characteristics, and generated Python source in TemplateDetails (apps/control-room/src/modules/start/inspector/TemplateDetails.tsx). Users can export or save the .py script cleanly, or run the template script to create and activate a live workspace project via createAndActivateScriptProject.

Control Room Start Screen Templates section showing benchmark presets and script inspection pane

Continue, Active Simulations, Recent Work & Multi-Instance Discovery

Below the launch tiles, StartScreen surfaces four live operational panels:

  1. Interrupted checkpoint recovery (ContinueCard): Checks the active checkpoint index against current build capabilities. When resumable, displays simulation time progress and offers one-click resume (study.restore-checkpoint) or two-step confirmed discard (study.discard-checkpoint); when incompatible or unopened, withholds broken actions and explains why.

  2. Active simulations (ActiveSessions): Lists open sessions in the current instance—including external sessions created by Python scripts—with live lifecycle badges (running, awaiting_command, waiting_for_compute, completed, failed, closed) and a primary Open simulation button (fm-start-continue) for the current session.

  3. Recent projects, scripts, and saved results (RecentProjects): Displays recently opened .fms / workspace projects, tracked .py scripts (with run-script execution and text preview in ScriptInspector), and materialized SolutionSet results (ResultInspector) with side-by-side detail inspection in ProjectInspector.

  4. Other instances on this computer (OtherInstances): Queries host instance discovery (useInstanceDiscovery) and lists sibling FullMag instances (such as concurrent Docker DEV groups or local ports) with their active session status, port badge, and an Open in tab button (tabRoutes /instance/<port> or ?port=<port>).

Start Screen active simulations, recent projects and scripts, and sibling Control Room instances on the host

Connecting from Live Python (fm.connect)

Sessions initiated from Python via fullmag.live appear automatically inside Active simulations and in the top session tab strip without requiring a manual page reload. A connected Python script attaches with a unique python-<hex> client ID and maintains a periodic heartbeat (/v2/sessions/current/clients/{client_id}) while streaming scene transactions, stage launches, and field queries:

>>> import fullmag as fm
>>> session = fm.connect()
>>> # The attached session appears live in Start Screen -> Active simulations
Control Room reflecting an active session driven by a connected Python live script

Screenshots illustrate the interface; they are not runtime or physics qualification evidence.

Control Room crosswalk

  • Primary workspace route: /home (InstanceTabStrip Home tab, or workspace.home from the menu bar).

  • Primary components: StartScreen, StartRail, LaunchTiles, ContinueCard, ActiveSessions, RecentProjects, OtherInstances, TemplateDetails, ScriptInspector, and ProjectInspector.

  • Unsupported desktop actions: Desktop-only actions such as native OS file-picker Open script… or script launch from the browser fall back gracefully with an explicit disabled reason when no desktop script host is bound (scriptRunHost.ts).

Python/API crosswalk

  • Interactive session attachment uses fm.connect(...) implemented by LiveSession (packages/fullmag-py/src/fullmag/live/_session.py).

  • Start-screen template exports emit canonical fullmag study-and-stage Python scripts compatible with headless execution.

Physics and bibliography scope

This page describes UI session launch, discovery, and navigation only; it introduces no independent physical equations or discretization semantics.

Source-code index

Responsibility

Repository path

Stable symbol

Start screen shell & workspace integration

apps/control-room/src/modules/start/StartScreen.tsx

StartScreen

Left navigation rail & shortcuts

apps/control-room/src/modules/start/rail/StartRail.tsx

StartRail, RAIL_SECTIONS

Problem/template/import launch tiles

apps/control-room/src/modules/start/home/LaunchTiles.tsx

LaunchTiles, LAUNCH_TILES

Checkpoint recovery card

apps/control-room/src/modules/start/home/ContinueCard.tsx

ContinueCard

Open sessions in current instance

apps/control-room/src/modules/start/home/ActiveSessions.tsx

ActiveSessions

Sibling instance discovery list

apps/control-room/src/modules/start/home/OtherInstances.tsx

OtherInstances

Template script preview & project creation

apps/control-room/src/modules/start/inspector/TemplateDetails.tsx

TemplateDetails

Tab routing & ?port= resolution

apps/control-room/src/kernel/layout/tabRoutes.ts

parseTabRoute, formatTabRoute