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

Enable Extensions & Install azd-app

Enable the azd extensions feature and install the azd-app extension:

bash 
# Enable extensions
azd config set alpha.extensions.enabled on

# Add azd-app extension source
azd extension source add -n app -t url -l https://raw.githubusercontent.com/jongio/azd-app/main/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
Expected Output
$ azd app run
Starting services...
✓ web started on http://localhost:3000
✗ api: Connection timeout to database
💡 There's a bug! Continue to Step 4 to fix it with AI.
💡 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 Take a comprehensive tour of all azd-app features Start Tour AI Features Learn about MCP server and AI-powered debugging Learn more Documentation Explore the full CLI reference and commands Learn more