Skip to main content
Preview and validation are local operations. They do not push or activate a Portal Definition.

​
Start the supported preview

This runs fluid portal dev, normally at http://localhost:5173. When portal/definition.json is missing, the command pulls the linked working definition before it starts. Use -- --skip-pull only when the missing local definition is intentional. Use the Fluid command so the preview matches the supported project configuration.

​
Understand preview limits

  • Malformed JSON can be skipped instead of rendered.
  • An unresolved navigation entry can remain visible without a working target.
  • The default profile, or the first profile, controls local profile selection.
  • Localhost does not receive production member authentication. Authenticated screens can return HTTP 401 even when local JSON renders correctly.

​
Run local checks

fluid portal doctor reports scaffold drift. JSON Schema validation and the build catch different classes of problems, so do not use either as a substitute for visual review.

​
Review the portal

Check:
  • every changed screen route;
  • navigation order and targets;
  • the intended profile and theme;
  • empty and malformed widget inputs;
  • keyboard focus and accessible names;
  • narrow and wide layouts;
  • all supported color modes.
Only push after the local files, checks, and diff match the intended working definition.