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


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 โ€‹

PackagePurposeInstall Command
@duffcloudservices/cmsVue 3 composables & Vite pluginspnpm add @duffcloudservices/cms
@duffcloudservices/cms-reactReact hooks & Vite pluginspnpm add @duffcloudservices/cms-react
@duffcloudservices/cms-angularAngular services & build injectorpnpm add @duffcloudservices/cms-angular
@duffcloudservices/cms-astroAstro integration & helperspnpm add @duffcloudservices/cms-astro
@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.