Explore the demo

This page presents a copy/paste method to clone the MDK UI monorepo, run the demo, and browse the full component library live.

Prerequisites

• Node.js 20+
• npm 11+ (upgrade npm if npm -v shows 10.x on Node 22)
• React 19+ and react-dom 19+

Run the demo

One copy/paste: four steps — clone, install, build, run.

# Requires an SSH key configured for your GitHub account
git clone git@github.com:tetherto/mdk.git
cd mdk
npm install && npm run build
npm run dev:demo

Open http://localhost:5173/mdk. You'll land in the demo browser — a sidebar of the full MDK component library, covering core primitives (buttons, inputs, tables, charts, dialogs) and mining-domain components (operations centre, vendor containers, alerts, pool manager, settings).

What the demo wires

The demo app uses @tetherto/mdk-ui-core, @tetherto/mdk-react-adapter, and @tetherto/mdk-react-devkit with <MdkProvider>.

Next steps

• Quickstart: install all three packages and wrap your app in MdkProvider
• Wire a React app: scaffold an app with MdkProvider and adapter hooks
• Learn more about the React MDK UI Kit