CLI: frontend
Complete help for farthershore frontend and every subcommand.
farthershore frontend
Usage: farthershore frontend [options] [command]
Managed Frontend Hosting: status/rollback/local preview (deploys are
Git-triggered)
Options:
-h, --help display help for command
Commands:
status [options] [businessIdOrSlug] Show the current frontend release, recent releases, and recent builds (incl. failure reasons)
rollback [options] [businessIdOrSlug] Roll the business frontend back to a prior release (re-activate its releaseId)
dev [options] Run the frontend's HOT-RELOADING `vite` dev server with an injected window.__FS_CONFIG__ shim (mock mode by default) — for active editing.
preview [options] Build the frontend and serve the BUSINESSION bundle via `vite preview` with the same shim (mock mode by default) — final as-shipped inspection.
help [command] display help for command
farthershore frontend status
Usage: farthershore frontend status [options] [businessIdOrSlug]
Show the current frontend release, recent releases, and recent builds (incl.
failure reasons)
Options:
--env <environment> Scope to a preview environment name or id (omit for
production).
--wait Wait for a build that appears after this command starts;
exit non-zero if it fails. Pair with --ref after a Git
push or release for exact source proof.
--ref <commitSha> Match builds for this immutable Git commit SHA; use with
--wait to observe the latest known build for that source
revision.
--timeout <seconds> How long --wait waits before giving up (default 600).
-h, --help display help for command
farthershore frontend rollback
Usage: farthershore frontend rollback [options] [businessIdOrSlug]
Roll the business frontend back to a prior release (re-activate its releaseId)
Options:
--release-id <releaseId> The prior release id (manifest hash) to re-activate
— see `frontend status`.
--env <environment> Scope to a preview environment name or id (omit for
production).
--dry-run Preview the change without applying it.
-h, --help display help for command
farthershore frontend dev
Usage: farthershore frontend dev [options]
Run the frontend's HOT-RELOADING `vite` dev server with an injected
window.__FS_CONFIG__ shim (mock mode by default) — for active editing.
Options:
--dir <path> Frontend project directory (default:
./frontend)
--mock Force mock mode (this is already the
default when no Core/Clerk config is given)
--live Preview against the real platform
(production Core URL) instead of mock mode
--business <id-or-slug> Business for a local persona preview
--env <id-or-name> Test environment for a local persona
preview
--persona <id-or-name> Existing test persona for a local live
preview
--core-url <url> Platform Core base URL to shim (default:
VITE_FS_CORE_URL)
--clerk-publishable-key <key> Clerk publishable key for clerk-strategy
envs (default: VITE_CLERK_PUBLISHABLE_KEY)
--clerk-sign-in-url <url> Clerk hosted sign-in URL (default:
VITE_CLERK_SIGN_IN_URL)
--clerk-satellite-domain <domain> Clerk satellite domain (default:
VITE_CLERK_SATELLITE_DOMAIN)
--port <port> Public local proxy port (Vite uses a
private random loopback port for persona
previews)
-h, --help display help for command
Examples:
farthershore frontend dev # HOT-RELOADING dev server, mock mode (default)
farthershore frontend preview # production build served as-is, mock mode
farthershore frontend dev --live # against the real production platform
farthershore frontend dev --live --business acme --env preview --persona persona_123
farthershore frontend dev --core-url http://localhost:8787
farthershore frontend dev --dir ./frontend --port 4321
Mock mode (the default with no Core/Clerk config):
Injects { mock: true } — every page renders with placeholder data and
bypassed auth for local inspection. Point at a real platform with
--live, --core-url, or VITE_FS_CORE_URL.
farthershore frontend preview
Usage: farthershore frontend preview [options]
Build the frontend and serve the BUSINESSION bundle via `vite preview` with the
same shim (mock mode by default) — final as-shipped inspection.
Options:
--dir <path> Frontend project directory (default:
./frontend)
--mock Force mock mode (this is already the
default when no Core/Clerk config is given)
--live Preview against the real platform
(production Core URL) instead of mock mode
--business <id-or-slug> Business for a local persona preview
--env <id-or-name> Test environment for a local persona
preview
--persona <id-or-name> Existing test persona for a local live
preview
--core-url <url> Platform Core base URL to shim (default:
VITE_FS_CORE_URL)
--clerk-publishable-key <key> Clerk publishable key for clerk-strategy
envs (default: VITE_CLERK_PUBLISHABLE_KEY)
--clerk-sign-in-url <url> Clerk hosted sign-in URL (default:
VITE_CLERK_SIGN_IN_URL)
--clerk-satellite-domain <domain> Clerk satellite domain (default:
VITE_CLERK_SATELLITE_DOMAIN)
--port <port> Public local proxy port (Vite uses a
private random loopback port for persona
previews)
-h, --help display help for command
Examples:
farthershore frontend dev # HOT-RELOADING dev server, mock mode (default)
farthershore frontend preview # production build served as-is, mock mode
farthershore frontend preview --live # against the real production platform
farthershore frontend preview --live --business acme --env preview --persona persona_123
farthershore frontend preview --core-url http://localhost:8787
farthershore frontend preview --dir ./frontend --port 4321
Mock mode (the default with no Core/Clerk config):
Injects { mock: true } — every page renders with placeholder data and
bypassed auth for local inspection. Point at a real platform with
--live, --core-url, or VITE_FS_CORE_URL.