@tetherto/mdk-react-devkit

The foundation entrypoint (@tetherto/mdk-react-devkit/foundation) provides domain-specific React components, hooks, and constants assembled from @tetherto/mdk-react-devkit/core. These are higher-level blocks for common Bitcoin mining application use cases.

Prerequisites

• Complete the installation

• Add the dependency to your app's package.json

{
  "dependencies": {
    "@tetherto/mdk-react-devkit": "*",
    "@tetherto/mdk-react-adapter": "*",
    "@tetherto/mdk-ui-core": "*"
  }
}

Run npm install from the monorepo root after your app is under apps/ so npm links workspace packages.

What's included

Operations centre

Domain-specific components for Bitcoin mining operations monitoring and management, including device explorers, vendor container UIs, dashboard widgets, charts, pool management, and data export.

See the operations centre reference for the full component list with demo links.

Settings

Pre-built settings UI for common administrative tasks:

• SettingsDashboard: main settings container with accordion sections
• FeatureFlagsSettings: toggle feature flags on/off
• HeaderControlsSettings: configure header display options
• ImportExportSettings: import/export configuration data
• RBACControlSettings: role-based access control settings
• User management modals: add, manage, and confirm user changes

Hooks

Reusable React hooks for notifications and shell layout and chart/dashboard transforms — see the full Hooks reference.

Constants

Shared constants for consistency across your application: permission definitions, role configurations, settings defaults, and error codes.

Import examples

// Import components
import { SettingsDashboard, FeatureFlagsSettings } from '@tetherto/mdk-react-devkit/foundation'

// Import from domain subpath when you only need settings-domain exports
import { SettingsDashboard } from '@tetherto/mdk-react-devkit/domain'

Troubleshooting

• npm install warns about engines.npm, or npm -v is 10.x on Node 22 — Upgrade npm, then rerun npm install and npm run build from the monorepo root.

Next steps

Consider the detailed reference material for the foundation entrypoint:

• Constants: permissions, roles, header controls, settings error codes
• Hooks: Components and Hooks: Utilities > Domain transforms
• Types: Device, Container, Alert, MinerStats, settings shapes
• Utilities: settings-utils (filtering, formatting, import/export)