uc-apx delete page
Delete the .apx file backing the named page. The ref-safety scan covers both @-style references (other constructs pointing at @alias targets on this page) AND bare-int page-number references (branches, breadcrumb entries, button redirects, the app’s homePage attribute, …). When any referrer is found the command blocks; —force overrides.
The int-page allowlist (page, targetPage, dialogTargetPage,
homePage, errorPage, sessionExpiredPage, pageNumber) is
deliberately finite — always re-run validate --official after a page
delete to catch anything outside the allowlist that broke.
uc-apx delete page <id-or-alias-or-name> [flags]| Flag | Type | Default | Description |
|---|---|---|---|
--dry-run | Show what would be deleted (file path + referrers) without removing anything | ||
--force | Remove the file even when other constructs reference the page (lists referrers as a warning) |
Global Flags
Section titled “Global Flags”| Flag | Type | Default | Description |
|---|---|---|---|
--app-dir | string | . | Path to the APEX application directory |
--json-pretty | Output in pretty-printed JSON (human-readable) instead of minified JSON | ||
--toon | Output in TOON format (human-readable, token-efficient) instead of JSON |