Quick Start

Get up and running with azd-app in 5 minutes.
Install, run a demo, and fix your first bug with AI!

~5 minutes
🎯 Challenge: Can you fix the bug using AI?

Quick Start Steps

1

Install Azure Developer CLI

First, you'll need the Azure Developer CLI (azd) installed on your machine. Choose your platform below:

bash 
winget install microsoft.azd
💡 After installation, restart your terminal for the changes to apply.
2

Install azd-app

Install the azd-app extension:

bash 
# Add extension source
azd extension source add -n jongio -t url -l https://jongio.github.io/azd-extensions/registry.json

# Install the extension
azd extension install jongio.azd.app
3

Clone Demo Template & Run

Initialize the demo template and start all services. This template includes an intentional bug for you to fix!

bash 
# Initialize the demo project
azd init -t jongio/azd-app-demo

# Navigate to the project
cd azd-app-demo

# Start all services
azd app run
Dashboard opens automatically showing all your services running locally
Expected Output
$ azd app run
Starting services...
✓ web started on http://localhost:3000
✗ api: Connection timeout to database
💡 There's a bug! Use AI to fix it!
💡 The dashboard will open automatically at http://localhost:5050
4

Notice the API Error, Then Ask Copilot to Help Fix It!

You'll see an error in the logs. Now it's time to use AI to diagnose and fix the issue!

Open the Copilot Chat panel in VS Code (Ctrl+Shift+I on Windows/Linux or Cmd+Shift+I on macOS) and ask about the error:

What's Next?

You've completed the quick start! Here's what to explore next:

Guided Tour Walk through all azd-app features step by step Start Tour Azure Cloud Logs Stream logs from your deployed Azure services (1-5 min latency) Learn more azure.yaml Reference Complete guide to configuring your services and apps Learn more AI Features Learn about MCP server and AI-powered debugging Learn more CLI Reference Explore all azd app commands and options Learn more