Chameleon 🦎

A server-side A/B/n experimentation library for Node.js. Define experiments and variations, assign users to variations deterministically, and read assignments from memory in microseconds — with experiment config stored durably in cloud object storage (e.g. Amazon S3).

npm install chameleonjs   # package name (the project is "Chameleon")

Status: 🌱 Planning / relocation. Chameleon is the open-source evolution of an existing, battle-tested A/B/n library (published on npm as aws-chameleon). This repo is the new home: we're relocating it to a personal namespace, rebranding to chameleonjs, and revamping it (TypeScript rewrite, storage-adapter architecture, concurrency-safe writes). No functional code here yet — see the planning notes.

Where to look

All current thinking lives in docs/research/ — what Chameleon is, the relocation + rebrand + revamp plan, and the naming/SEO decisions. Start with the research index.

Conventions

Personal project under sharvilk — not affiliated with any employer. Follows the personal-repo conventions in ~/sharvil/README.md: kebab-case-ish folder, own git repo, personal git identity, and — once implementation starts — the full engineering-standards baseline (TypeScript strict, lint, format, tests, CI). License: Apache-2.0.