Skip to main content
The Niblet CLI is where you build apps. Use it to create a project, preview changes in your browser, check your work, and upload an app when it is ready. Editing, validation, previewing, and rendering all happen on your computer.

Install on macOS or Linux

The installer selects the correct build for your system, verifies its SHA-256 checksum, and installs niblet in /usr/local/bin when writable or ~/.local/bin otherwise. If the name is available, it also adds a pixlet compatibility command.

Verify the install

If both commands run, the CLI is ready.

Update the CLI

The updater checks the stable release, downloads the build for your system, verifies its SHA-256 checksum, and atomically replaces the current executable. If its install directory is not writable, rerun the installer with NIBLET_INSTALL_DIR set to a writable directory.
A native Windows release is not available yet. Use Ubuntu in WSL2.
CLI v0.54.8 can fail to update manifest.yaml on a Windows-mounted WSL path such as /mnt/d/project because the file update calls chmod. Update to v0.54.9 or newer to fix it. On older versions, work in the Linux filesystem (for example ~/projects/my-app), push there, and keep the resulting app_id when copying the manifest back. Version 0.54.9 removes that unnecessary permission change; it still needs write access to the directory to replace the manifest atomically.

Next step

Build your first app

Create a project and open your first local preview.
Last modified on September 2, 2026