CLI Reference

Use npx ship-em or the installed shipem binary.

Deploy

shipem deploy / npx ship-em

Default command. Detects the app, builds it, and deploys it.

Flags: --yes, --name <name>, --skip-build, --turbo, --package <name>, --direct, --verbose, --json, --notify [url], --quiet

shipem preview

Deploy a preview URL from the current git branch.

Flags: --skip-build, --verbose

shipem watch

Watch for file changes and auto-deploy.

shipem dev

Start a dev server with a deploy shortcut.

Inspect and manage deployments

shipem status

Check deployment status for the current project.

Flags: --json

shipem logs

View recent deployment logs for the current project.

Flags: --lines <number>, --json

shipem down

Take the current deployment offline.

Flags: --yes

shipem history

Show deploy history across all projects.

shipem monitor / shipem monitor stop

Monitor deployed sites for uptime or stop the monitor daemon.

Flags: --interval <minutes>, --daemon

Auth and setup

shipem login

Log in to Shipem with GitHub.

shipem logout

Log out of Shipem.

shipem config [action] [key] [value]

Manage global Shipem settings.

shipem hooks [action]

Manage git deploy hooks.

Project creation and repair

shipem init

Bootstrap a new project from an interactive description flow or a template.

Flags: --yes, --template <name>

shipem templates

List available templates for shipem init --template.

shipem fix

Auto-fix common build errors.

Flags: --verbose

shipem env

Scan the current project for environment variables and report which ones are set.

Domains

shipem domains add <domain>

Attach a custom domain to the current project.

shipem domains list

List custom domains for the current project.

shipem domains remove <domain>

Remove a custom domain from the current project.