Skip to main content

Overview

This site is a personal version of awesome-azd focused on Nathan McNulty's public Azure Developer CLI templates.

What shows up here

  • only public repositories
  • only repositories under nathanmcnulty
  • only repositories whose names start with azd-

That keeps every entry immediately usable with azd init -t.

Default workflow

For most templates, the experience is:

azd init -t nathanmcnulty/azd-{solution}
azd up

Some repositories provide extra guidance or variant-specific steps. When they do, the site shows the exact quickstart commands for that repository.

Site layout

  • the homepage is the entry point and featured view
  • /templates is the full gallery, modeled after the way awesome-azd separates discovery into a dedicated route
  • /guide documents how the catalog is generated and maintained, including one generated page per solution

How data gets into the site

The catalog is built in two layers:

  1. GitHub discovery finds public azd-* repositories automatically.
  2. Local metadata overrides in catalog/overrides.json improve titles, summaries, tags, featured ordering, and quickstart instructions.

Local commands

npm install
npm start

The generator runs automatically before start, build, and typecheck.