@notionhq/custom-blocks-dev-shell 0.1.4 → 0.1.6

package/README.md

@@ -1,24 +1,24 @@
 # Notion custom blocks dev shell
 
-A local preview shell for Notion custom block workers. It builds your worker,
+A local dev shell for Notion custom block workers. It builds your worker,
 reads the manifest declared by your `worker.customBlock(...)` calls, serves each
 block with your project's own Vite, and renders them in a mock Notion host with
 sample data sources you can bind against.
 
 ## Usage
 
-From anywhere inside your worker project:
+From anywhere inside your worker project, with the Notion CLI (v0.20.0+):
 
 ```bash
-npx @notionhq/custom-blocks-dev-shell
+ntn customblocks dev
 ```
 
 Then open http://localhost:9873.
 
 Options:
 
-- `--worker <dir>` — point at a worker directory explicitly instead of
-  detecting one from the current directory.
+- `[path]` — point at a worker directory explicitly instead of detecting one
+  from the current directory.
 - `--port <port>` — serve the shell UI somewhere other than 9873.
 - `--block-base-port <port>` — first port handed to the per-block dev servers
   (default 9876; blocks count up from there).
@@ -28,6 +28,9 @@ Options:
 One page per topic, shipped in this package's `docs/` so they're readable
 from `node_modules`:
 
+- [`docs/bindings.md`](./docs/bindings.md) — connecting blocks to data
+  sources: auto-mapping and compatibility rules, initialization, and live
+  rebinding.
 - [`docs/data-sources.md`](./docs/data-sources.md) — local data sources: the
   `src/data/*.json` file format, value shapes per property type, validation,
   and how missing sources are materialized from the worker's declared