# @radiantailabs/hubble-extension-sdk

> Framework-neutral contracts for Hubble dashboard extensions

Latest version **0.6.0** (published 2026-09-16) · Apache-2.0 license · 0 weekly downloads

## Install

```sh
npm install @radiantailabs/hubble-extension-sdk
pnpm add @radiantailabs/hubble-extension-sdk
yarn add @radiantailabs/hubble-extension-sdk
bun add @radiantailabs/hubble-extension-sdk
```

## Health

**Score 60/100 (C)** — status: active.

Positive: esm support; no vulnerabilities; recently updated; high maintenance score.

Warnings: low downloads; no types; pre 1.0.

## Facts

| | |
|---|---|
| Version | 0.6.0 |
| Published | 2026-09-16 |
| First published | 2026-09-16 |
| Weekly downloads | 0 |
| License | Apache-2.0 |
| TypeScript types | none |
| Module format | ESM |
| Node | >=18.0.0 |
| Dependencies | 0 |
| Unpacked size | 28.3 KB |
| Known vulnerabilities | 0 |
| Install scripts | no |
| Maintainers | jacktbeaumont, hsehskad |

## Links

- npm: https://www.npmjs.com/package/@radiantailabs/hubble-extension-sdk
- Repository: https://github.com/RadiantAILabs/hubble
- Homepage: https://github.com/RadiantAILabs/hubble#readme
- Issues: https://github.com/RadiantAILabs/hubble/issues
- npm.io page: https://npm.io/package/@radiantailabs/hubble-extension-sdk

## Recent versions

- 0.6.0 (latest) — 2026-09-16
- 0.7.0-alpha.1 (alpha) — 2026-09-24

## README

# Hubble dashboard extension SDK

Framework-neutral TypeScript contracts for creating Hubble dashboard
extensions.

```ts
import {
  defineExtension,
  projectNavigationItem,
} from "@radiantailabs/hubble-extension-sdk";

export default defineExtension({
  id: "example-extension",
  routes: [
    {
      id: "analytics",
      path: "/analytics",
      mount: ({ target }) => {
        target.textContent = "Analytics";
        return () => target.replaceChildren();
      },
    },
  ],
  slots: [
    projectNavigationItem({
      id: "analytics-navigation",
      route: "analytics",
      label: "Analytics",
      icon: "presentationchart",
    }),
  ],
});
```

The host owns routing, navigation layout, and contribution cleanup. Extensions
mount into host-provided elements and use `DashboardHost` for authenticated
requests and navigation. `host.http.baseUrl` is the absolute, deployment-aware
application URL, and `host.http.fetch` is a standard fetch-compatible transport
with Hubble's session and login handling. Generated API clients can use both
values directly.

Tests can import `createTestDashboardHost` from
`@radiantailabs/hubble-extension-sdk/testing` to override the host
services exercised by the contribution.

## Development

```sh
bun install
bun run check
bun run test
bun run build
```

See the package [changelog](CHANGELOG.md) for notable changes.

---
_Source: https://npm.io/package/@radiantailabs/hubble-extension-sdk · Machine-readable twin of the npm.io package page. Health data is recomputed on every publish._