Self-hosted feature flag and controlled rollout platform with targeting rules, reusable segments, percentage rollouts, kill switches, and TypeScript & Python SDKs.
Shipping new capabilities safely requires separating code deployment from feature exposure. FeatureDock provides a self-hosted Express + SQLite control plane with multi-environment versioning, deterministic consistent-hashing percentage rollouts, emergency kill switches, full audit diffs, and lightweight TypeScript and Python SDKs with local snapshot caching.
- Projects, Environments & Config Versioning: Automatic
development,staging, andproductionenvironments per project with scopedfd_sdk_keys andETag(304 Not Modified) snapshot sync. - Rich Flag Types & Evaluation: Supports
boolean,string,number, andjsonflags evaluated across kill switches, user targets, group targets, segments, custom rules, and deterministic SHA-256 percentage rollouts. - RBAC, Tokens & Audit History: JWT/scrypt user accounts (
admin,editor,viewer),fd_adm_API tokens, before/after audit diffs, and SDK telemetry tracking. - TypeScript & Python SDKs: Built-in
FeatureDock(TypeScript) andFeatureDockClient(Python) clients with local TTL caching.
- Requirements: Node.js 22.5+ (Python 3.11+ optional for Python SDK)
- Clone:
git clone https://github.com/fully-ai/featuredock.git && cd featuredock - Install & Build:
./scripts/install.sh(Windows:.\scripts\install.ps1) - Configure: Copy
.env.exampleto.envif settingFEATUREDOCK_JWT_SECRETorFEATUREDOCK_PORT - Start:
./scripts/dev.sh(Windows:.\scripts\dev.ps1) - Open Dashboard:
http://127.0.0.1:8096 - Run Tests:
./scripts/test.sh(Windows:.\scripts\test.ps1) - Stop:
Ctrl+C(ordocker compose down)
import { FeatureDock } from "./sdk/typescript/dist/index.js";
const client = new FeatureDock({
apiUrl: "http://127.0.0.1:8096",
sdkKey: process.env.FEATUREDOCK_SDK_KEY!
});
const enabled = await client.isEnabled(
"new-dashboard",
{ userId: "user-123" }
);from featuredock_sdk import FeatureDockClient
client = FeatureDockClient("http://127.0.0.1:8096", sdk_key="fd_sdk_...")
enabled = client.is_enabled("new-dashboard", {"userId": "user-123"})flowchart LR
UI["Control Plane UI (public/index.html)"] -->|Bearer JWT / fd_adm_| API["Express Control & SDK API"]
API --> DB["SQLite WAL (projects, envs, flags, audit, telemetry)"]
TS["TypeScript SDK"] -->|"GET /api/sdk/v1/snapshot (ETag)"| API
PY["Python SDK"] -->|"GET /api/sdk/v1/snapshot (ETag)"| API
FEATUREDOCK_JWT_SECRET="replace-with-strong-secret" docker compose up --build -d
docker compose logs -f
docker compose downSee CONTRIBUTING.md, SECURITY.md, and LICENSE (Apache 2.0).