# @bubblydoo/uxp-toolkit-react

> [![NPM Version](https://img.shields.io/npm/v/@bubblydoo/uxp-toolkit-react)](https://www.npmjs.com/package/@bubblydoo/uxp-toolkit-react)

Latest version **0.0.23** (published 2026-09-24) · MIT license · 0 weekly downloads

## Install

```sh
npm install @bubblydoo/uxp-toolkit-react
pnpm add @bubblydoo/uxp-toolkit-react
yarn add @bubblydoo/uxp-toolkit-react
bun add @bubblydoo/uxp-toolkit-react
```

## 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.0.23 |
| Published | 2026-09-24 |
| First published | 2026-01-27 |
| Weekly downloads | 0 |
| License | MIT |
| TypeScript types | none |
| Module format | ESM |
| Dependencies | 1 |
| Unpacked size | 15 KB |
| Known vulnerabilities | 0 |
| Install scripts | no |
| GitHub stars | 19 |
| Author | Hans Otto Wirtz |
| Maintainers | hansottowirtz, krystianpiatkowski, leo-bubblydoo, jeremy_navarro |

## Links

- npm: https://www.npmjs.com/package/@bubblydoo/uxp-toolkit-react
- Repository: https://github.com/bubblydoo/uxp-toolkit
- Homepage: https://github.com/bubblydoo/uxp-toolkit/tree/main/packages/uxp-toolkit-react
- Issues: https://github.com/bubblydoo/uxp-toolkit/issues
- npm.io page: https://npm.io/package/@bubblydoo/uxp-toolkit-react

## Dependencies (1)

- [@lukemorales/query-key-factory](https://npm.io/package/@lukemorales/query-key-factory.md) ^1.3.4

## Recent versions

- 0.0.23 (latest) — 2026-09-24
- 0.0.22 — 2026-05-20
- 0.0.21 — 2026-05-20
- 0.0.20 — 2026-04-10
- 0.0.19 — 2026-04-09
- 0.0.18 — 2026-03-16
- 0.0.17 — 2026-02-17
- 0.0.16 — 2026-02-17
- 0.0.15 — 2026-02-15
- 0.0.14 — 2026-02-11
- 0.0.13 — 2026-02-05
- 0.0.12 — 2026-02-05
- 0.0.11 — 2026-02-02
- 0.0.10 — 2026-01-31
- 0.0.9 — 2026-01-31
- … 7 more at https://npm.io/package/@bubblydoo/uxp-toolkit-react/versions

## README

# @bubblydoo/uxp-toolkit-react

[![NPM Version](https://img.shields.io/npm/v/@bubblydoo/uxp-toolkit-react)](https://www.npmjs.com/package/@bubblydoo/uxp-toolkit-react)

React hooks for Photoshop UXP plugins. Generic, non–app-specific utilities built on `@bubblydoo/uxp-toolkit`.

For a good example of how to use this package, see the [Example Layers Plugin](../example-layers-plugin).

## Peer dependencies

- `react` (^18 or ^19)
- `@tanstack/react-query` (^5)
- `@bubblydoo/uxp-toolkit` (workspace)
- `zod` (^4)

## Exports

- **useEventListenerSkippable** – Subscribe to events with optional skip/filter so triggers can be queued or ignored
- **useApplicationInfoQuery** – React Query for Photoshop application info (e.g. panel list)
- **useIsPluginPanelVisible** – Whether the plugin panel is visible (optionally for a given `panelId`)
- **useOnDocumentEdited** – Run a callback when the given document is edited (select, delete, make, set, move, close, show, hide, etc.)
- **useActiveDocument** – Sync external store for the current active document
- **useOnDocumentLayersEdited** – Run a callback when layers change (delete, make, set, move, close)
- **useOnDocumentLayersSelection** – Run a callback when layer selection changes (select, deselect)
- **useOnEvent** – Run a callback for arbitrary Photoshop action events on a given document
- **useOpenDocuments** – Sync external store for the list of open documents

All document/event hooks that take a `document` only fire when that document is the active document and (where applicable) when the plugin panel is visible.

---
_Source: https://npm.io/package/@bubblydoo/uxp-toolkit-react · Machine-readable twin of the npm.io package page. Health data is recomputed on every publish._