Projects
All micropage projects commands work from any directory unless they need an existing local project (see below).
list
List projects in your account.
micropage projects list
| Option | Description |
|---|---|
--json | Print JSON instead of a table |
show
Show details for one project, including latest build info.
micropage projects show
micropage projects show my-project-abc123
| Option | Description |
|---|---|
--json | Print JSON |
The optional argument is a project id or domain slug. If omitted, the CLI uses the current local project.
create
Create a new project on the server and initialize the current directory as a local project.
micropage projects create mysite
| Option | Description |
|---|---|
-d, --domain <domain> | Choose the project's slug, which sets its address <domain>.micropage.sh: lowercase letters, digits, and hyphens, max 58 characters, no leading or trailing hyphen (default: server-generated name + 6 hex chars) |
fetch
Download an existing project by id or domain and set up the local folder.
micropage projects fetch my-project-abc123
pull
Pull the latest published build’s raw content into the local landing.page file.
micropage projects pull
Requires a local project.
delete
Delete the project on the server and remove local .micropage/ configuration.
micropage projects delete
| Option | Description |
|---|---|
-y, --yes | Skip the confirmation prompt |
Requires a local project.
deploy
Publish using a deploy token (Pro+).
The first argument is the project UUID (or legacy numeric id). Without --build, the CLI reads .page files in the current directory, creates a build, and publishes it.
# Standard CI: create build from .page files and publish
micropage projects deploy "$MICROPAGE_PROJECT_UUID" "$MICROPAGE_DEPLOY_TOKEN" --watch
# Publish a specific existing build by id
micropage projects deploy "$MICROPAGE_PROJECT_UUID" "$MICROPAGE_DEPLOY_TOKEN" --build 987
| Option | Description |
|---|---|
-b, --build <id> | Publish a specific existing build id. Omit to create a new build from .page files in the current directory. |
-w, --watch | Stream build/deploy progress until finished or failed |
See CI/CD and the GitHub Actions post.
Local project
Commands such as show (without arguments), pull, and delete use the project linked in .micropage/ in the current working directory. Create or fetch a project first—see CLI setup.