Skip to content
cccskills
FreePublished on GitHub

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/backends, Entra auth, 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 Application Firewall (use azure-web-application-firewall).

The English summary is being prepared. Showing the original description.

MicrosoftDocs/Agent-Skills
Works withGitLabAzurePostgreSQLMySQL
See how to install

Files included (1)

  • SKILL.md11.8 KB

SKILL.md (original)

Review the instructions the agent will receive before you install.

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

CategoryLinesDescription
TroubleshootingL35-L39Diagnosing and fixing common Static Web Apps deployment and runtime issues, including build failures, configuration problems, and troubleshooting tools/logs.
Decision MakingL40-L47Guidance 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 & QuotasL48-L54Details on plan quotas, resource and file size limits, supported languages/runtimes, and behavioral constraints for Azure Static Web Apps across tiers
SecurityL55-L66Configuring auth, roles, and user info; securing apps with Entra ID, custom auth, passwords, private endpoints, Key Vault, and managing deployment tokens for Static Web Apps.
ConfigurationL67-L93Configuring 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 PatternsL94-L102How to connect Static Web Apps APIs to Azure databases (Cosmos DB, SQL, MySQL, PostgreSQL), including Mongoose usage, connection strings, and typical integration patterns.
DeploymentL103-L119Deploying 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

TopicURL
Troubleshoot common deployment and runtime issues in Azure Static Web Appshttps://learn.microsoft.com/en-us/azure/static-web-apps/troubleshooting

Decision Making

TopicURL
Choose managed vs bring-your-own Azure Functions for Static Web Appshttps://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 CDNhttps://learn.microsoft.com/en-us/azure/static-web-apps/enterprise-edge
Select Next.js deployment model on Static Web Appshttps://learn.microsoft.com/en-us/azure/static-web-apps/nextjs
Choose Azure Static Web Apps Free vs Standard planshttps://learn.microsoft.com/en-us/azure/static-web-apps/plans

Limits & Quotas

TopicURL
Azure Static Web Apps limits and behavioral specificshttps://learn.microsoft.com/en-us/azure/static-web-apps/faq
Check supported languages and runtimes for Azure Static Web Appshttps://learn.microsoft.com/en-us/azure/static-web-apps/languages-runtimes
Quotas and limits for Azure Static Web Apps planshttps://learn.microsoft.com/en-us/azure/static-web-apps/quotas

Security

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

Configuration

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

Integrations & Coding Patterns

TopicURL
Use Mongoose with Azure Cosmos DB in Static Web Appshttps://learn.microsoft.com/en-us/azure/static-web-apps/add-mongoose
Connect Azure Static Web Apps to Azure Cosmos DBhttps://learn.microsoft.com/en-us/azure/static-web-apps/database-azure-cosmos-db
Connect Azure Static Web Apps to Azure SQL Databasehttps://learn.microsoft.com/en-us/azure/static-web-apps/database-azure-sql
Connect Azure Static Web Apps to Azure Database for MySQLhttps://learn.microsoft.com/en-us/azure/static-web-apps/database-mysql
Connect Azure Static Web Apps to Azure Database for PostgreSQLhttps://learn.microsoft.com/en-us/azure/static-web-apps/database-postgresql

Deployment

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

Reviews

No reviews yet. Tell others what you thought.

Comments

No login needed. Share how it worked for you, ask a question, or note where it did not run.

No comments yet. Be the first to write one.

Comments are published right away. Do not include personal information such as email addresses or phone numbers. Up to 2 URLs.

0 / 1,000 characters

This form is protected by reCAPTCHA, and the Google Privacy Policy and Terms of Service apply.

More skills from this repository

azure-active-directory-b2c

Free

Expert knowledge for Azure Active Directory B2C development including troubleshooting, best practices, decision making, architecture & design patterns, limits & quotas, security, configuration, integrations & coding patterns, and deployment. Use when building B2C user flows/custom policies, configuring IdPs/MFA, securing APIs, automating CI/CD, or monitoring with Sentinel, and other Azure Active Directory B2C related development tasks. Not for Azure Role-based access control (use azure-rbac), Azure Information Protection (use azure-information-protection), Azure Security (use azure-security), Azure Sentinel (use azure-sentinel).

The English summary is being prepared. Showing the original description.

MicrosoftDocs/Agent-Skills787Updated Oct 19, 2026

azure-advisor

Free

Expert knowledge for Azure Advisor development including best practices, decision making, limits & quotas, security, configuration, and integrations & coding patterns. Use when managing Advisor alerts, digests, recommendation states, Resource Graph queries, or RBAC access, and other Azure Advisor related development tasks. Not for Cost Management (use azure-cost-management), Azure Monitor (use azure-monitor), Azure Policy (use azure-policy), Azure Security (use azure-security).

The English summary is being prepared. Showing the original description.

MicrosoftDocs/Agent-Skills787Updated Oct 19, 2026

azure-ai-vision

Free

Expert knowledge for Azure AI Vision development including decision making, limits & quotas, configuration, integrations & coding patterns, and deployment. Use when using Image Analysis, Read OCR containers, smart-crop thumbnails, background removal, or video frame analysis, and other Azure AI Vision related development tasks. Not for Azure AI Custom Vision (use azure-custom-vision), Azure AI Video Indexer (use azure-video-indexer), Azure AI Document Intelligence (use azure-document-intelligence), Azure AI Immersive Reader (use azure-immersive-reader).

The English summary is being prepared. Showing the original description.

MicrosoftDocs/Agent-Skills787Updated Oct 19, 2026

azure-aks-edge-essentials

Free

Expert knowledge for Azure Kubernetes Service Edge Essentials development including troubleshooting, best practices, decision making, architecture & design patterns, limits & quotas, security, configuration, integrations & coding patterns, and deployment. Use when deploying AKS Edge/Hybrid with Arc, Azure Local, GitOps, IoT/OPC/ONVIF, or Key Vault-integrated workloads, and other Azure Kubernetes Service Edge Essentials related development tasks. Not for Azure Kubernetes Service (AKS) (use azure-kubernetes-service), Azure IoT Edge (use azure-iot-edge), Azure Stack Edge (use azure-stack-edge), Azure Container Apps (use azure-container-apps).

The English summary is being prepared. Showing the original description.

MicrosoftDocs/Agent-Skills787Updated Oct 19, 2026

azure-analysis-services

Free

Expert knowledge for Azure Analysis Services development including troubleshooting. Use when resolving server connectivity, firewall/VNet, DNS, client connection, or network error issues, and other Azure Analysis Services related development tasks. Not for Azure Synapse Analytics (use azure-synapse-analytics), Azure SQL Database (use azure-sql-database), Azure SQL Managed Instance (use azure-sql-managed-instance), SQL Server on Azure Virtual Machines (use azure-sql-virtual-machines).

The English summary is being prepared. Showing the original description.

MicrosoftDocs/Agent-Skills787Updated Oct 19, 2026

azure-anyscale-on-azure

Free

Expert knowledge for Azure Anyscale On Azure development including limits & quotas, security, configuration, integrations & coding patterns, and deployment. Use when registering AKS as Anyscale clouds, wiring ACR images, enabling Private Link/RBAC, ARM-based deployments, or region checks, and other Azure Anyscale On Azure related development tasks. Not for Azure Databricks (use azure-databricks), Azure Kubernetes Service (AKS) (use azure-kubernetes-service), Azure Machine Learning (use azure-machine-learning), Azure HDInsight (use azure-hdinsight).

The English summary is being prepared. Showing the original description.

MicrosoftDocs/Agent-Skills787Updated Oct 19, 2026

See all skills by MicrosoftDocs

Report a problem with this skill