Expert knowledge for Azure Static Web Apps development including troubleshooting, decision making, limits & quotas, security, configuration, integrations & coding patterns, and deployment. Use when wiring SWA APIs to Azure DBs, configuring custom domains/DNS, auth/roles, CI/CD, or plan limits, and other Azure Static Web Apps related development tasks. Not for Azure App Service (use azure-app-service), Azure Functions (use azure-functions), Azure Container Apps (use azure-container-apps), Azure Web PubSub (use azure-web-pubsub).
v1.0LATEST
NewUpdated Jun 26, 2026
Azure Static Web Apps Skill
This skill provides expert guidance for Azure Static Web Apps. Covers troubleshooting, decision making, limits & quotas, security, configuration, integrations & coding patterns, and deployment. It combines local quick-reference content with remote documentation fetching capabilities.
How to Use This Skill
IMPORTANT for Agent: Use the Category Index below to locate relevant sections. For categories with line ranges (e.g., L35-L120), use read_file with the specified lines. For categories with file links (e.g., [security.md](security.md)), use read_file on the linked reference file
IMPORTANT for Agent: If metadata.generated_at is more than 3 months old, suggest the user pull the latest version from the repository. If mcp_microsoftdocs tools are not available, suggest the user install it: Installation Guide
This skill requires network access to fetch documentation content:
Preferred: Use mcp_microsoftdocs:microsoft_docs_fetch with query string from=learn-agent-skill. Returns Markdown.
Fallback: Use fetch_webpage with query string from=learn-agent-skill&accept=text/markdown. Returns Markdown.
Category Index
Category
Lines
Description
Troubleshooting
L35-L39
Diagnosing and fixing common Static Web Apps deployment and runtime issues, including build failures, configuration problems, and troubleshooting tools/logs.
Decision Making
L40-L47
Guidance on key architecture choices: Functions hosting model, using Front Door/CDN edge, Next.js deployment options, and comparing Free vs Standard Static Web Apps plans.
Limits & Quotas
L48-L54
Details on Static Web Apps plan quotas, resource and behavior limits, supported languages/frameworks, and available runtime versions across tiers.
Security
L55-L66
Configuring auth, roles, secrets, and access: Entra ID/Graph roles, auth providers, user info, deployment tokens, Key Vault/managed identity, password protection, and private endpoints.
Configuration
L67-L93
Configuring domains, DNS, backends (Functions, App Service, Container Apps, APIM), build/runtime settings, local emulation (SWA CLI), monitoring, and database/network for Static Web Apps.
Integrations & Coding Patterns
L94-L102
How to connect Static Web Apps APIs to Azure databases (Cosmos DB, SQL, MySQL, PostgreSQL), including Mongoose usage, connection strings, and typical integration patterns.
Deployment
L103-L119
Deploying Static Web Apps via GitHub/GitLab/Bitbucket/CLI/ARM/Bicep, configuring CI/CD, preview environments, traffic splitting, and optional Azure Front Door CDN setup
Troubleshooting
Topic
URL
Troubleshoot common deployment and runtime issues in Azure Static Web Apps
Grades are signals, not a certification. Always review a skill yourself before use.
Safety
88
Quality
85
Clarity
88
Completeness
82
Summary
This skill provides expert guidance for Azure Static Web Apps development, including troubleshooting, security, configuration, integrations, and deployment. It combines local quick-reference content with remote documentation fetching capabilities through mcp_microsoftdocs or fetch_webpage tools, enabling agents to guide users through SWA development tasks ranging from API wiring to DNS configuration.
Detected Capabilities
documentation fetch (mcp_microsoftdocs and fetch_webpage)file reading (read_file for category-indexed sections)network access for remote docsstructured reference material and link curation
Trigger Keywords
Phrases that agents use to match this skill to user intent.
azure static web appsconfigure swa domainsswa troubleshootingazure swa deploymentswa authenticationswa database integrationswa cli local developmentswa api backend
Referenced Domains
External domains referenced in skill content, detected by static analysis.
github.comlearn.microsoft.com
Use Cases
Configure Azure Static Web Apps with custom domains and DNS
Troubleshoot Static Web Apps deployment failures and runtime issues
Wire Static Web Apps APIs to Azure databases (Cosmos DB, SQL, MySQL, PostgreSQL)
Set up authentication and authorization with Entra ID and Microsoft Graph
Deploy Static Web Apps via GitHub, GitLab, Bitbucket, or CLI with CI/CD
Plan architecture decisions (Functions hosting model, Front Door/CDN, Next.js deployment)
Monitor Static Web Apps with Application Insights and metrics
Understand Static Web Apps limits, quotas, and supported frameworks
Set up local development environment with SWA CLI emulation
Quality Notes
Well-structured category index with line ranges and file links enables efficient agent navigation of content
Clear distinction from related services (App Service, Functions, Container Apps, Web PubSub) prevents user confusion and scope creep
Fallback documentation fetch strategy (preferred mcp_microsoftdocs, fallback fetch_webpage) ensures resilience when MCP tools are unavailable
Important agent guidance (metadata freshness check, tool availability verification) helps maintain documentation accuracy and user experience
Comprehensive topic coverage across 7 major categories (Troubleshooting, Decision Making, Limits, Security, Configuration, Integrations, Deployment) with 50+ linked documentation URLs
All referenced Microsoft Learn URLs are current and follow official documentation paths
Skill correctly scopes boundaries: explicitly excludes App Service, Functions, Container Apps, Web PubSub to avoid user confusion
Metadata includes generator info and timestamp for version tracking and freshness assessment
Model: claude-haiku-4-5-20251001Analyzed: Jun 26, 2026
Reviews
Add this skill to your library to leave a review.
No reviews yet
Be the first to share your experience.
Use MicrosoftDocs/azure-static-web-apps in your dev environment — a Developer account adds skills to your library and syncs them via the SkillRepo CLI.