Skip to main content

Overview

The Micropage CLI is a Node.js tool for creating projects, editing .page files locally, syncing with the cloud, and publishing to Cloudflare Pages.

Install: see CLI setup.

Run micropage --help or micropage <command> --help for the latest flags in your installed version.

Requirements

Commands that touch a project expect you to run them from a local project directory that contains a .micropage folder (created by micropage projects create or micropage projects fetch).

Relationship to the web app

The CLI and web app use the same projects and builds. You can mix both—for example, edit in the browser and run micropage projects pull locally, or push from the CLI and review form submissions in the app.

Command groups

TopicDescription
Authenticationlogin, logout, whoami
ProjectsList, show, create, fetch, pull, delete
Builds & publishDrafts, publish, build history, download
FilesList uploaded files and get URLs
SubmissionsList, show, and export form data
LinksOpen live site, copy URL, pricing page

Command reference

CommandDescription
micropage loginAuthenticate via the browser
micropage logoutClear the stored session
micropage whoamiShow the logged-in user and subscription
micropage projects listList your projects
micropage projects show [idOrDomain]Show project details and latest build
micropage projects create <name>Create a project and init local folder
micropage projects fetch <idOrDomain>Fetch an existing project, init locally
micropage projects pullPull latest build content → local landing.page
micropage projects deleteDelete project (remote + local .micropage/)
micropage builds listList builds for the current project
micropage builds redeploy [version]Set active build and republish
micropage builds download [version]Download a build archive (zip)
micropage pushMerge local .page files into a draft build
micropage publishPush local content and deploy
micropage previewOpen the live site in the browser
micropage copy-linkCopy the live URL to the clipboard
micropage open-pricingOpen the pricing page in the browser
micropage files listList uploaded project files
micropage files url <filename>Get the URL for an uploaded file
micropage submissions listList form submissions
micropage submissions show <id>Show one submission in detail
micropage submissions exportExport submissions to CSV or JSON