Tutorials

Learning paths: run a complete MDK site, build your own endpoint and dashboard, or wire MDK into a React app

New to MDK? See it run first

These are not a sequence. Run the finished site to see the whole stack, or run one mounted plugin to see a single route answer.

Run a mining site end to end

Run the full example: Workers, mock hardware, a Gateway API, an MCP server, and a live dashboard from one command

See a plugin serve your data

Watch one mounted plugin aggregate telemetry across two devices and answer an HTTP request

From 0.6.0 the Gateway serves only the routes its plugins provide, so getting Worker telemetry to a browser means mounting your own endpoint. Seeing a plugin serve your data shows that happening once, and building a Gateway plugin is how you write your own.

Build the whole vertical slice

Build a minimal single-page dashboard

Build from an empty directory: one Worker, one Gateway route, and one React page. Spans the backend and the front end, so take it when you want the full path rather than one concern

Get started with your framework

React

Pick a path: install and wire, a full hands-on tutorial, or your first component

Build with your AI agent

Wire Cursor or Claude once, then build dashboards from plain-language prompts

Explore the demo

Run the demo browser and page through the whole component library live

Next steps

Learn more about the high-level architecture: runtime stack and deployment modes
Compare deployment topologies: single process or supervised services
Run a site from the deployment guides
Integrate your own hardware by building a third-party Worker
Browse every runnable example: what each one demonstrates and how to start it
Contribute