Guides · 02

Deploy your first app.

One command takes your project from your laptop to the global edge.

Authenticate

bash

nimbus login

Opens a browser tab. Approve the login and the CLI stores a scoped token under ~/.nimbus/credentials.

Make sure your working tree is clean — the CLI prints a warning otherwise.
Run nimbus deploy from the project root.
Wait a few seconds. You'll get a unique preview URL plus an alias for the production environment.

bash

nimbus deploy --env production

Preview every commit

Connect a Git provider in the dashboard and every push gets its own URL — great for sharing work before promoting it to production.

my-app/
├── src/
├── public/
├── nimbus.config.ts
└── package.json     ← lockfile is also uploaded