This repository contains a full-stack demo application that represents a typical eCommerce checkout flow, steered live by Unleash feature flags. Toggle a flag in the Unleash admin UI and watch the application change instantly (across frontend and backend), with no redeployment.
Feature flags are evaluated against a cloud-hosted Unleash instance. Self-paced workshop? Start a 14-day free trial (no credit card required): Start Free Trial.
It is a deliberately small but realistically structured app:
- a React.js-based storefront
- a Node.js Fastify checkout backend
- isolated fake payment providers integrated via redirect-based payment flow:
The demo contains a few feature flags built-in already, but the main goal is to demonstrate the experience of the application team using a paved golden path to ship code safely. The application code is prepared to support, either for replacing the existing payment provider completely or adding an alternative customer journey path allowing to choose a vendor during the checkout. It's up to you. However, by leveraging your preferred AI coding assistant, we want to make sure that the code is safe to ship by aligning to FeatureOps principles and pillars.
| Tool | Minimum version | Required? |
|---|---|---|
| Node.js | ^22.0.0 | ✅ |
| GNU Make | any | ✅ |
| Docker | ^29.0.0 | |
| Docker Compose | ^5.0.0 | |
| pnpm | ^11.8.0 |
In addition to the above, you'll need git, curl, and jq too.
If you want to prepare for the workshop ahead of time, git clone this repository. Then, inside the cloned repository, run the following command – and follow the instructions printed in the console:
make workshop-pre-checkAs an optional step if you're planning to use Docker, you can pre-pull all the necessary Docker images:
make docker-pullThen, during the actual workshop you will follow the guidelines from the lecturer. Additionally, all materials are available for you in this repository. You can follow the steps here: Virtual Workshop Steps Overview.
You can run the whole thing on your own, against an Unleash free trial instance. make workshop-configure will offer to create your project, its feature flags, and its SDK tokens for you.
- Sign up for an Unleash free trial (14 days, no credit card required).
git clonethis repository, then runmake workshop-pre-check.- Create a Personal Access Token (PAT) in the Unleash.
- Enable the remote MCP server in the Unleash admin UI.
- Run
make workshop-configureand follow the prompts (it asks before creating anything). - In another terminal:
make dev. - Run
make workshop-final-check, then follow the workshop steps from Step 4 onward.
The full walkthrough - including what differs from the facilitated workshop, how to use an existing Unleash instance, and how to set things up by hand - is in the self-paced README file.
- Virtual hands-on workshop during PlatformCon 2026 Flagship Week.