@optimizely/cms-sdk

The official JavaScript/TypeScript SDK for building headless applications with Optimizely CMS. This library provides everything you need to fetch, render, and manage content from Optimizely CMS with full type safety and intelligent code completion.

Features

• Type-safe content modeling - Full TypeScript definitions for your content types
• Framework integration - First-class support for React and Next.js
• Live preview - Real-time content editing experience
• Rich text rendering - Advanced rich text component with extensibility
• DAM integration - Seamless digital asset management

Installation

npm install @optimizely/cms-sdk

Or using other package managers:

# pnpm
pnpm add @optimizely/cms-sdk

# yarn
yarn add @optimizely/cms-sdk

Quick Start

// Initialize the client
const client = new GraphClient('<YOUR_APP_SINGLE_KEY>', {
  graphUrl: 'https://your-cms-instance.com',
});

// Fetch content
const c = await client.getContentByPath(`/<SOME_URL>`);

Documentation

Full guides and documentation in the main repository:

Getting Started

• Installation - Set up your development environment
• Setup - Configure the SDK and CLI
• Modelling - Define your content types with TypeScript

Core Features

• Fetching Content - Query and retrieve content in your app
• Rendering (React) - Display content in React components
• Live Preview - Enable real-time content editing

Advanced Features

• Experience - Work with experiences and variations
• Display Settings - Configure content display options
• RichText Component (React) - Render rich text content
• DAM Assets - Manage digital assets
• Client Utils - Utility functions and helpers

Best Practices

This SDK works best when used with the @optimizely/cms-cli package, which enables code-first content modeling by syncing your TypeScript definitions to Optimizely CMS.

npm install -D @optimizely/cms-cli

For complete setup instructions, see the main repository README.

Support

• Community Slack - Join the Optimizely Community Slack
• GitHub Issues - Report bugs or request features on GitHub

License

Apache License 2.0

Built by the Optimizely CMS Team | Documentation | GitHub