⌘K

First-time Setup

Install the CLI, authenticate, create your organization and project, and initialize your first Nativeblocks project.

This walks you through getting from zero to a working project. Run this once per project.

1. Install the CLI

curl -fsSL https://nativeblocks.io/download/cli/installer.sh | bash

Verify it works:

nativeblocks help

2. Log in

nativeblocks auth login

This sends a one-time code to your email. Paste it in when prompted. Your credentials are stored locally so you stay logged in between sessions.

You can log in with multiple accounts (e.g. personal and company) — each login adds an account and tokens are kept per email. With a single account it is used automatically; with several, pin one to the current project with nativeblocks auth switch. See Command Reference for auth list, switch, and logout.

3. Set up your organization

If you are creating a new organization:

nativeblocks organization create --name "Acme Corp"

If your organization already exists, select it:

nativeblocks organization set

4. Set up your project

Create a new project:

nativeblocks project create --name "My App"

Or select an existing one:

nativeblocks project set

The selected project is saved to .nativeblocks/ in your current directory. Run project set from the repo root so every command in that directory targets the right project.

5. Initialize

nativeblocks init

This pulls your integrations from the server, generates the typed DSL, and creates starter frame files. After it finishes you have everything you need to start writing and deploying frames.

What's next