burner new

Create a new burner project from a template.

burner new <template> [name] [options]

Arguments

Argument	Description
`<template>`	Template to use (dotnet, web, or custom). Shows available templates if not provided.
`[name]`	Project name. Auto-generated as `template-HHMMSS` if not provided.

Options

Option	Description
`-d, --directory <PATH>`	Target directory (uses burner home if not specified)
`-e, --explorer`	Open in file explorer after creation
`-c, --code`	Open in editor after creation (uses configured editor)
`-i, --interactive`	Run template interactively (for templates requiring user input)

Examples

# Create with auto-generated name
burner new dotnet
# Create with specific name
burner new dotnet my-experiment
# Create web project and open in VS Code
burner new web quick-test -c
# Create in custom directory
burner new react my-app -d ~/code
# Interactive mode for templates with prompts
burner new svelte my-app -i

How It Works

Creates a directory with the pattern YYMMDD-projectname
Runs the template script with environment variables set
Opens the project in editor/explorer if requested

Tip: Some templates (like Vite-based ones) require user input. Use -i or add # BURNER_INTERACTIVE to your template script for auto-detection.

Environment Variables

Template scripts receive these environment variables:

Variable	Description	Example
`BURNER_NAME`	User-provided project name	`my-experiment`
`BURNER_PATH`	Full path to project directory	`/home/user/.burner/projects/260115-my-experiment`
`BURNER_DATED_NAME`	Dated folder name	`260115-my-experiment`