# @devframes/plugin-messages

> Devframe plugin for browsing, filtering, and dismissing the hub message feed.

Latest version **0.9.18** (published 2026-09-10) · MIT license · 0 weekly downloads

## Install

```sh
npm install @devframes/plugin-messages
pnpm add @devframes/plugin-messages
yarn add @devframes/plugin-messages
bun add @devframes/plugin-messages
```

Provides the command `devframe-messages`.

## Health

**Score 75/100 (B)** — status: active.

Positive: has types; esm support; no vulnerabilities; has provenance; recently updated; high maintenance score; high quality score.

Warnings: low downloads; pre 1.0.

## Facts

| | |
|---|---|
| Version | 0.9.18 |
| Published | 2026-09-10 |
| First published | 2026-07-06 |
| Weekly downloads | 0 |
| License | MIT |
| TypeScript types | bundled |
| Module format | ESM |
| Dependencies | 2 |
| Unpacked size | 477.5 KB |
| Known vulnerabilities | 0 |
| Install scripts | no |
| Provenance | attested (GitHub Actions) |
| GitHub stars | 176 |
| Author | Anthony Fu <anthonyfu117@hotmail.com> |
| Maintainers | antfu |
| Keywords | devframe, devframe-plugin, devtools, messages, notifications |

## Links

- npm: https://www.npmjs.com/package/@devframes/plugin-messages
- Repository: https://github.com/devframes/devframe
- Homepage: https://github.com/devframes/devframe#readme
- Issues: https://github.com/devframes/devframe/issues
- npm.io page: https://npm.io/package/@devframes/plugin-messages

## Dependencies (2)

- [cac](https://npm.io/package/cac.md) ^7.0.0
- [@devframes/service-open](https://npm.io/package/@devframes/service-open.md) 0.9.18

## Alternatives

- [update-check](https://npm.io/package/update-check.md) — 4.0M weekly downloads
- [react-native-onesignal](https://npm.io/package/react-native-onesignal.md) — 134.5K weekly downloads
- [react-redux-toastr](https://npm.io/package/react-redux-toastr.md) — 33.7K weekly downloads
- [@nocobase/plugin-notification-manager](https://npm.io/package/@nocobase/plugin-notification-manager.md) — 2.0K weekly downloads
- [react-simple-toasts](https://npm.io/package/react-simple-toasts.md) — 1.9K weekly downloads

## Recent versions

- 0.9.18 (latest) — 2026-09-10
- 0.9.17 — 2026-09-09
- 0.9.16 — 2026-09-08
- 0.9.15 — 2026-09-08
- 0.9.12 — 2026-09-04
- 0.9.11 — 2026-09-04
- 0.9.10 — 2026-09-03
- 0.9.9 — 2026-09-03
- 0.9.8 — 2026-09-01
- 0.9.7 — 2026-08-27
- 0.9.6 — 2026-08-27
- 0.9.5 — 2026-08-21
- 0.9.4 — 2026-08-20
- 0.9.3 — 2026-08-19
- 0.9.2 — 2026-08-19
- … 35 more at https://npm.io/package/@devframes/plugin-messages/versions

## README

# @devframes/plugin-messages

> [!WARNING] Experimental
> This devframe is experimental and may change without a major version bump until
> it stabilizes.

A built-in devframe that surfaces the hub message feed (`ctx.messages`) as a
portable panel: browse diagnostics and notifications from every mounted tool,
filter by level / source / category / label, inspect stack traces, element and
file positions, and jump to the offending file in your editor.

Ported from the built-in Messages view of
[`vitejs/devtools`](https://github.com/vitejs/devtools); rebuilt on devframe's
framework-neutral client (`connectDevframe`) with a Vue + Vite SPA, reading the
feed through `@devframes/hub`'s `listSince` delta API.

## Mount into a hub

```ts
import createMessagesDevframe from '@devframes/plugin-messages'

await hubContext.install(createMessagesDevframe())
```

The hub's `ctx.messages` feeds the panel live: every
`ctx.messages.add(...)` from any mounted tool shows up, updates stream over
the `devframe:messages:updated` broadcast, and dismissals write back through
the devframe's namespaced RPCs. On a plain (non-hub) context the devframe warns
(`DP_MESSAGES_0001`) and serves an empty feed.

## Embed the panel directly

```ts
import { mountMessages } from '@devframes/plugin-messages/client'

const handle = await mountMessages(document.querySelector('#panel')!, {
  rpc, // optional; reuse the host page's client
})
```

## Standalone

```bash
pnpx @devframes/plugin-messages
```

`pnpm dev` in this package self-hosts the SPA against a demo-seeded messages
feed, so the feed is lively without a full hub.

---
_Source: https://npm.io/package/@devframes/plugin-messages · Machine-readable twin of the npm.io package page. Health data is recomputed on every publish._