Appearance
NPM Packages โ
DCS provides two official npm packages for integrating customer sites with the platform:
@duffcloudservices/cms โ
Vue 3 composables and Vite plugins for runtime content management and SEO.
๐ฆ Published Package
Key Features:
useTextContentโ Text content with build-time injection and runtime overridesuseSEOโ SEO configuration with meta tags, Open Graph, Twitter Cards, JSON-LDuseReleaseNotesโ Fetch and display versioned release notesuseSiteVersionโ Get current site version for footer badges- Vite plugins for build-time content and SEO injection
โ Full @duffcloudservices/cms Documentation
@duffcloudservices/cli โ
Command-line interface for site onboarding, configuration, and authentication.
๐ฆ Published Package
Key Features:
dcs initโ Initialize DCS integration for a customer sitedcs validateโ Validate existing .dcs configurationdcs plansโ Generate AI-assisted integration plansdcs loginโ Authenticate via Google OAuth (device flow)dcs sitesโ List sites you have access to manage
โ Full @duffcloudservices/cli Documentation
CMS framework adapters โ
The Vue @duffcloudservices/cms package has siblings for other frontend frameworks โ React, Angular, and Astro โ that read the same .dcs/content.yaml and .dcs/seo.yaml contract. See CMS Framework Adapters for the full API and setup of each.
Quick Comparison โ
| Package | Purpose | Install Command |
|---|---|---|
@duffcloudservices/cms | Vue 3 composables & Vite plugins | pnpm add @duffcloudservices/cms |
@duffcloudservices/cms-react | React hooks & Vite plugins | pnpm add @duffcloudservices/cms-react |
@duffcloudservices/cms-angular | Angular services & build injector | pnpm add @duffcloudservices/cms-angular |
@duffcloudservices/cms-astro | Astro integration & helpers | pnpm add @duffcloudservices/cms-astro |
@duffcloudservices/cli | Site setup & configuration CLI | pnpm add -g @duffcloudservices/cli |
Getting Started โ
For new site integrations, the recommended workflow is:
- Install the CLI globally and run
dcs initto scaffold configuration - Install the CMS package as a project dependency
- Configure Vite plugins in your build config
- Follow the generated plans in
.plans/directory
See the Partner Onboarding Guide for a complete walkthrough.
