azure-swa

Designs and troubleshoots Azure Static Web Apps deployments including routing, authentication, CI/CD, domains/SSL, and monitoring across frameworks such as React, Angular, and Blazor.

22|2|Updated Nov 22, 2025
One-click install
npx skills add https://github.com/markpitt/claude-skills --skill azure-swa
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: azure-swa
Source: https://github.com/markpitt/claude-skills/tree/main/skills/azure-swa
Command: npx skills add https://github.com/markpitt/claude-skills --skill azure-swa

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This Skill guides you through designing, configuring, deploying, and troubleshooting Azure Static Web Apps (SWA), including routing, authentication, APIs, environment management, and monitoring.

Core Features & Use Cases

  • Architectural guidance for SWA frontends and integrated APIs
  • Configuration patterns for routing, headers, and authentication
  • CI/CD and deployment workflows with GitHub Actions
  • Production readiness and troubleshooting for SWA projects

Quick Start

Load core concepts to understand SWA architecture, then load API integration and deployment resources to implement a complete SWA solution.

Frequently Asked Questions about azure-swa

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I deploy a static web app to Azure with CI/CD automation?

Azure Static Web Apps automates deployment through GitHub Actions workflows that build and publish your frontend and API functions on every commit. The Skill guides you through setting up GitHub Actions pipelines, configuring staticwebapp.config.json for routing and authentication, and managing environment variables across staging and production environments.

How do I set up routing and authentication in Azure Static Web Apps?

Routing and authentication in Static Web Apps are configured via staticwebapp.config.json, which defines URL routes, role-based access, and login behavior. The Skill covers configuration patterns for securing routes, integrating authentication providers, and routing requests to backend Azure Functions APIs across React, Angular, Vue, Blazor, and vanilla JS frameworks.

Can I integrate Azure Functions as a backend API with Azure Static Web Apps?

Yes, Azure Static Web Apps natively integrates Azure Functions as backend APIs without separate deployment or CORS configuration. The Skill provides architectural guidance for designing frontend-API interactions, managing environment variables for function endpoints, and structuring CI/CD workflows to deploy both frontend and functions together.

What's the best way to troubleshoot Azure Static Web Apps deployment issues?

Troubleshooting Static Web Apps requires validating staticwebapp.config.json syntax, checking GitHub Actions workflow logs, verifying environment variable configuration, and confirming domain and SSL setup. The Skill walks through common deployment failures, resource selection validation, and monitoring techniques to diagnose routing, authentication, and API integration problems.

Does Azure Static Web Apps work with my frontend framework?

Static Web Apps supports React, Angular, Vue, Blazor, and vanilla JavaScript frameworks. The Skill provides deployment and configuration guidance specific to each framework, including build output paths, environment variable injection, and API integration patterns to ensure framework-specific compatibility.

What do I need to configure for production-ready Azure Static Web Apps?

Production-ready Static Web Apps require configuring custom domains with SSL certificates, setting up monitoring and logging, defining environment-specific variables, securing routes with authentication, and validating API integrations. The Skill covers end-to-end configuration parsing, resource validation, and deployment workflow guidance for production deployments.