Getting Started

Quickstart

Get a full-stack app live in under two minutes. No config files, no Docker, no cloud console.

1 — Authenticate

$ pillar auth YOUR_API_KEY

2 — Deploy

$ pillar deploy my-app

Pillar will detect your frontend and backend frameworks, ask you to confirm, and return a live HTTPS URL.

Installation

Install the CLI

Download the binary for your platform and move it onto your PATH.

macOS (Apple Silicon)

curl -L https://github.com/omanaokar/pillar-releases/releases/download/v0.1.0/pillar-darwin-arm64 -o pillar chmod +x pillar && sudo mv pillar /usr/local/bin/

macOS (Intel)

curl -L https://github.com/omanaokar/pillar-releases/releases/download/v0.1.0/pillar-darwin-amd64 -o pillar chmod +x pillar && sudo mv pillar /usr/local/bin/

Linux (x86_64)

curl -L https://github.com/omanaokar/pillar-releases/releases/download/v0.1.0/pillar-linux-amd64 -o pillar chmod +x pillar && sudo mv pillar /usr/local/bin/
Commands

CLI Reference

Every command Pillar exposes, with flags and examples.

pillar deployCORE

Deploy a full-stack app from your local directory.

Usage

pillar deploy <app-name> [flags]

Flags

--frontend <path>Path to frontend directory (default: auto-detect)
--backend <path>Path to backend directory (default: auto-detect)
--env <file>Env file to inject (default: .env)
--region <region>Deployment region: us-east-1 | eu-west-1 (default: us-east-1)

Example

$ pillar deploy my-app ✔ Detected frontend: React + Vite (./frontend) ✔ Detected backend: Node + Express (./backend) frontend env → none backend env → .env (3 vars) Deploy "my-app" to us-east-1? [Y/n] y ⠙ Building frontend… ⠙ Building backend… ⠙ Provisioning edge network… ✔ Live at https://my-app.getpillar.dev (42s)
pillar listCORE

List all of your active deployments.

Usage

pillar list

Example

$ pillar list NAME REGION STATUS AGE my-app us-east-1 live 3d staging-api eu-west-1 live 1h old-demo us-east-1 stopped 12d
pillar infoCORE

Show details about a specific deployment.

Usage

pillar info <app-name>

Example

$ pillar info my-app App: my-app URL: https://my-app.getpillar.dev Region: us-east-1 Status: live Deployed: 3 days ago Frontend: React + Vite Backend: Node + Express Env vars: 3
pillar logsCORE

Stream live logs from a running deployment.

Usage

pillar logs <app-name> [flags]

Flags

--tail <n>Number of historical lines to show (default: 50)
--followKeep streaming (default: true)
--service <frontend|backend>Filter to one service

Example

$ pillar logs my-app [backend] GET /api/tasks 200 4ms [backend] POST /api/tasks 201 12ms [frontend] Serving asset /assets/index-Dv3k2.js 200 [backend] GET /health 200 1ms ^C
pillar deleteDESTRUCTIVE

Permanently delete a deployment and free its resources.

Usage

pillar delete <app-name>

Flags

--forceSkip confirmation prompt

Example

$ pillar delete old-demo Delete "old-demo"? This cannot be undone. [y/N] y ✔ Deleted old-demo
pillar authAUTH

Save your API key locally so every command is authenticated.

Usage

pillar auth <api-key>

Example

$ pillar auth pk_live_xxxxxxxxxxxx ✔ Authenticated. Key stored in ~/.pillar $ pillar whoami panaokar@gmail.com

Your key is stored in ~/.pillar on disk.

You can also set PILLAR_API_KEY as an environment variable — it takes precedence over the stored key.

Run pillar whoami to confirm which account you're authenticated as.

Reference

Supported Frameworks

Pillar auto-detects these frameworks. No config required.

Frontend

React + Vite
Vue + Vite
Svelte + Vite
Next.js
Nuxt
SvelteKit
Astro
Vanilla HTML

Backend

Node + Express
Node + Fastify
Bun + Hono
Python + Flask
Python + FastAPI
Go + net/http
Go + Gin

Environment Variables

Pillar injects your .env file into the deployed service at build time. Variables are encrypted at rest and never logged.

You can also set PILLAR_API_KEY in your shell environment to authenticate without running pillar auth. This is useful for CI pipelines.

# CI / GitHub Actions example - name: Deploy env: PILLAR_API_KEY: ${{ secrets.PILLAR_API_KEY }} run: | pillar deploy my-app --force

Regions

Choose the region closest to your users with the --region flag.

us-east-1US East (N. Virginia)
Available
eu-west-1EU West (Ireland)
Available
ap-southeast-1Asia Pacific (Singapore)
Coming soon