azd extensions

A curated registry of Azure Developer CLI extensions

🌐 Live Site: jongio.github.io/azd-extensions

Extensions

Extension	Description	Latest
azd-exec	Execute scripts with azd environment context, Azure credentials, and Key Vault integration	v0.3.0
azd-app	Run Azure apps locally with auto-dependencies, real-time dashboard, and AI-powered debugging via MCP	v0.11.4

Quick Start

1. Enable Extensions

Extensions are an alpha feature in Azure Developer CLI:

azd config set alpha.extensions on

2. Add This Registry

azd extension source add jongio --type url --location "https://jongio.github.io/azd-extensions/registry.json"

3. Install Extensions

# List available extensions
azd extension list --source jongio

# Install extensions
azd extension install jongio.azd.exec
azd extension install jongio.azd.app

# View installed
azd extension list --installed

Usage Examples

azd-exec

Run any script with full access to your azd environment variables, Azure credentials, and Key Vault secrets:

# Execute a script file with azd context
azd exec ./deploy.sh

# Execute an inline command
azd exec 'echo "Deploying to $AZURE_ENV_NAME"'

# Specify shell explicitly
azd exec --shell pwsh ./deploy.ps1

# Run in interactive mode
azd exec --interactive ./setup.sh

# Pass arguments to a script
azd exec ./build.sh --verbose --config release

# Key Vault secrets are resolved automatically from azd env references
azd exec ./deploy-with-secrets.sh

azd-app

Run your entire app locally with one command — auto-dependencies, real-time dashboard, and AI-powered debugging:

# Start all services defined in azure.yaml
azd app run

# Check prerequisites are installed
azd app reqs

# Install dependencies for all services
azd app deps

# View logs (with optional follow)
azd app logs --follow

# Monitor service health
azd app health --stream

# Run tests with coverage
azd app test --coverage

# Show project info
azd app info

# Start the MCP server for AI debugging with GitHub Copilot
azd app mcp serve

Development

Prerequisites

• Node.js 20+
• pnpm 9+

Setup

git clone https://github.com/jongio/azd-extensions.git
cd azd-extensions
pnpm install
pnpm dev

Commands

Command	Description
pnpm dev	Start dev server
pnpm build	Build for production
pnpm test	Run tests
pnpm test:coverage	Generate coverage report
pnpm lint	Lint code
pnpm type-check	TypeScript check
pnpm format	Format with Prettier

Tech Stack

Category	Technology
Framework	React 19 + TypeScript
Build	Vite 7
Styling	Tailwind CSS 4 + shadcn/ui
Animation	Motion
Testing	Vitest
CI/CD	GitHub Actions

Registry

The public/registry.json file is the extension source that azd reads. It auto-updates daily via GitHub Actions.

Manual Update

gh workflow run update-registry.yml

See CONTRIBUTING.md for details on adding extensions.

Project Structure

├── src/
│   ├── components/     # React components (Header, Footer, ExtensionCard, etc.)
│   │   ├── ui/        # shadcn/ui components
│   │   └── icons/     # Custom icons
│   ├── lib/           # Utilities
│   └── types/         # TypeScript types
├── public/
│   └── registry.json  # Extension registry (served to azd)
└── scripts/
    └── update-registry.js

Resources

• Azure Developer CLI Documentation
• azd Extension Framework
• Contributing Guide

License

MIT — see LICENSE

---

_{Built by Jon Gallant with React 19, Vite 7, and Tailwind CSS 4}