optimizely

javascript-sdk: Run Optimizely Feature Experiments in JavaScript

Optimizely's official TypeScript and JavaScript SDK for Feature Experimentation and legacy Full Stack, built for modern browsers and Node.js. It provides modular configuration, event processing, and audience targeting for experiments and feature management.

ActiveTypeScriptApache-2.0JavaScriptLibraryDeveloper Tools
Stars
81
Forks
86
Last commit
3 days ago
Contributors
50
Releases, 12 months
8

Our take

Activeregular commits and releases

Health score

57/100

How it is scored
Activity
56
Community
79
Issues
53
Pull requests
41

This is an actively maintained, Apache-2.0 SDK for teams adopting Optimizely's experimentation services, with recent releases and contributions from a broad contributor base.

Good fit if

  • Your application uses modern JavaScript or TypeScript on Node.js or in a supported browser and needs Optimizely Feature Experimentation.
  • You want modular control over project configuration, event processing, and ODP integration.
  • You value an established project with regular commits and releases, 50 contributors, and no strong reliance on a single contributor.

Look elsewhere if

  • You need an experimentation platform independent of Optimizely's services.
  • Your runtime is outside the documented support targets and you need formal compatibility guarantees.
  • You are adopting it for legacy Optimizely Full Stack and need a long-term path beyond that legacy offering.
All health signals
Last commit2026-11-13 (3 days ago)
Commits, last 90 days14
Releases, last 12 months8 (latest v6.7.0, 2026-11-03)
Contributors50 (top contributor: 22% of commits)
Issues closed, last 90 days2
Pull requests merged, last 90 days14 (typically merged in 2 days)
Project age10 years

Checked on 2026-11-17 with the GitHub API.

Project history

Daily GitHub snapshots since Nov 17, 2026. History covers stars and forks; health signals are not tracked historically.

Selected snapshot

Stars

81

Forks

86

More snapshots will appear as the daily collection continues.

Overview

The Optimizely JavaScript SDK is Optimizely's official TypeScript and JavaScript client for Feature Experimentation and legacy Optimizely Full Stack. It lets product and engineering teams evaluate feature flags and experiments in applications, and send events for experimentation workflows. The SDK targets modern browsers and Node.js, with a shared codebase designed to support browser, Node.js, React Native, and universal builds.

Its modular architecture lets applications configure project data loading, event processing, and Optimizely Data Platform (ODP) integration as separate components. It is aimed at teams already using Optimizely's experimentation and feature-management services, rather than a standalone experimentation platform.

Key Features

  • Creates an Optimizely client from configurable project configuration, event processor, and ODP manager components.
  • Supports polling project configuration, including optional automatic updates and update intervals.
  • Provides batch event processing with configurable batch size and flush interval.
  • Integrates ODP for segments and audience targeting.
  • Offers browser, Node.js, and universal entry points, including a browser UMD bundle.
  • Includes platform-isolation checks to keep platform-specific code out of incompatible builds.
  • Supports modern browser and Node.js environments, with edge-platform starter kits maintained in separate repositories.

Use Cases

  • Product teams can evaluate feature flags and experiment variations in a JavaScript web application.
  • Node.js teams can use Optimizely experimentation and feature management in server-side services.
  • Teams building edge applications can use the SDK with a compatible starter kit for platforms such as Cloudflare Workers or Lambda@Edge.
  • Developers upgrading an existing Optimizely JavaScript integration can follow the migration guidance for the modular SDK architecture.

What you need

Detected in the repository

  • Node.js >=18.0.0 (from package.json)
  • A test suite and automated checks on GitHub Actions

License in plain words

Apache-2.0permissive

  • Commercial use: yes
  • Modify and redistribute: yes
  • You must keep: the license, the NOTICE file and a note of your changes
  • Share your changes: no
  • Includes an explicit patent grant from the contributors:

A summary, not legal advice: the LICENSE file is what applies.

Getting Started

Install the package:

npm install --save @optimizely/optimizely-sdk

See the README and JavaScript SDK documentation for setup and configuration details.

Alternatives

  • sixpack: Sixpack provides a server-side A/B testing service with HTTP client libraries, while javascript-sdk evaluates experiments and feature flags in applications.
ProjectLanguageLicenseStarsStatus
javascript-sdkTypeScriptApache-2.081Active
sixpackPythonBSD-2-Clause1.8kInactive

Considerations

  • The documented baseline is Node.js 18 or newer and modern ES6-compliant browsers. Older Node.js versions may work, but are not formally supported.
  • SDK instances can schedule background tasks for polling, batched events, and ODP. Close instances when no longer needed, or consider the documented disposable option for server-side rendering scenarios.
  • The README identifies Optimizely Full Stack as legacy. Teams starting new work should confirm that the relevant Optimizely product and integration match their plans.
  • The project is licensed under Apache-2.0. Review its terms for your distribution and use requirements.

Repository: optimizely/javascript-sdk

Found this useful?

Share it with someone who would like javascript-sdk.

Comparisons