Tutorials
Learning paths: run a complete MDK site, build your own endpoint and dashboard, or wire MDK into a React app
New to MDK? Run a site first
Two tutorials cover the backend path, and they are not a sequence. Run the finished example to see the whole stack working, then build the smallest version of it yourself when you want your own data on your own routes.
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
Build a minimal single-page dashboard
Build your own: one Worker, one Gateway route, and one React page from an empty directory
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. Building a dashboard teaches that directly, and adding custom plugins to the Gateway HTTP API is the reference for it.
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