@buoy-gg/jotai 6.0.0 → 7.0.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (2) hide show
  1. package/README.md +65 -0
  2. package/package.json +17 -6
package/README.md ADDED
@@ -0,0 +1,65 @@
1
+ # @buoy-gg/jotai
2
+
3
+ [![npm version](https://img.shields.io/npm/v/@buoy-gg/jotai?style=flat-square&labelColor=1c1c1c&color=10B981)](https://www.npmjs.com/package/@buoy-gg/jotai) [![npm downloads](https://img.shields.io/npm/dm/@buoy-gg/jotai?style=flat-square&labelColor=1c1c1c&color=10B981)](https://www.npmjs.com/package/@buoy-gg/jotai)
4
+
5
+ **Jotai devtools on the device — every atom write shows `prev → next`, with per-atom history and live values.**
6
+
7
+ Part of [Buoy](https://github.com/Buoy-gg/buoy) — devtools that live inside your React Native app. Install it and it auto-appears in the floating menu from [`@buoy-gg/core`](https://www.npmjs.com/package/@buoy-gg/core).
8
+
9
+ ## Install
10
+
11
+ ```bash
12
+ npm install @buoy-gg/core @buoy-gg/jotai
13
+ ```
14
+
15
+ ## Quick start
16
+
17
+ One `watchAtoms(store, atoms)` call at module scope — pass your Jotai store and a named map of atoms. No wrappers, no `atomWithDevTools`, no changes to existing atoms; observation is subscribe-only.
18
+
19
+ ```tsx
20
+ import { getDefaultStore } from 'jotai';
21
+ import { watchAtoms } from '@buoy-gg/jotai';
22
+ import { countAtom } from './atoms/count';
23
+ import { authAtom } from './atoms/auth';
24
+ import { cartAtom } from './atoms/cart';
25
+
26
+ watchAtoms(getDefaultStore(), {
27
+ countAtom,
28
+ authAtom,
29
+ cartAtom,
30
+ });
31
+ ```
32
+
33
+ Using a `<Provider>` with a custom store? Pass it instead:
34
+
35
+ ```tsx
36
+ const myStore = createStore();
37
+ watchAtoms(myStore, { countAtom, authAtom });
38
+ ```
39
+
40
+ Registered atoms appear in the Jotai tool inside the floating menu.
41
+
42
+ ## What you get
43
+
44
+ - **`prev → next` on every event** — see `0 → 5` or `null → {name, email}` at a glance, no tapping in for simple updates
45
+ - **Live Atoms tab** — every registered atom with its current value, value type, and change count, updated in real time
46
+ - **Per-atom history** — jump from any atom straight to its filtered event timeline to trace one piece of state through a flow
47
+ - **No-change flags** — writes that fired but didn't actually change the value are called out
48
+ - **Three-tab detail view** — change metadata, full value tree, and a side-by-side before/after diff
49
+ - **Atom color coding** — each atom keeps a consistent color across tabs and detail views
50
+ - **Search & filter** — find events by atom name or value content; hide noisy atoms everywhere at once
51
+ - **Recording toggle** — pause atom capture when you need to focus, resume when ready
52
+
53
+ ## Desktop & AI
54
+
55
+ The same live session streams to [Buoy Desktop](https://github.com/Buoy-gg/Buoy-Desktop) (free, macOS/Windows/Linux) and to Claude Code or Cursor via the [Buoy MCP server](https://buoy.gg/buoy/latest/docs/mcp).
56
+
57
+ ## Free vs Pro
58
+
59
+ Every tool is free. [Pro](https://buoy.gg/pricing) unlocks production builds, the MCP server, and unlimited capture. Every weekend, Pro features unlock free for everyone.
60
+
61
+ ---
62
+
63
+ 📚 [Full docs](https://buoy.gg/buoy/latest/docs/tools/jotai) · [All Buoy tools](https://github.com/Buoy-gg/buoy)
64
+
65
+ Proprietary software. © Buoy LLC. [Terms](https://buoy.gg/terms)
package/package.json CHANGED
@@ -1,7 +1,7 @@
1
1
  {
2
2
  "name": "@buoy-gg/jotai",
3
- "version": "6.0.0",
4
- "description": "Jotai atom DevTools for React Native",
3
+ "version": "7.0.0",
4
+ "description": "Jotai devtools inside your React Native app — every atom write shows prev → next, with per-atom history & live values. Part of Buoy devtools.",
5
5
  "main": "lib/commonjs/index.js",
6
6
  "module": "lib/module/index.js",
7
7
  "types": "lib/typescript/index.d.ts",
@@ -26,8 +26,8 @@
26
26
  ],
27
27
  "sideEffects": false,
28
28
  "dependencies": {
29
- "@buoy-gg/shared-ui": "6.0.0",
30
- "@buoy-gg/license": "6.0.0"
29
+ "@buoy-gg/license": "7.0.0",
30
+ "@buoy-gg/shared-ui": "7.0.0"
31
31
  },
32
32
  "peerDependencies": {
33
33
  "jotai": ">=2.0.0",
@@ -61,17 +61,28 @@
61
61
  },
62
62
  "repository": {
63
63
  "type": "git",
64
- "url": "https://github.com/LovesWorking/react-native-buoy.git",
64
+ "url": "https://github.com/Buoy-gg/buoy.git",
65
65
  "directory": "packages/jotai"
66
66
  },
67
67
  "bugs": {
68
68
  "url": "https://github.com/LovesWorking/react-native-buoy/issues"
69
69
  },
70
- "homepage": "https://github.com/LovesWorking/react-native-buoy/tree/main/packages/jotai#readme",
70
+ "homepage": "https://buoy.gg/tools/jotai",
71
71
  "publishConfig": {
72
72
  "access": "public",
73
73
  "tag": "latest"
74
74
  },
75
+ "keywords": [
76
+ "react-native",
77
+ "expo",
78
+ "devtools",
79
+ "debugging",
80
+ "react-native-devtools",
81
+ "flipper-alternative",
82
+ "jotai",
83
+ "atoms",
84
+ "state-management"
85
+ ],
75
86
  "scripts": {
76
87
  "build": "bob build",
77
88
  "typecheck": "tsc --noEmit",