Quick Start

This guide gets you from zero to a running NNO development environment.

Prerequisites

• Node.js 20+ (22 recommended)
• pnpm 10+
• Cloudflare account with Workers and Pages enabled
• NNO CLI installed globally

1. Install the CLI

pnpm add -g @neutrino-io/cli

2. Authenticate

nno login

This opens a browser window to authenticate with the NNO platform.

3. Create a Project

nno project init my-app
cd my-app

The CLI scaffolds a new project from the nno-stack-starter template.

4. Start Development

pnpm dev

This starts:

• Frontend dev server at http://localhost:5174
• Backend Workers locally via Wrangler

5. Deploy

nno project deploy

Deploys your app to Cloudflare Pages (frontend) and Workers (backend).

Next Steps

• Feature Development Guide — Build your first feature package
• Environment Guide — Local, staging, and production workflows