Developer quickstart

This path creates a small app and sends one exact source-and-preview pair to review. It does not run your source in Niblet Cloud.

Install the Niblet CLI

curl -fsSL https://raw.githubusercontent.com/commacollectivehq/niblet-pixlet/main/scripts/install.sh | sh

The release installer supports macOS and Linux and verifies the archive against the published SHA-256 manifest.

Create a project

niblet apps init morning-glow --name "Morning Glow" --author "Your name"
cd morning-glow

A project contains manifest.yaml and exactly one top-level .star file.

Run the local preview

niblet serve .

Open http://localhost:8080 and keep the CLI running while you edit.

Validate and save the review image

niblet apps validate .
niblet apps preview . -o preview.webp

Authorize the CLI

niblet auth login

Review the requested permissions in your browser. The CLI uses OAuth with PKCE and a temporary callback on 127.0.0.1.

Upload and submit

niblet apps push .
niblet apps submit <REVISION_ID>

push validates and renders locally again, then uploads an immutable source-and-WebP pair. submit sends that exact revision to review.

Never place API keys, passwords, OAuth tokens, Wi-Fi details, or customer data in source, manifests, review notes, or MCP messages.

Next steps