Site Configuration

The .dcs/site.yaml file defines core site identity and DCS integration settings.

Overview

# .dcs/site.yaml
site_name: My Website
site_slug: my-website
production_url: https://www.mywebsite.com
portal_api_url: https://portal.duffcloudservices.com/api
app_location: docs/.vitepress/dist

Schema

Property	Type	Required	Description
site_name	string	Yes	Human-readable name of the site
site_slug	string	Yes	Unique identifier (lowercase, hyphens)
swa_resource_id	string	No	Azure Static Web App resource ID
production_url	string	No	Production URL of the site
preview_url	string	No	Preview URL for staging
app_location	string	No	Build output directory
output_location	string	No	Output folder relative to app_location
google_analytics_id	string	No	Google Analytics Measurement ID
portal_api_url	string	No	URL of the DCS Portal API
azure	object	No	Azure OIDC authentication config
snapshots	object	No	Snapshot storage configuration
content	object	No	Content API configuration
metadata	object	No	Site metadata

Properties

site_name & site_slug

Core site identification:

site_name: Acme Corporation Website
site_slug: acme-corp

• site_name: Display name shown in the DCS Portal
• site_slug: Unique identifier used in URLs and file paths

URLs

production_url: https://www.acmecorp.com
preview_url: https://preview.acmecorp.com
portal_api_url: https://portal.duffcloudservices.com/api

Build Configuration

app_location: docs/.vitepress/dist
output_location: "."

azure

Azure authentication for OIDC-based deployments:

azure:
  client_id: 00000000-0000-0000-0000-000000000000
  tenant_id: 00000000-0000-0000-0000-000000000000
  subscription_id: 00000000-0000-0000-0000-000000000000

snapshots

Configure snapshot storage for the visual page editor:

snapshots:
  storage_account: dcssnapshotsprod
  container: snapshots

content

Content API configuration:

content:
  api_version: "1.0"

metadata

Site metadata for tracking and organization:

metadata:
  framework: vitepress
  managed_by: partner  # or "dcs"
  created_at: "2025-01-15T10:00:00Z"

Editor Schema

Enable intelligent autocompletion in VS Code:

{
  "yaml.schemas": {
    "https://schema.duffcloudservices.com/1.0.0/site.json": "/.dcs/site.yaml"
  }
}

Full Example

# .dcs/site.yaml

site_name: Acme Corporation
site_slug: acme-corp

swa_resource_id: /subscriptions/.../resourceGroups/.../providers/Microsoft.Web/staticSites/acme-corp

production_url: https://www.acmecorp.com
preview_url: https://preview.acmecorp.com

app_location: docs/.vitepress/dist
output_location: "."

google_analytics_id: G-XXXXXXXXXX

portal_api_url: https://portal.duffcloudservices.com/api

azure:
  client_id: 12345678-1234-1234-1234-123456789abc
  tenant_id: 87654321-4321-4321-4321-cba987654321
  subscription_id: abcd1234-ab12-cd34-ef56-abcdef123456

snapshots:
  storage_account: dcssnapshotsprod
  container: snapshots

content:
  api_version: "1.0"

metadata:
  framework: vitepress
  managed_by: partner
  created_at: "2025-01-15T10:00:00Z"

Related

• DCS Config — Main configuration file
• pages.yaml — Page definitions
• Partner Onboarding — Site setup guide