The `configcat-js-ssr` package provides an official ConfigCat SDK for integrating feature flags into Server-Side Rendered (SSR) JavaScript applications, such as those built with Nuxt.js or Vue.js. It allows developers to manage feature toggles remotely via the ConfigCat Dashboard, enabling the separation of releases from deployments and targeting specific user groups. Currently at version 8.5.3, this SDK is in maintenance mode, superseded by the unified ConfigCat SDK for JavaScript. It receives only critical security patches, with official support ending on August 31, 2026. Developers are strongly encouraged to migrate to the new unified SDK, which offers a consolidated experience for both browser and Node.js environments and removes the need for a separate SSR-specific SDK. Its key differentiator was its specialized focus on SSR environments, but this has been absorbed by the unified SDK.
npm install configcat-js-ssrVerified import paths — ran on the pinned version, not inferred.
This quickstart demonstrates how to initialize the ConfigCat client, fetch a feature flag value for both a generic and a specific user, and dispose of the client.
Migrate to the new unified SDK as described in the official ConfigCat documentation: https://configcat.com/docs/sdk-reference/js-ssr/#migration-to-the-new-sdk
Plan and execute migration to the unified ConfigCat SDK before the end-of-life date to ensure continued security and support.
Always upgrade to the latest available version of `configcat-js-ssr` to ensure all transitive dependency security fixes are applied. Currently, `v8.5.3` or newer is recommended.
Be aware of the singleton behavior. If truly distinct client configurations are needed for the same SDK key within an application's lifecycle, ensure previous instances are explicitly disposed of, or consider using different SDK keys if appropriate. For most SSR scenarios, a single client per SDK key is desired.
Verify your SDK Key directly from the ConfigCat Dashboard. Ensure there are no typos, extra spaces, or missing characters. Copy-pasting directly is recommended. Also, check for environment variable issues if the key is loaded from there.
Ensure `getClient()` is called with a valid SDK Key and that the returned client object is assigned and used. Also, verify that the `import { getClient } from 'configcat-js-ssr';` or `import * as configcat from 'configcat-js-ssr';` statement is correct and executes successfully.