Files
backstage/docs/getting-started/create-a-component.md
T
Aramis 21684fe210 apply suggestions from code review
Signed-off-by: Aramis <sennyeyaramis@gmail.com>
Signed-off-by: aramissennyeydd <aramis.sennyey@doordash.com>
2024-02-17 16:19:02 -05:00

1.5 KiB

id, title, description
id title description
create-a-component Create a Component Leverage the scaffolder to start creating components with best practices.

Audience: Developers

Summary

This guide will walk you through how to use Software Templates to create new components with baked in best practices.

Prerequisites

:::note

If you're running Backstage with Node 20 or later, you'll need to pass the flag --no-node-snapshot to Node in order to use the templates feature. One way to do this is to specify the NODE_OPTIONS environment variable before starting Backstage: export NODE_OPTIONS=--no-node-snapshot

:::

You should already have a standalone app.

Creating your component

  • Go to create and choose to create a website with the Example Node.js Template
  • Type in a name, let's use tutorial and click Next Step

Software template deployment input screen asking for a name

  • You should see the following screen:

Software template deployment input screen asking for the GitHub username, and name of the new repo to create

  • For host, it should default to github.com

  • As owner, type your GitHub username

  • For the repository name, type tutorial. Go to the next step

  • Review the details of this new service, and press Create if you want to deploy it like this.

  • You can follow along with the progress, and as soon as every step is finished, you can take a look at your new service