Erstelle, konfiguriere und deploye statische Websites mit optionalen serverless API-Backends mithilfe des SWA CLI.
- GitHub Stars
- 41.038
- Dateien
- 1
- Letzter Commit
- 11. Nov. 2026
- Lizenz
- MIT
- Erlaubte Tools
- —
Was macht der azure-static-web-apps Skill?
azure-static-web-apps ist ein Agent Skill. Erstelle, konfiguriere und deploye statische Websites mit optionalen serverless API-Backends mithilfe des SWA CLI.
Zusammenfassung erzeugt aus der SKILL.md des Skills.
Über den azure-static-web-apps skill
Das Deployment und Management von statischen Websites mit serverless Backends ist das Ziel, das Entwickler mit diesem Skill erreichen. Er bietet Zugriff auf das SWA CLI, um den gesamten Lifecycle einer Azure Static Web App zu handhaben – von der lokalen Emulation bis zum Production-Deployment. Ein Agent sollte dieses Tool laden, wenn ein User ein neues Projekt initialisieren, einen lokalen Development-Server mit API-Proxying ausführen oder das Routing und die Authentifizierung via staticwebapp.config.json konfigurieren muss.
Der Skill automatisiert die Framework-Erkennung durch den swa init Befehl, der die benötigte swa-cli.config.json Datei generiert. Er ermöglicht die Integration von Azure Functions als API-Layer und unterstützt verschiedene Datenbankverbindungen, einschließlich MSSQL, PostgreSQL und CosmosDB. User können Deployments in Production- oder Preview-Umgebungen mit swa deploy verwalten und zudem automatisierte CI/CD-Pipelines über GitHub Actions einrichten.
Was ein agent damit machen kann
- 1Ein neues Projekt initialisierenSetze ein neues Static Web App Projekt auf, indem das Frontend-Framework automatisch erkannt und die Konfigurationsdateien erstellt werden.
- 2Einen lokalen Emulator ausführenStarte eine lokale Development-Umgebung, die die Hosting-Umgebung und das API-Proxying simuliert.
- 3Zu Azure deployenPushe die gebaute App und deren API in eine Azure Static Web App Umgebung.
- 4Eine Datenbank verbindenKonfiguriere Verbindungen zu Backend-Datenbanken wie PostgreSQL oder CosmosDB.
Geschrieben basierend auf dem SKILL.md des skills. Jeder use case wurde gegen ein zitat daraus geprüft.
So installierst du den azure-static-web-apps Skill
Jeder Befehl kopiert den Skill-Ordner in das Skills-Verzeichnis des Clients. Starte den Client neu oder beginne eine neue Session, um ihn zu laden.Den azure-static-web-apps Skill in Claude Code installieren
~/.claude/skills/azure-static-web-apps/SKILL.md
$ npx degit github/awesome-copilot/skills/azure-static-web-apps ~/.claude/skills/azure-static-web-appsDen azure-static-web-apps Skill in Claude Code (project) installieren
.claude/skills/azure-static-web-apps/SKILL.md
$ npx degit github/awesome-copilot/skills/azure-static-web-apps .claude/skills/azure-static-web-appsDen azure-static-web-apps Skill in Codex installieren
~/.agents/skills/azure-static-web-apps/SKILL.md
$ npx degit github/awesome-copilot/skills/azure-static-web-apps ~/.agents/skills/azure-static-web-appsDen azure-static-web-apps Skill in Gemini CLI installieren
~/.gemini/skills/azure-static-web-apps/SKILL.md
$ npx degit github/awesome-copilot/skills/azure-static-web-apps ~/.gemini/skills/azure-static-web-appsDen azure-static-web-apps Skill in Claude.ai installieren
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
Automatisierte Checks
Geluften am 15. Nov. 2026Vollständiger Bericht →Hat unsere automatischen Prüfungen bestanden. Das ist kein Sicherheitsaudit: Lesen Sie die Skripte, bevor ein Agent sie ausführt. Wie die Checks funktionieren
- Source Repository verknüpft und erreichbargithub/awesome-copilot/skills/azure-static-web-apps is public and reachablegithub.com/github/awesome-copilot/tree/HEAD/skills/azure-sta ↗Bestanden
- Open Source Lizenz (OSI)MITspdx.org/licenses/MIT.html ↗Bestanden
- Commit oder Release im letzten JahrLast commit 2026-11-11github.com/github/awesome-copilot/commits ↗Bestanden
- Keine Download-und-Ausführen-Muster oder Zugangsdatendiebstahl in SkriptenNo scripts in the skill folderBestanden
- Keine versteckten Anweisungen in SKILL.mdNo override phrases, safeguard switches, credential requests or hidden charactersgithub.com/github/awesome-copilot/blob/HEAD/skills/azure-sta ↗Bestanden
- Vorab erlaubte Tools sind eingeschränktNo pre-approved tools; the agent asks before using onegithub.com/github/awesome-copilot/blob/HEAD/skills/azure-sta ↗Bestanden
- SKILL.md folgt dem Agent-Skills-FormatValid name and description; says when to use it; 316 linesgithub.com/github/awesome-copilot/blob/HEAD/skills/azure-sta ↗Bestanden
SKILL.md
Auf GitHub ansehenOverview
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
Dateien in diesem Skill
1azure-static-web-apps Skill-Fragen
Wie installiere ich den azure-static-web-apps Skill in Claude Code?
Führe npx degit github/awesome-copilot/skills/azure-static-web-apps ~/.claude/skills/azure-static-web-apps aus. Claude Code lädt Skills aus ~/.claude/skills (alle Projekte) oder .claude/skills (ein Projekt) und nutzt einen Skill, wenn seine Beschreibung zur Aufgabe passt.
Welche Clients können den azure-static-web-apps Skill nutzen?
Jeder Client, der das Agent Skills-Format liest: Claude Code, Codex, Gemini CLI und claude.ai (als ZIP hochladen). Skripte im Skill laufen nur dort, wo der Client Codeausführung erlaubt.
Wie erstelle ich die Konfigurationsdateien für ein neues SWA-Projekt?
Verwende immer den Befehl swa init, um dein Framework automatisch zu erkennen und die swa-cli.config.json Datei zu erstellen. Erstelle diese Datei niemals manuell.
Kann ich eine Konfigurationsdatei für Runtime-Einstellungen manuell erstellen?
Ja, du kannst manuell eine staticwebapp.config.json Datei in deinem App-Source- oder Output-Ordner erstellen, um Routes, Authentifizierung und Header zu verwalten.
Wie beheben ich 404-Fehler bei Client-seitigen Routes?
Um 404-Fehler bei Client-Routes zu lösen, füge in deiner staticwebapp.config.json Datei einen navigationFallback mit einem Rewrite auf /index.html hinzu.