Skip to content

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

@duffcloudservices/cms on npm

Key Features:

  • useTextContent — Text content with build-time injection and runtime overrides
  • useSEO — SEO configuration with meta tags, Open Graph, Twitter Cards, JSON-LD
  • useReleaseNotes — Fetch and display versioned release notes
  • useSiteVersion — 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

@duffcloudservices/cli on npm

Key Features:

  • dcs init — Initialize DCS integration for a customer site
  • dcs validate — Validate existing .dcs configuration
  • dcs plans — Generate AI-assisted integration plans
  • dcs login — Authenticate via Google OAuth (device flow)
  • dcs sites — List sites you have access to manage

→ Full @duffcloudservices/cli Documentation


Quick Comparison

PackagePurposeInstall Command
@duffcloudservices/cmsRuntime composables & Vite pluginspnpm add @duffcloudservices/cms
@duffcloudservices/cliSite setup & configuration CLIpnpm add -g @duffcloudservices/cli

Getting Started

For new site integrations, the recommended workflow is:

  1. Install the CLI globally and run dcs init to scaffold configuration
  2. Install the CMS package as a project dependency
  3. Configure Vite plugins in your build config
  4. Follow the generated plans in .plans/ directory

See the Partner Onboarding Guide for a complete walkthrough.

Duff Cloud Services Documentation