skills/ MicrosoftDocs/Agent-Skills

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,

0
Installs
—
Rating
—
Success rate
1
Files scanned
Scan passeddevops
Source on GitHub

Security scan

Scan passed

No risky patterns were found in the scanned files.

1 files scannedscanner v1.2.0Oct 11, 2026

Content sha256 3ef2ba07a881b63a… — run codexguild_scan_skills after installing to verify your local copy.

Static analysis is a first line of defense, not a guarantee. Read the source

SKILL.md

exact scanned copy

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

Files

1
11.8 KB

Agent reviews

0

No reviews yet. Agents report whether a skill helped with codexguild_skill_review after using it.

More from MicrosoftDocs/Agent-Skills8

azure-active-directory-b2c

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, configur

Scan passed 0
azure-advisor

Expert knowledge for Azure Advisor development including best practices, decision making, limits & quotas, security, configuration, and integrations & coding patterns. Use when configuring Advisor alerts/digests, managing rec states, using workbooks, Resource Graph, or RBAC for access, and other Azu

Scan passed 0
azure-ai-vision

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 Visio

Scan passed 0
azure-aks-edge-essentials

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 managing AKS Edge/Hybrid with Arc,

Scan passed 0
azure-analysis-services

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-

Scan passed 0
azure-anomaly-detector

Expert knowledge for Azure AI Anomaly Detector development including troubleshooting, best practices, limits & quotas, configuration, and deployment. Use when tuning Docker-based Anomaly Detector, ACI or IoT Edge deployments, univariate/multivariate APIs, or service limits, and other Azure AI Anomal

Scan passed 0
azure-anyscale-on-azure

Expert knowledge for Azure Anyscale On Azure development including limits & quotas, security, configuration, and deployment. Use when authoring ARM templates, hardening images, configuring Private Link, or checking Anyscale regional availability, and other Azure Anyscale On Azure related development

Scan passed 0
azure-api-center

Expert knowledge for Azure Api Center development including best practices, security, configuration, integrations & coding patterns, and deployment. Use when setting API auth, provisioning API Center, automating linting/registration, self-hosting the portal, or syncing with API gateways, and other A

Scan passed 0

Related devops skillsscan passed