leo new

To create a new project, run:

leo new <NAME>

To create a new library, run:

leo new --library <NAME>

Valid project and library names are snake_case: lowercase letters and numbers separated by underscores. A name may not be a Leo keyword (for example program, function, mapping, let, or constructor). This command will create a new directory with the given name.

See Project Layout for more details.

When leo new <NAME> is run from inside a workspace, the new package is appended to the enclosing workspace.json automatically. See Adding Members for the exact behavior.

Flags

--library

Creates a new Leo library instead of a program. Other Leo programs or libraries can import its reusable logic with leo add --local. You cannot deploy or execute a library independently. The generated project includes a tests/ directory with a starter test file.

--workspace

Creates a workspace skeleton instead of a package. The generated directory contains only a workspace.json with an empty members array. List member paths or globs, or run leo new in the workspace. See Workspaces. This option conflicts with --library.