dashboard: browser checks

1 files changed, 11 insertions, 0 deletions

diff --git a/docs/development.md b/docs/development.md
index 519d64c..90715f9 100644
--- a/docs/development.md
+++ b/docs/development.md
@@ -38,6 +38,17 @@ links down, as now and along the writer's tree (`swarm/topology/tests.rs`,
 them alone: `cargo test --release --features mycelium,libp2p,tor,dashboard
 bench_propagation -- --ignored --nocapture`.
 
+The dashboard's page has browser checks (`src/api/dashboard/check.js`): it loads
+without errors, its peers table and map draw what the state says, and a map of 300
+members doesn't hold the page up. They need Node.js with Playwright's library and its
+Chromium, so they run only when asked; `src/api/dashboard/check.nix` gives all three
+from nixpkgs (Playwright's library and browsers of one version, nothing from npm):
+
+```
+nix-shell src/api/dashboard/check.nix --run \
+  'cargo test --features dashboard dashboard_in_a_browser -- --ignored'
+```
+
 The simulations send the wire encoding alone, as libp2p and Tor do; a simulated net
 can put messages into a transport's envelope instead (`SimNet::with_codec`), and every
 message kind is round-tripped through each codec (`wire::samples`).