fix(css,preview): scope utilities under the view root, preview with real boards and foreign css

README.md

@@ -18,3 +18,19 @@ make zip                                           # distributable
 ```
 
 After `make install` turn on plugin in settings.
+
+`styles.css` is Tailwind output run through `scripts/scope-css.mjs`: every
+selector is prefixed with `:is(.bcal-root, .bcal-root *)`. Other plugins built
+with Tailwind put their utilities into the same `utilities` cascade layer, and
+without the extra specificity whichever plugin loaded last would win (their
+`.hidden` over our `@container` variants, for one).
+
+Preview knobs, all optional:
+
+```bash
+VAULT=/path/to/vault npm run preview               # the vault's theme
+BOARDS=/path/to/vault/Boards npm run preview       # real boards, not fixtures
+EXTRA_CSS=/path/to/other-plugin/styles.css …       # another plugin's css, loaded after ours
+open 'http://localhost:4173/?groupBy=due&railCollapsed=1#edit-date'   # prefs + scene
+node preview/shot.mjs out.png 'http://localhost:4173/#date'           # screenshot + console
+```