Quick Start

Get your site connected to DCS in just a few minutes. This guide covers the essential steps for both site owners and partners.

For Site Owners

If your site is already set up on DCS, you can start managing content immediately:

1. Access the Portal

Navigate to portal.duffcloudservices.com and sign in with your Microsoft account.

2. Select Your Site

From the dashboard, click on your site to open the Site Manager.

3. Start Editing

• Text Content — Click "Text Overrides" to edit any text on your site
• SEO Settings — Click "SEO & Metadata" to update page titles and descriptions
• Blog Posts — Click "Blog" to create or edit posts

Changes to text and SEO are applied immediately. Blog posts can be saved as drafts or published.

For Partners

Setting up a new site integration involves a few more steps:

1. Prerequisites

Ensure you have:

• A VitePress-based website (or compatible framework)
• Access to the site's GitHub repository
• A DCS partner account

2. Install the DCS SDK

In your site's project directory:

pnpm add @dcs/client

3. Configure the Site

Create a .dcs/config.yaml file in your repository:

# .dcs/config.yaml
site:
  slug: your-site-slug
  name: Your Site Name
  
api:
  endpoint: https://portal.duffcloudservices.com/api
  
features:
  textOverrides: true
  seoMetadata: true
  blog: true

4. Add the Text Content Composable

For VitePress sites, add the useTextContent composable to enable editable text regions:

<script setup lang="ts">
import { useTextContent } from '@/lib/use-text-content'

const { t } = useTextContent()
</script>

<template>
  <h1>{{ t('home.hero.title', 'Welcome to Our Site') }}</h1>
  <p>{{ t('home.hero.description', 'Default description text') }}</p>
</template>

The first argument is the text key (used in the portal), and the second is the default value.

5. Configure Pages

Create a .dcs/pages.yaml file to register your pages:

pages:
  - slug: home
    path: /
    type: static
    title: Home
    deletable: false
    textKeys: []  # Auto-discovered during snapshot

  - slug: about
    path: /about
    type: static
    title: About
    deletable: true
    textKeys: []

6. Set Up GitHub Integration

Add the required secrets to your GitHub repository:

# Required secrets
AZURE_CLIENT_ID=<your-client-id>
AZURE_CLIENT_SECRET=<your-client-secret>
AZURE_TENANT_ID=<your-tenant-id>
AZURE_SUBSCRIPTION_ID=<your-subscription-id>
DCS_SERVER_URL=https://portal.duffcloudservices.com

7. Register with DCS

Contact the DCS team to complete site registration, which includes:

• Creating the site record in the portal
• Setting up Azure Static Web Apps resources
• Configuring deployment workflows

Verifying Your Setup

Test Text Overrides

1. Log into the portal and navigate to your site
2. Go to "Text Overrides"
3. Create an override for one of your text keys
4. Refresh your site — you should see the new text

Test Development Requests

1. Go to "Development Requests"
2. Click "New Request"
3. Describe a simple change (e.g., "Change the button color to blue")
4. Submit and watch the automation in action

Next Steps

• Core Concepts — Understand how DCS works under the hood
• Portal Guide — Learn all the portal features
• Site Configuration — Deep dive into configuration options