Authentication fails
Confirm the Fluid CLI login or API token and the selected environment. Correct the credentials, then rerun only the failed remote command.Pull selects the wrong definition
Use the definition ID to avoid duplicate-name ambiguity:--force unless overwriting local changes is intentional.
Preview omits a resource
Check the terminal for malformed JSON. Validate the file against its$schema, then restart the preview. An unresolved navigation entry can remain visible without loading its target screen.
Authenticated screens return 401 locally
Localhost does not receive production member authentication. Confirm the Portal Definition with public or non-authenticated routes locally, then test authenticated behavior in the appropriate hosted environment.Push rejects a reference
Compare every referenced slug with its resource file name. Fix missing screens, navigations, profiles, or themes and validate again.Push stops after some changes
Push can partially succeed. Read the command result, inspect remote state, correct the reported resource, and rerun. Do not assume earlier changes rolled back.Remote state changed during local work
Preserve local edits, pull current state, reapply the intended change, and review the new diff. Do not hand-edit.portal-sync/.