Skip to main content

​
Package And Tooling Expectations

SurfaceBrowser runtimeNode.jsNotes
@elata-biosciences/create-elata-demon/a>= 18CLI scaffolder only
@elata-biosciences/eeg-webmodern browser with WebAssembly>= 20browser usage depends on serving packaged WASM assets
@elata-biosciences/eeg-web-bleChrome or Edge with Web Bluetooth>= 20depends on @elata-biosciences/eeg-web
@elata-biosciences/rppg-webmodern browser with camera and WebAssembly>= 20packaged WASM assets must be reachable by the browser

​
Browser Support

WorkflowChrome / EdgeSafari macOSSafari iOSNotes
create-elata-demon/an/an/ascaffolder runs in Node
EEG WASM with eeg-webSupportedSupportedSupportedrequires packaged wasm/ assets
Muse browser BLE with eeg-web-bleSupported in secure contextNot supportedNot supportedrequires Web Bluetooth
rPPG with rppg-webSupportedSupportedSupported with camera permissionsrequires packaged pkg/ assets

​
Web Bluetooth Expectations

  • Use Chrome or Edge.
  • Run on https:// or localhost.
  • Enable Bluetooth on the machine.
  • Expect Safari and iOS browser BLE to be unsupported for this workflow.
eeg-web-ble requires Web Bluetooth and an https:// origin or localhost. Safari and iOS do not support Web Bluetooth for Muse browser workflows.

​
Supported Device Classes

  • Muse 2 and Muse S classic BLE devices
  • Muse S Athena protocol v2 devices
  • The synthetic Muse-compatible BLE bridge used for testing

​
Safari And iOS Notes

  • eeg-web can be used as a browser-side WASM package on Safari when your app serves its packaged assets correctly.
  • eeg-web-ble is not a Safari or iOS browser workflow. Use a native app shell with CoreBluetooth or a companion bridge app streaming frames over WebSocket.
  • rppg-web can run on Safari and iOS, but camera permissions and packaged WASM delivery still need to be correct.

​
Package Manager Notes

Generated demo apps work with pnpm or npm. This repo prefers pnpm for local development. If you scaffold a demo app inside another pnpm workspace and do not add it to that workspace, use: 
pnpm --dir my-app --ignore-workspace install
pnpm --dir my-app --ignore-workspace run dev

Troubleshooting

Common failures and fixes

Choose A Package

Package decision guide

Muse Device

Protocol details and browser support