Configuration overview
The following different concepts apply to configuring a static web app.
Application configuration: Define rules in the
staticwebapp.config.json
file to control application behavior and features. Use this file to define route and security rules, custom headers, and networking settings.Build configuration: Define settings that control the build process.
Application settings: Set application-level settings and environment variables that can be used by backend APIs.
Example scenarios
If you want to... | then... |
---|---|
Define routing rules | Create rules in the staticwebapp.config.json file |
Set which branch triggers builds | Update the tracked branch name in the build configuration file |
Define which security roles have access to a route | Secure routes with roles in the staticwebapp.config.json file |
Set which HTML file is served if a route doesn't match an actual file | Define fallback route in the staticwebapp.config.json file |
Set global headers for HTTP requests | Define global headers in the staticwebapp.config.json file |
Define a custom build command | Set a custom build command value in the application configuration file |
Set an environment variable for a frontend build | Define an environment variable in the build configuration file |
Set an environment variable for an API | Set an application setting in the portal |
Next steps
Phản hồi
https://aka.ms/ContentUserFeedback.
Sắp ra mắt: Trong năm 2024, chúng tôi sẽ dần gỡ bỏ Sự cố với GitHub dưới dạng cơ chế phản hồi cho nội dung và thay thế bằng hệ thống phản hồi mới. Để biết thêm thông tin, hãy xem:Gửi và xem ý kiến phản hồi dành cho