Edit

Azure Developer CLI templates

  • Article

Azure Developer CLI templates are sample repositories created using the Azure Developer CLI conventions so that you can use azd. The azd templates extend beyond “Hello World!” to provision Azure resources, configure continuous integration and delivery (CI/CD) pipelines, and more. These templates serve as the foundation from which you can build and customize for your own solutions. Each template includes:

  • Application code
  • Infra-as-code files (Bicep or Terraform) needed to provision the Azure resources
  • An azure.yaml file that describes your application

These templates are extensible and customizable to your specific use case.

Available templates

As part of Azure Developer CLI, we’ve authored an initial set of template applications written in:

  • Python
  • JavaScript/TypeScript
  • C#
  • Java

Each template was written for hosts such as:

  • Azure App Service
  • Azure Container Apps
  • Azure Static Web Apps
  • Azure Function Apps
  • Azure Kubernetes Service

Check back for our growing list of templates.

For information on authoring your own template or “templatizing” an existing application, read our guide on making your template azd-compatible.

We also authored starter templates with Infrastructure as Code (IaC) written in:

  • Bicep
  • Terraform

These templates are focused on providing a starting point for writing your app's IaC and can support you in creating your own azd-compatible templates. Unlike the template applications we've authored, these starter templates do not function as full applications on their own. So, you will need to add your own source code and connect it to the infrastructure to have a fully functioning app.

Choose a template

Install the Azure Developer CLI and then select your preferred programming language to choose a template.

You can also run the following command to list all supported, azd-compatible templates.

azd template list

Refer to the README in any of the following Azure Developer CLI enabled templates for more instructions and information.

Template App host Tech stack
React Web App with C# API and MongoDB on Azure Azure App Service Azure Cosmos DB for NoSQL, Bicep
React Web App with C# API and SQL Database on Azure Azure App Service Azure SQL Database, Bicep
Static React Web App + Functions with C# API and SQL Database on Azure Azure Static Web Apps, Azure Functions Azure SQL Database, Bicep

For more community contributed templates, check out our template gallery: Awesome AZD.

Guidelines for using azd templates

Please note that each template that you use with Azure Developer CLI is licensed by its respective owner (which may or may not be Microsoft) under the agreement which accompanies the template. It is your responsibility to determine what license applies to any template you choose to use.

Microsoft is not responsible for any non-Microsoft templates and does not screen these templates for security, privacy, compatibility, or performance issues. The templates you use with Azure Developer CLI, including those provided from Microsoft, are not supported by any Microsoft support program or service. Any Microsoft-provided templates are provided AS IS without warranty of any kind.

Authoring templates

The Azure Developer CLI team plans to author more templates in the future to cover even more developer scenarios. If you author your own templates, you can add the azd-templates topic to your repository on GitHub. That way, other developers can find, fork, and build upon your template for their own use case.

You can also open an issue on our GitHub repository if there’s a use case and template that you would like to see created.

Request help

For information on how to file a bug, request help, or propose a new feature for the Azure Developer CLI, please visit the troubleshooting and support page.

Next steps

Run azd init with an azd template