Skip to main content
Build your first Niblet app and see it in your browser. Everything runs locally while you work; Niblet receives your app only when you choose to upload it.
1

Install the Niblet CLI

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

Create your app

This creates manifest.yaml for the app details and main.star for the app code.
3

Preview as you build

Open http://localhost:8080. Keep the preview running while you edit main.star.
4

Check the finished app

Validation catches project and rendering errors. The second command saves a WebP you can inspect before uploading anything.
5

Sign in to Niblet

Your browser opens so you can review and approve the CLI permissions. The sign-in uses OAuth with PKCE and returns through a temporary local callback.
6

Send the app for review

Copy the revision ID printed by the command, then submit it:
The first push also writes the hosted App ID to manifest.yaml; later pushes reuse it automatically. push validates and renders locally again, then saves the source and preview as one version. submit sends that exact revision to review; it does not publish directly.
Keep API keys, passwords, OAuth tokens, Wi-Fi details, and customer data out of app files, review notes, and MCP messages.

Next steps

Learn the app workflow

Add configuration

Connect an AI assistant

Prepare your app for review

Last modified on September 2, 2026