Skip to main content
pxxl deploy lets you ship a local project to Pxxl without pushing to GitHub first. It is SpaceDrop-first: the CLI reads pxxl.toml, applies .pxxlignore, creates a deterministic temporary ZIP of your working directory, uploads it as a private source asset, and queues a normal Pxxl deployment — the same build pipeline that runs for GitHub-imported projects. This is the fastest path for solo deploys, throwaway demos, CI jobs that build artifacts locally, and any workflow where you do not want every commit to trigger a deploy.
pxxl init --new vite-react-pxxl --name my-app --domain pxxl.pro
pxxl deploy

pxxl.toml

name = "my-app"
domainChoice = "pxxl.pro"
environment = "production"
deployEnvironment = "prod"
port = 3000
framework = "vite"
buildCommand = "npm run build"
startCommand = "npm run preview -- --host 0.0.0.0"
Supported deploy metadata includes project name, domain/TLD choice, environment, deploy environment, port, language, framework, install command, build command, start command, base directory, and entry file.

Authentication

Use an API key with scope=all or scope=deploy and permission=read_write.
pxxl login --api-key pxxl_...
pxxl deploy --name my-app --domain pxxl.pro
Dashboard JWT deploys still work from the web app. The CLI path uses API-key auth without exposing storage provider details.