Customize the appearance and behavior of the cloud-native development launch button to make your project stand out.

Use Cases

• Create a unique launch experience for open-source projects
• Highlight the development environment features of your project
• Control resource configuration of the development environment (e.g. CPU cores)
• Disable the default launch button (e.g., when using a custom pipeline instead)

Configuration

Add the workspace configuration to .cnb/settings.yml in the branch where the launch button is located:

.cnb/settings.yml

workspace:
  launch:
    button:
      name: Launch Cloud-Native Development
      description: Click this button to launch the cloud-native development environment
      hoverImage: .cnb/launch-hover.gif
    cpus: 4
    disabled: false
    autoOpenWebIDE: false

Parameter Reference

Parameter	Type	Default	Description
workspace.launch.button.name	string	-	The name of the launch button
workspace.launch.button.description	string	-	Button description
workspace.launch.button.hoverImage	string	-	Hover image (repo relative path or URL, ≤10MB)
workspace.launch.cpus	number	8	CPU cores, only effective for the default template
workspace.launch.disabled	boolean	false	Whether to disable the default launch button
workspace.launch.autoOpenWebIDE	boolean	false	Whether to auto-open WebIDE after creation

Notes:

• description: Set to null to hide the button description.
• hoverImage: Supports a repository relative path or a raw URL. The image is displayed when the user hovers over the launch button. Maximum file size is 10MB.
• autoOpenWebIDE: Once the cloud-native development environment is successfully created, the WebIDE opens automatically in the browser without additional user action.

Tips

All parameters are optional. Configure only what you need.

Previous pageUI Customization

Next pageIssue Button Customization