CLI

Using the interactive prompts

How to navigate and answer the CLI's interactive questions

Overview

The CLI uses @clack/prompts for interactive questions. These prompts work well in most terminals and are fully keyboard-driven.

Core keys

  • Navigate: Up/Down arrow keys
  • Confirm/continue: Enter
  • Cancel: Ctrl+C

Prompt types you’ll see

Single select (choose one)

  • Move with Up/Down, Enter to choose the highlighted option.

Typical places: choosing a web or native framework, picking a runtime or API.

Multi-select (choose many)

  • Move with Up/Down.
  • Space toggles the highlighted option on/off.
  • Enter confirms your selection(s).
  • Some prompts allow selecting none (you can press Enter without toggling anything).

Typical places: selecting project types (web/native), choosing example apps.

Grouped multi-select (addons)

  • Options are organized under group headings.
  • Move with Up/Down, Space to toggle an option, Enter to confirm.
  • Group headings are informational; toggle the items within groups.

Used when selecting addons like Biome, PWA, Turborepo, etc.

Confirm (yes/no)

  • Use Left/Right or Up/Down to highlight Yes/No, then Enter.

Typical places: installing dependencies, initializing Git.

Text input

  • Type your answer and press Enter.
  • If validation fails, a short message will explain what to fix; edit and press Enter again.

Typical places: project name/path, database URLs, provider-specific inputs.

Tips

  • You can skip all prompts with --yes if you want the defaults. See the Options page.
  • If you accidentally start the wrong flow, press Ctrl+C to cancel safely.