New Project Wizard

The New Project Wizard (NPW) is an interactive interface in the Pulumi Cloud console that streamlines creating new projects and stacks. The wizard consolidates multiple setup tasks into a single workflow, allowing you to configure project settings, repository details, stack configuration, deployment settings, and service assignments all in one place.

What the New Project Wizard does

The New Project Wizard supports three primary workflows:

1. Create a new project from a template: Create a new project and its first stack by forking code from a Pulumi organization template. This creates a copy of the template code in your repository, which you can then modify independently.
2. Add a no-code stack to a template: Add a new stack to an organization template without forking the template code. The template code remains the single source of truth, and the stack references the template directly.
3. Add a stack to an existing project: Add a new stack to any existing Pulumi project, whether or not it was originally created from a template.

Configuration options

Within the New Project Wizard, you can configure:

• Project configuration: When creating a new project, set the project name, description, and other metadata
• Destination repository: Select an existing repository or create a new one on GitHub
• Stack configuration values:
  • Import ESC environments to provide configuration and secrets
  • Set individual configuration values using a form-based interface (see note below)
• Deployment settings: Configure Pulumi Deployments for the new stack, including drift detection and remediation
• Service assignment: Assign the new stack to a Pulumi IDP Service

Accessing the New Project Wizard

You can access the New Project Wizard from multiple locations in the Pulumi Cloud console:

To create a new project from a template (fork) or add a no-code stack to a template (no fork):

• Navigate to Stacks → Create Project → select a template from the card view → select Use this Template
• Navigate to Platform → Templates → select a template → select Deploy with Pulumi

To add a stack to an existing project:

• Navigate to Stacks → select a stack → select Add Stack

Limitations

• No-code stacks are only supported on GitHub
• When forking templates, destination repositories can only be created on GitHub, even if the source template is hosted on GitLab

GitHub OAuth application

To use the New Project Wizard with Pulumi Deployments, users must authorize a GitHub OAuth application.

The GitHub authorization requires permissions to manage public and private repositories and workflows. Pulumi uses these permissions to read template sources, write template content into repositories, and optionally create new repositories. While the authorization request includes additional repository permissions, Pulumi does not use all of them. This is due to GitHub lacking fine-grained repository permissions as part of the OAuth application scopes.