clockworklabs/SpacetimeDB · error · Error

useSpacetimeDB must be used within a SpacetimeDBProvider com

Error message

useSpacetimeDB must be used within a SpacetimeDBProvider component. Did you forget to add a `SpacetimeDBProvider` to your component tree?

What it means

Error "useSpacetimeDB must be used within a SpacetimeDBProvider component. Did you forget to add a `SpacetimeDBProvider` to your component tree?" thrown in clockworklabs/SpacetimeDB.

Source

Thrown at crates/bindings-typescript/src/solid/useSpacetimeDB.ts:13

import { createContext, useContext } from 'solid-js';
import type { ConnectionState } from './connection_state';

export const SpacetimeDBContext = createContext<ConnectionState | undefined>(
  undefined
);

// Throws an error if used outside of a SpacetimeDBProvider
// Error is caught by other hooks like useTable so they can provide better error messages
export function useSpacetimeDB(): ConnectionState {
  const context = useContext(SpacetimeDBContext) as ConnectionState | undefined;
  if (!context) {
    throw new Error(
      'useSpacetimeDB must be used within a SpacetimeDBProvider component. Did you forget to add a `SpacetimeDBProvider` to your component tree?'
    );
  }
  return context;
}

View on GitHub (pinned to 524b4487d9)

When it happens

Trigger: Thrown at crates/bindings-typescript/src/solid/useSpacetimeDB.ts:13 when the library encounters an invalid state.

Common situations: See trigger scenarios.

AI-assisted analysis of clockworklabs/SpacetimeDB@524b4487d9 (2026-08-16). Data as JSON: /api/errors/2689f1ad91fd79b4. Report an issue: GitHub.