// documentation
Snapfini Docs
Deploy from your terminal in under 60 seconds.
01 — Quick Start
Install the CLI, login once, then deploy any project with a single command.
# Install globally
npm install -g snapfini
# Authenticate (opens browser to get your token)
snapfini login
# Deploy the current directory
cd my-project/
snapfini deploy
# → Building...
# → ✓ Deployed! https://abc123.snapfini.com02 — CLI Reference
snapfini loginAuthenticate via browser or --token flagsnapfini login --token <token>Skip browser — paste your token directlysnapfini deployZip & deploy current directorysnapfini deploy --dbDeploy + provision a PostgreSQL databasesnapfini deploy --name my-appDeploy with a custom subdomainsnapfini deploy --env .envUpload env vars from a .env filesnapfini listShow all active deploymentssnapfini logs <app-id>Stream live container logssnapfini env list <app-id>List environment variablessnapfini env set <app-id> KEY=VSet an environment variablesnapfini delete <app-id>Delete a deployment (with confirmation)snapfini open <app-id>Open deployment URL in browsersnapfini statusShow account plan and deployment count03 — VS Code Extension
Deploy without leaving your editor. The Snapfini extension adds a sidebar panel with all your deployments.
Install
Download the .vsix file from the Snapfini dashboard and install it:
code --install-extension snapfini-1.0.0.vsixUsage
- → Click the Snapfini icon in the Activity Bar
- → Run Snapfini: Login from the Command Palette (Ctrl+Shift+P)
- → Run Snapfini: Deploy Project or press Ctrl+Shift+D
- → Right-click any deployment to Open, Logs, or Delete
04 — API Tokens
The CLI and VS Code extension authenticate using API tokens — not your password.
- Go to Dashboard → API Tokens
- Click Generate and copy the token immediately
- Run
snapfini login --token snpf_live_xxx
Tokens are stored in ~/.snapfini/config.json. Never commit this file.
05 — Environment Variables
Set env vars at deploy time or update them live (app restarts automatically).
# Upload a .env file at deploy time
snapfini deploy --env .env.production
# Set individual vars after deploy
snapfini env set abc123 DATABASE_URL=postgres://... PORT=3000
# List current vars
snapfini env list abc123DATABASE_URL is injected automatically when you use --db.
06 — Custom Domains
Every deployment gets a free *.snapfini.com subdomain. You can also point your own domain.
- Add a CNAME record pointing to
snapfini.com - In the Dashboard, open your app → click Custom Domain
- Enter your domain — SSL is provisioned automatically
07 — PostgreSQL
One flag provisions a dedicated Postgres 15 database for your app.
snapfini deploy --db- → DATABASE_URL is injected as an env var automatically
- → 512 MB storage on the free plan
- → Backups run every 24h and are stored for 7 days