> ## Documentation Index
> Fetch the complete documentation index at: https://docs.elata.bio/llms.txt
> Use this file to discover all available pages before exploring further.

# Troubleshooting

> Common setup failures and the fastest checks for Elata SDK integrations.

## `pnpm install` Did Not Create `node_modules` In My Scaffolded App

You likely created the app inside another `pnpm` workspace.

Run from the parent directory:

<CodeGroup>
  ```bash pnpm theme={null}
  pnpm --dir my-app --ignore-workspace install
  pnpm --dir my-app --ignore-workspace run dev
  ```

  ```bash npm theme={null}
  cd my-app
  npm install
  npm run dev
  ```
</CodeGroup>

***

## Web Bluetooth Is Unavailable

Check the following:

* Use Chrome or Edge
* Run on `https://` or `localhost`
* Make sure Bluetooth is enabled on the machine
* Do not expect this workflow to work in Safari or iOS

***

## `loadWasmBackend()` Returned `null`

Make sure your app is serving the packaged `pkg/rppg_wasm.js` and
`pkg/rppg_wasm_bg.wasm` assets from a path the browser can reach.

If you are unsure, compare your app with the scaffolded `rppg-demo` app.

***

## `initEegWasm()` Failed

Your app is probably not serving the packaged `wasm/` assets from
`@elata-biosciences/eeg-web` correctly.

Compare your asset layout with the scaffolded `eeg-demo` app.

<Tip>
  If you are using Vite, the two common fixes are: add `vite-plugin-wasm` and `vite-plugin-top-level-await`, or import the WASM asset URL directly and pass it to `initEegWasm(wasmUrl)`.
</Tip>

***

## I Am Not Sure Which Package I Need

Start with [Choose The Right Package](/sdk/guides/choose-the-right-package).

If you still just want the fastest path, use `create-elata-demo`.

***

## Next

<CardGroup cols={2}>
  <Card title="Choose A Package" icon="compass" iconType="light" href="/sdk/guides/choose-the-right-package">
    Package decision guide
  </Card>

  <Card title="Compatibility" icon="circle-check" iconType="light" href="/sdk/operations/compatibility">
    Browser, device, and tooling support
  </Card>
</CardGroup>