SkillRepo
Sign InSign Up
Catalog
MicrosoftDocs/azure-static-web-apps

MicrosoftDocs

azure-static-web-apps

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
New~3.0kUpdated 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 https://learn.microsoft.com/en-us/azure/static-web-apps/troubleshooting

Decision Making

Topic URL
Choose managed vs bring-your-own Azure Functions for Static Web Apps https://learn.microsoft.com/en-us/azure/static-web-apps/apis-functions
Use enterprise-grade edge for Azure Static Web Apps with Azure Front Door and CDN https://learn.microsoft.com/en-us/azure/static-web-apps/enterprise-edge
Select Next.js deployment model on Static Web Apps https://learn.microsoft.com/en-us/azure/static-web-apps/nextjs
Choose Azure Static Web Apps Free vs Standard plans https://learn.microsoft.com/en-us/azure/static-web-apps/plans

Limits & Quotas

Topic URL
Azure Static Web Apps limits and behavioral specifics https://learn.microsoft.com/en-us/azure/static-web-apps/faq
Supported languages and runtime versions for Azure Static Web Apps https://learn.microsoft.com/en-us/azure/static-web-apps/languages-runtimes
Quotas and limits for Azure Static Web Apps plans https://learn.microsoft.com/en-us/azure/static-web-apps/quotas

Security

Topic URL
Assign Static Web Apps roles using Microsoft Graph and Entra ID https://learn.microsoft.com/en-us/azure/static-web-apps/assign-roles-microsoft-graph
Configure authentication and authorization for Azure Static Web Apps https://learn.microsoft.com/en-us/azure/static-web-apps/authentication-authorization
Configure custom authentication providers for Azure Static Web Apps https://learn.microsoft.com/en-us/azure/static-web-apps/authentication-custom
Manage and reset deployment tokens for Azure Static Web Apps https://learn.microsoft.com/en-us/azure/static-web-apps/deployment-token-management
Use Key Vault and managed identity for Static Web Apps auth secrets https://learn.microsoft.com/en-us/azure/static-web-apps/key-vault-secrets
Enable password protection for Azure Static Web Apps environments https://learn.microsoft.com/en-us/azure/static-web-apps/password-protection
Configure private endpoint access for Azure Static Web Apps https://learn.microsoft.com/en-us/azure/static-web-apps/private-endpoint
Access authenticated user information in Azure Static Web Apps https://learn.microsoft.com/en-us/azure/static-web-apps/user-information

Configuration

Topic URL
Configure apex domains with Azure DNS for Static Web Apps https://learn.microsoft.com/en-us/azure/static-web-apps/apex-domain-azure-dns
Configure apex/root domains with external registrars for Static Web Apps https://learn.microsoft.com/en-us/azure/static-web-apps/apex-domain-external
Configure Azure API Management integration with Static Web Apps https://learn.microsoft.com/en-us/azure/static-web-apps/apis-api-management
Link Azure App Service backends to Azure Static Web Apps https://learn.microsoft.com/en-us/azure/static-web-apps/apis-app-service
Integrate Azure Container Apps as APIs for Static Web Apps https://learn.microsoft.com/en-us/azure/static-web-apps/apis-container-apps
Set application settings for Static Web Apps backend APIs https://learn.microsoft.com/en-us/azure/static-web-apps/application-settings
Configure staticwebapp.config.json for Azure Static Web Apps https://learn.microsoft.com/en-us/azure/static-web-apps/configuration
Configure custom domains for Azure Static Web Apps https://learn.microsoft.com/en-us/azure/static-web-apps/custom-domain
Set up Azure DNS custom domains for Static Web Apps https://learn.microsoft.com/en-us/azure/static-web-apps/custom-domain-azure-dns
Manage default domain routing in Azure Static Web Apps https://learn.microsoft.com/en-us/azure/static-web-apps/custom-domain-default
Use external DNS providers for Static Web Apps custom domains https://learn.microsoft.com/en-us/azure/static-web-apps/custom-domain-external
Configure database connections and firewall for Static Web Apps https://learn.microsoft.com/en-us/azure/static-web-apps/database-configuration
Configure build settings for front-end frameworks in Static Web Apps https://learn.microsoft.com/en-us/azure/static-web-apps/front-end-frameworks
Link existing Azure Functions apps to Static Web Apps https://learn.microsoft.com/en-us/azure/static-web-apps/functions-bring-your-own
Configure local development environment for Azure Static Web Apps https://learn.microsoft.com/en-us/azure/static-web-apps/local-development
Use metrics for managed Functions in Azure Static Web Apps https://learn.microsoft.com/en-us/azure/static-web-apps/metrics
Enable Application Insights monitoring for Azure Static Web Apps APIs https://learn.microsoft.com/en-us/azure/static-web-apps/monitor
Inject runtime snippets into Static Web Apps pages https://learn.microsoft.com/en-us/azure/static-web-apps/snippets
Azure Static Web Apps CLI command reference https://learn.microsoft.com/en-us/azure/static-web-apps/static-web-apps-cli
Run and proxy API servers with Azure Static Web Apps CLI https://learn.microsoft.com/en-us/azure/static-web-apps/static-web-apps-cli-api-server
Configure Azure Static Web Apps CLI with swa-cli.config.json https://learn.microsoft.com/en-us/azure/static-web-apps/static-web-apps-cli-configuration
Emulate Azure Static Web Apps locally with SWA CLI https://learn.microsoft.com/en-us/azure/static-web-apps/static-web-apps-cli-emulator
Use Azure Static Web Apps CLI for local emulation and workflows https://learn.microsoft.com/en-us/azure/static-web-apps/static-web-apps-cli-overview

Integrations & Coding Patterns

Topic URL
Use Mongoose with Azure Cosmos DB in Static Web Apps https://learn.microsoft.com/en-us/azure/static-web-apps/add-mongoose
Connect Azure Static Web Apps to Azure Cosmos DB https://learn.microsoft.com/en-us/azure/static-web-apps/database-azure-cosmos-db
Connect Azure Static Web Apps to Azure SQL Database https://learn.microsoft.com/en-us/azure/static-web-apps/database-azure-sql
Connect Azure Static Web Apps to Azure Database for MySQL https://learn.microsoft.com/en-us/azure/static-web-apps/database-mysql
Connect Azure Static Web Apps to Azure Database for PostgreSQL https://learn.microsoft.com/en-us/azure/static-web-apps/database-postgresql

Deployment

Topic URL
Deploy Bitbucket-hosted apps to Azure Static Web Apps https://learn.microsoft.com/en-us/azure/static-web-apps/bitbucket
Create branch-based preview environments with stable URLs https://learn.microsoft.com/en-us/azure/static-web-apps/branch-environments
Configure CI/CD build YAML for Azure Static Web Apps https://learn.microsoft.com/en-us/azure/static-web-apps/build-configuration
Deploy Azure Static Web Apps with external CI/CD providers https://learn.microsoft.com/en-us/azure/static-web-apps/external-providers
Manually configure Azure Front Door as CDN for Static Web Apps https://learn.microsoft.com/en-us/azure/static-web-apps/front-door-manual
Deploy GitLab-hosted apps to Azure Static Web Apps https://learn.microsoft.com/en-us/azure/static-web-apps/gitlab
Create named preview environments in Azure Static Web Apps https://learn.microsoft.com/en-us/azure/static-web-apps/named-environments
Use preview environments and temporary URLs in Azure Static Web Apps https://learn.microsoft.com/en-us/azure/static-web-apps/preview-environments
Deploy Azure Static Web Apps using ARM templates https://learn.microsoft.com/en-us/azure/static-web-apps/publish-azure-resource-manager
Deploy Azure Static Web Apps with Bicep templates https://learn.microsoft.com/en-us/azure/static-web-apps/publish-bicep
Review pull requests using pre-production environments in Static Web Apps https://learn.microsoft.com/en-us/azure/static-web-apps/review-publish-pull-requests
Deploy static web apps using Azure Static Web Apps CLI https://learn.microsoft.com/en-us/azure/static-web-apps/static-web-apps-cli-deploy
Install Azure Static Web Apps CLI with supported platforms https://learn.microsoft.com/en-us/azure/static-web-apps/static-web-apps-cli-install
Configure traffic splitting between environments in Azure Static Web Apps https://learn.microsoft.com/en-us/azure/static-web-apps/traffic-splitting
Files1
1 files · 18.2 KB

Select a file to preview

Overall Score

86/100

Grade

A

Excellent

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 MCP clients 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
  • Configure backends (Azure Functions, App Service, Container Apps, APIM)
  • 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

Start a Developer trial

Command Palette

Search for a command to run...