gb new

Create a new genbox from a starter template.

Synopsis


gb new [template] [name] [options]

Description

Creates a new genbox environment from a pre-configured starter template. This is ideal for starting new projects quickly with a ready-to-use development environment including the framework, dependencies, and AI tools pre-installed.

Arguments

Argument	Description
`template`	Template name (e.g., nextjs, react, node). Interactive selection if omitted.
`name`	Project name. Random name generated if omitted.

Options

Option	Description
`--list`	List available templates
`-s, --size <size>`	Genbox size: small, medium, large, xl
`-l, --local`	Create local genbox (Docker)
`--cloud`	Create cloud genbox (default)
`-y, --yes`	Skip interactive prompts, use defaults

Examples

List Available Templates


gb new --list

Shows all available templates grouped by category:


FRONTEND
  nextjs          Next.js 14 with App Router
     Features: TypeScript, Tailwind CSS, ESLint

  react           React with Vite
     Features: TypeScript, Tailwind CSS, ESLint

BACKEND
  node            Node.js API starter
     Features: Express, TypeScript, ESLint

Create from Template


# Interactive mode - prompts for template and name
gb new
 
# Specify template only
gb new nextjs
 
# Specify template and name
gb new nextjs my-app

Create Locally


# Create local Docker-based genbox
gb new nextjs my-app --local
 
# Create cloud genbox (default)
gb new nextjs my-app --cloud

Specify Size


# Small: 2 vCPU, 4GB RAM (1 credit/hr)
gb new nextjs my-app --size small
 
# Medium: 4 vCPU, 8GB RAM (2 credits/hr)
gb new nextjs my-app --size medium
 
# Large: 8 vCPU, 16GB RAM (4 credits/hr)
gb new nextjs my-app --size large

Non-Interactive Mode


# Skip all prompts, use defaults
gb new nextjs my-app -y

Workflow

Template Selection: Choose from available starter templates
Name Assignment: Provide a name or use auto-generated one
Location Selection: Choose cloud or local Docker
AI CLI Setup: Optionally install Claude Code / Gemini CLI
Provisioning: Server creation and template setup
Ready: Environment available with pre-installed dependencies

Output


✓ Genbox 'my-app' created!

  Name:      my-app
  Status:    running
  IP:        5.161.xxx.xxx

Next steps:
  Connect:       gb connect my-app
  Start Claude:  gb claude --on my-app

Template vs Create

Feature	`gb new`	`gb create`
Use case	New projects from templates	Existing projects with genbox.yaml
Configuration	Pre-configured template	Your genbox.yaml
Repository	Template repo or scaffold	Your repository
Best for	Starting fresh	Existing codebases

Notes

Templates include common dependencies pre-installed
AI credentials from gb setup are automatically configured
Cloud genboxes use your credit balance
Local genboxes require Docker to be running