Crea, configura y despliega sitios web estáticos con backends de API serverless opcionales usando la SWA CLI.
- Estrellas en GitHub
- 41.038
- Archivos
- 1
- Último commit
- 11 nov 2026
- Licencia
- MIT
- Herramientas permitidas
- —
¿Qué hace la skill azure-static-web-apps?
azure-static-web-apps es una agent skill. Crea, configura y despliega sitios web estáticos con backends de API serverless opcionales usando la SWA CLI.
Resumen generado a partir del SKILL.md de la skill.
Sobre la skill azure-static-web-apps
Desplegar y gestionar sitios web estáticos con backends serverless es lo que los desarrolladores logran utilizando este SKILL. Proporciona acceso a la SWA CLI para manejar todo el ciclo de vida de un Azure Static Web App, desde la emulación local hasta el despliegue en producción. Un agente debe cargar esta herramienta cuando un usuario necesite inicializar un nuevo proyecto, ejecutar un servidor de desarrollo local con proxy de API o configurar el enrutamiento y la autenticación a través de staticwebapp.config.json.
El SKILL automatiza la detección del framework mediante el comando swa init, que genera el archivo swa-cli.config.json necesario. Permite la integración de Azure Functions como capa de API y es compatible con varias conexiones de bases de datos, incluyendo MSSQL, PostgreSQL y CosmosDB. Los usuarios pueden gestionar despliegues en entornos de producción o de vista previa usando swa deploy, y también pueden configurar pipelines de CI/CD automatizados usando GitHub Actions.
Lo que un agente puede hacer con ella
- 1Inicializar un nuevo proyectoConfigura un nuevo proyecto de Static Web App detectando automáticamente el framework de frontend y creando los archivos de configuración.
- 2Ejecutar un emulador localInicia un entorno de desarrollo local que simula el entorno de hosting y el proxy de la API.
- 3Desplegar en AzureSube la aplicación compilada y su API a un entorno de Azure Static Web App.
- 4Conectar una base de datosConfigura conexiones a bases de datos backend como PostgreSQL o CosmosDB.
Escrito a partir del SKILL.md de la skill. Cada caso de uso se verifica con una cita del mismo.
Cómo instalar la skill azure-static-web-apps
Cada comando copia la carpeta de la skill al directorio de skills del cliente. Reinicia el cliente o inicia una nueva sesión para cargarla.Instalar la skill azure-static-web-apps en Claude Code
~/.claude/skills/azure-static-web-apps/SKILL.md
$ npx degit github/awesome-copilot/skills/azure-static-web-apps ~/.claude/skills/azure-static-web-appsInstalar la skill azure-static-web-apps en Claude Code (project)
.claude/skills/azure-static-web-apps/SKILL.md
$ npx degit github/awesome-copilot/skills/azure-static-web-apps .claude/skills/azure-static-web-appsInstalar la skill azure-static-web-apps en Codex
~/.agents/skills/azure-static-web-apps/SKILL.md
$ npx degit github/awesome-copilot/skills/azure-static-web-apps ~/.agents/skills/azure-static-web-appsInstalar la skill azure-static-web-apps en Gemini CLI
~/.gemini/skills/azure-static-web-apps/SKILL.md
$ npx degit github/awesome-copilot/skills/azure-static-web-apps ~/.gemini/skills/azure-static-web-appsInstalar la skill azure-static-web-apps en Claude.ai
npx degit github/awesome-copilot/skills/azure-static-web-apps azure-static-web-apps && zip -r azure-static-web-apps.zip azure-static-web-apps # claude.ai → Customize → Skills → + → Create skill → Upload a skill → azure-static-web-apps.zip
Verificaciones automáticas
Ejecutado 15 nov 2026Informe completo →Superó nuestras comprobaciones automáticas. No es una auditoría de seguridad: lee los scripts antes de dejar que un agente los ejecute. Cómo funcionan las verificaciones
- Repositorio de origen vinculado y accesiblegithub/awesome-copilot/skills/azure-static-web-apps is public and reachablegithub.com/github/awesome-copilot/tree/HEAD/skills/azure-sta ↗Aprobado
- Licencia de código abierto (OSI)MITspdx.org/licenses/MIT.html ↗Aprobado
- Commit o lanzamiento en el último añoLast commit 2026-11-11github.com/github/awesome-copilot/commits ↗Aprobado
- Sin descargar y ejecutar ni robo de credenciales en los scriptsNo scripts in the skill folderAprobado
- Sin instrucciones ocultas en SKILL.mdNo override phrases, safeguard switches, credential requests or hidden charactersgithub.com/github/awesome-copilot/blob/HEAD/skills/azure-sta ↗Aprobado
- Las herramientas preaprobadas están acotadasNo pre-approved tools; the agent asks before using onegithub.com/github/awesome-copilot/blob/HEAD/skills/azure-sta ↗Aprobado
- SKILL.md sigue el formato de Agent SkillsValid name and description; says when to use it; 316 linesgithub.com/github/awesome-copilot/blob/HEAD/skills/azure-sta ↗Aprobado
SKILL.md
Ver en GitHubOverview
Azure Static Web Apps (SWA) hosts static frontends with optional serverless API backends. The SWA CLI (swa) provides local development emulation and deployment capabilities.
Key features:
- Local emulator with API proxy and auth simulation
- Framework auto-detection and configuration
- Direct deployment to Azure
- Database connections support
Config files:
swa-cli.config.json- CLI settings, created byswa init(never create manually)staticwebapp.config.json- Runtime config (routes, auth, headers, API runtime) - can be created manually
General Instructions
Installation
npm install -D @azure/static-web-apps-cli
Verify: npx swa --version
Quick Start Workflow
IMPORTANT: Always use swa init to create configuration files. Never manually create swa-cli.config.json.
swa init- Required first step - auto-detects framework and createsswa-cli.config.jsonswa start- Run local emulator athttp://localhost:4280swa login- Authenticate with Azureswa deploy- Deploy to Azure
Configuration Files
swa-cli.config.json - Created by swa init, do not create manually:
- Run
swa initfor interactive setup with framework detection - Run
swa init --yesto accept auto-detected defaults - Edit the generated file only to customize settings after initialization
Example of generated config (for reference only):
{
"$schema": "https://aka.ms/azure/static-web-apps-cli/schema",
"configurations": {
"app": {
"appLocation": ".",
"apiLocation": "api",
"outputLocation": "dist",
"appBuildCommand": "npm run build",
"run": "npm run dev",
"appDevserverUrl": "http://localhost:3000"
}
}
}
staticwebapp.config.json (in app source or output folder) - This file CAN be created manually for runtime configuration:
{
"navigationFallback": {
"rewrite": "/index.html",
"exclude": ["/images/*", "/css/*"]
},
"routes": [
{ "route": "/api/*", "allowedRoles": ["authenticated"] }
],
"platform": {
"apiRuntime": "node:20"
}
}
Command-line Reference
swa login
Authenticate with Azure for deployment.
swa login # Interactive login
swa login --subscription-id <id> # Specific subscription
swa login --clear-credentials # Clear cached credentials
Flags: --subscription-id, -S | --resource-group, -R | --tenant-id, -T | --client-id, -C | --client-secret, -CS | --app-name, -n
swa init
Configure a new SWA project based on an existing frontend and (optional) API. Detects frameworks automatically.
swa init # Interactive setup
swa init --yes # Accept defaults
swa build
Build frontend and/or API.
swa build # Build using config
swa build --auto # Auto-detect and build
swa build myApp # Build specific configuration
Flags: --app-location, -a | --api-location, -i | --output-location, -O | --app-build-command, -A | --api-build-command, -I
swa start
Start local development emulator.
swa start # Serve from outputLocation
swa start ./dist # Serve specific folder
swa start http://localhost:3000 # Proxy to dev server
swa start ./dist --api-location ./api # With API folder
swa start http://localhost:3000 --run "npm start" # Auto-start dev server
Common framework ports:
| Framework | Port |
|---|---|
| React/Vue/Next.js | 3000 |
| Angular | 4200 |
| Vite | 5173 |
Key flags:
--port, -p- Emulator port (default: 4280)--api-location, -i- API folder path--api-port, -j- API port (default: 7071)--run, -r- Command to start dev server--open, -o- Open browser automatically--ssl, -s- Enable HTTPS
swa deploy
Deploy to Azure Static Web Apps.
swa deploy # Deploy using config
swa deploy ./dist # Deploy specific folder
swa deploy --env production # Deploy to production
swa deploy --deployment-token <TOKEN> # Use deployment token
swa deploy --dry-run # Preview without deploying
Get deployment token:
- Azure Portal: Static Web App → Overview → Manage deployment token
- CLI:
swa deploy --print-token - Environment variable:
SWA_CLI_DEPLOYMENT_TOKEN
Key flags:
--env- Target environment (previeworproduction)--deployment-token, -d- Deployment token--app-name, -n- Azure SWA resource name
swa db
Initialize database connections.
swa db init --database-type mssql
swa db init --database-type postgresql
swa db init --database-type cosmosdb_nosql
Scenarios
Create SWA from Existing Frontend and Backend
Always run swa init before swa start or swa deploy. Do not manually create swa-cli.config.json.
# 1. Install CLI
npm install -D @azure/static-web-apps-cli
# 2. Initialize - REQUIRED: creates swa-cli.config.json with auto-detected settings
npx swa init # Interactive mode
# OR
npx swa init --yes # Accept auto-detected defaults
# 3. Build application (if needed)
npm run build
# 4. Test locally (uses settings from swa-cli.config.json)
npx swa start
# 5. Deploy
npx swa login
npx swa deploy --env production
Add Azure Functions Backend
- Create API folder:
mkdir api && cd api
func init --worker-runtime node --model V4
func new --name message --template "HTTP trigger"
- Example function (
api/src/functions/message.js):
const { app } = require('@azure/functions');
app.http('message', {
methods: ['GET', 'POST'],
authLevel: 'anonymous',
handler: async (request) => {
const name = request.query.get('name') || 'World';
return { jsonBody: { message: `Hello, ${name}!` } };
}
});
- Set API runtime in
staticwebapp.config.json:
{
"platform": { "apiRuntime": "node:20" }
}
- Update CLI config in
swa-cli.config.json:
{
"configurations": {
"app": { "apiLocation": "api" }
}
}
- Test locally:
npx swa start ./dist --api-location ./api
# Access API at http://localhost:4280/api/message
Supported API runtimes: node:18, node:20, node:22, dotnet:8.0, dotnet-isolated:8.0, python:3.10, python:3.11
Set Up GitHub Actions Deployment
- Create SWA resource in Azure Portal or via Azure CLI
- Link GitHub repository - workflow auto-generated, or create manually:
.github/workflows/azure-static-web-apps.yml:
name: Azure Static Web Apps CI/CD
on:
push:
branches: [main]
pull_request:
types: [opened, synchronize, reopened, closed]
branches: [main]
jobs:
build_and_deploy:
if: github.event_name == 'push' || (github.event_name == 'pull_request' && github.event.action != 'closed')
runs-on: ubuntu-latest
steps:
- uses: actions/checkout@v3
- name: Build And Deploy
uses: Azure/static-web-apps-deploy@v1
with:
azure_static_web_apps_api_token: ${{ secrets.AZURE_STATIC_WEB_APPS_API_TOKEN }}
repo_token: ${{ secrets.GITHUB_TOKEN }}
action: upload
app_location: /
api_location: api
output_location: dist
close_pr:
if: github.event_name == 'pull_request' && github.event.action == 'closed'
runs-on: ubuntu-latest
steps:
- uses: Azure/static-web-apps-deploy@v1
with:
azure_static_web_apps_api_token: ${{ secrets.AZURE_STATIC_WEB_APPS_API_TOKEN }}
action: close
- Add secret: Copy deployment token to repository secret
AZURE_STATIC_WEB_APPS_API_TOKEN
Workflow settings:
app_location- Frontend source pathapi_location- API source pathoutput_location- Built output folderskip_app_build: true- Skip if pre-builtapp_build_command- Custom build command
Troubleshooting
| Issue | Solution |
|---|---|
| 404 on client routes | Add navigationFallback with rewrite: "/index.html" to staticwebapp.config.json |
| API returns 404 | Verify api folder structure, ensure platform.apiRuntime is set, check function exports |
| Build output not found | Verify output_location matches actual build output directory |
| Auth not working locally | Use /.auth/login/<provider> to access auth emulator UI |
| CORS errors | APIs under /api/* are same-origin; external APIs need CORS headers |
| Deployment token expired | Regenerate in Azure Portal → Static Web App → Manage deployment token |
| Config not applied | Ensure staticwebapp.config.json is in app_location or output_location |
| Local API timeout | Default is 45 seconds; optimize function or check for blocking calls |
Debug commands:
swa start --verbose log # Verbose output
swa deploy --dry-run # Preview deployment
swa --print-config # Show resolved configuration
Archivos de esta skill
1Preguntas sobre la skill azure-static-web-apps
¿Cómo instalo la skill azure-static-web-apps en Claude Code?
Ejecuta npx degit github/awesome-copilot/skills/azure-static-web-apps ~/.claude/skills/azure-static-web-apps. Claude Code carga las skills desde ~/.claude/skills (todos los proyectos) o .claude/skills (un proyecto) y usa una skill cuando su descripción coincide con la tarea.
¿Qué clientes pueden usar la skill azure-static-web-apps?
Cualquier cliente que lea el formato Agent Skills: Claude Code, Codex, Gemini CLI y claude.ai (subir como ZIP). Los scripts de la skill se ejecutan solo donde el cliente permite la ejecución de código.
¿Cómo creo los archivos de configuración para un nuevo proyecto SWA?
Siempre debes usar el comando swa init para detectar automáticamente tu framework y crear el archivo swa-cli.config.json. Nunca crees este archivo manualmente.
¿Puedo crear manualmente un archivo de configuración para los ajustes de tiempo de ejecución?
Sí, puedes crear manualmente un archivo staticwebapp.config.json en la carpeta de origen o de salida de tu aplicación para gestionar rutas, autenticación y headers.
¿Cómo puedo solucionar los errores 404 en las rutas del lado del cliente?
Para resolver errores 404 en rutas de cliente, añade un navigationFallback con una reescritura a /index.html dentro de tu archivo staticwebapp.config.json.