Creating new resources is streamlined with Amplication’s Blueprints. By using pre-defined, standardized foundations with Blueprints, you can focus on writing the core business logic that matters.

Want to learn more about the power of Blueprints? See the Blueprints page for a comprehensive overview of how your platform team can use them to establish organizational standards.

How to Create a Resource from a Blueprint

There are a couple of convenient ways to start creating a new resource from a blueprint:

  1. From the Workspace Catalog:

    1

    Navigate to the Workspace Catalog

    Go to your Amplication workspace and select the Workspace Catalog tab.

    2

    Add Resource to Project

    Click the Add Resource to Project button in the top right corner.

    3

    Select Your Project

    Choose the project where you want to create the new resource. This will take you to the “Create a new resource in the catalog” page.

  2. From Within a Specific Project:

    1

    Go to Your Projects

    Navigate to the Projects tab in your workspace.

    2

    Select Your Project

    Click on the specific project where you want to add the resource.

    3

    Open the Catalog

    Within the project view, select the Catalog tab.

    4

    Add Resource

    Click the Add Resource button in the top right corner.

    5

    Select From Blueprint

    In the dropdown menu, choose from blueprint / template.

Both methods will lead you to the Create a new resource in the catalog page, where you can select your blueprint.

Configuring Your New Resource

Once you’re on the Create a new resource in the catalog page, you’ll configure the details for your new service:

1

Project and Blueprint Selection

You’ll see two dropdown menus: template and blueprint.

Select the desired blueprint from the dropdown. For example, you might select an “API” blueprint.

2

Resource Details

In the Resource section, provide the following information:

  • Name: Give your new resource a descriptive name (e.g., “BillingService”).
  • Description: Add a brief description for the resource.
  • Catalog Properties: Your platform team may have defined specific catalog properties to help organize and categorize resources. Fill in the required and any relevant optional properties. These might include things like “Tech,” “Type,” “Domain,” and “Lifecycle.”

Learn more about how catalog properties help organize your resources in the Catalog Properties page.

3

Git Repository Settings

By default, your new resource will be associated with the default Git repository configured for the project.

If you need to use a different repository:

  1. Click the Override Default Settings slider.
  2. Select the desired Git organization.
  3. Choose the specific repository you want to associate with this resource.
4

Create the Resource

Once you’ve filled in all the necessary details, click the Create Resource button.

Exploring Your New Resource

After creating your resource, you’ll be automatically taken to its Overview page.

Example of a newly created resource's Overview page.

Here, you can see:

  • Name and Description: The name and description you provided.
  • Catalog Properties: The catalog properties you set during creation.
  • Owner: The team or individual responsible for the resource.

From this overview page, you can further customize and manage your resource using the tabs across the top:

  • Plugins: Add functionality and integrations by installing plugins. If your platform team is using blueprints, you’ll see any private plugins available to you.
  • Git Settings: Review or override the Git repository settings if needed.
  • Tech Debt: Monitor potential technical debt alerts related to your resource.
  • Settings: Modify the resource’s name, description, owner, and catalog properties.

Remember to click the Generate the Code button in the Pending Changes section in the right sidebar to apply any modifications you make to your resource.