Azure Static Web Apps

This handles the full Azure Static Web Apps workflow from local development to production deployment. It properly emphasizes using `swa init` to generate the CLI config rather than manually creating it, then walks through the local emulator, Azure Functions integration, and GitHub Actions setup. The command reference is solid with practical examples for each major scenario. What I like is how it distinguishes between the two config files and their purposes. The framework auto-detection and deployment token handling make this genuinely useful for getting static sites with serverless APIs running on Azure without getting lost in the configuration details.

skills.sh installs: 8.9K
GitHub stars: 41K
last updated: Aug 21, 2026

View on GitHub

Install

$ npx -y skills add github/awesome-copilot --skill azure-static-web-apps --agent claude-code

Installs into .claude/skills of the current project.

Files

Overview

Azure Static Web Apps (SWA) hosts static frontends with optional serverless API backends. The SWA CLI (swa) provides local development emulation and deployment capabilities.

Key features:

Local emulator with API proxy and auth simulation
Framework auto-detection and configuration
Direct deployment to Azure
Database connections support

Config files:

swa-cli.config.json - CLI settings, created by swa init (never create manually)
staticwebapp.config.json - Runtime config (routes, auth, headers, API runtime) - can be created manually

General Instructions

Installation

npm install -D @azure/static-web-apps-cli

Verify: npx swa --version

Quick Start Workflow

IMPORTANT: Always use swa init to create configuration files. Never manually create swa-cli.config.json.

swa init - Required first step - auto-detects framework and creates swa-cli.config.json
swa start - Run local emulator at http://localhost:4280
swa login - Authenticate with Azure
swa deploy - Deploy to Azure