Skip to main content
Version: 1.0

wash new

This command creates a new project from an existing template. A user may create a component, provider or an interface project. This command takes you through the process in an interactive way. Following are the subcommands available under wash new:

  • component
  • provider

component​

When creating a new component project, a user may select from the following templates to create a skeleton:

  • hello-world-rust: A hello-world component in Rust thay responds over an HTTP connection
  • hello-world-tinygo: A hello-world component in TinyGo that responds over an HTTP connection
  • hello-world-typescript: A hello-world component in TypeScript that responds over an HTTP connection
  • hello-world-python: A hello-world component in Python that responds over an HTTP connection

If you do not specify a template with the --template-name argument, you will be prompted to select one. You will then have to name the project, and a new project template will be created in the current directory. The project name can also be specified earlier and be passed to wash new component <project-name>.

Usage​

shell
wash new component
wash new component example-project
wash new component example-project --template-name hello-world-rust

provider​

When creating a new provider project, a user may select from the following templates to create a skeleton:

  • messaging-nats: A capability provider with scaffolding to implement the wasmcloud:messaging interface for pubsub

The user will have to specify the name of the project and a vendor name, and a new project template will be created in the current directory. The project name can also be specified earlier and be passed to wash new provider <project-name>.

Usage​

shell
wash new provider
wash new provider example-project
wash new provider example-project --template-name messaging-nats

Options​

The following options can be used for all wash new subcommands:

--git Github repository url. Requires 'git' to be installed in PATH

--output (Alias -o) Specify output format (text or json) [default: text]

--experimental Whether or not to enable experimental features [env: WASH_EXPERIMENTAL=]

--subfolder Optional subfolder of the git repository

--branch Optional github branch. Defaults to "main"

--path (Alias -p) Optional path for template project (alternative to --git)

--values (Alias -v) Optional path to file containing placeholder values

--silent Silent - do not prompt user. Placeholder values in the templates will be resolved from a '--values' file and placeholder defaults

--favorites Favorites file - to use for project selection

--template-name (Alias -t) Template name - name of template to use

--no-git-init Don't run 'git init' on the new folder