API reference › @evolu/common › local‑first/Evolu › EvoluErrorDep

Defined in: packages/common/src/local-first/Evolu.ts:503

Properties

evoluError

readonly evoluError: ReadonlyStore<
  | EvoluError
| null>;

Defined in: packages/common/src/local-first/Evolu.ts:532

ReadonlyStore of EvoluError shared by all Evolu instances created from the same createEvoluDeps result.

Subscribe once to show user-facing messages across all instances. Logging is handled by platform createRun global error handlers.

Example

deps.evoluError.subscribe(() => {
  const error = deps.evoluError.get();
  if (!error) return;

  switch (error.type) {
    case "InvalidComputerClock":
      // Show guidance specific to the detected error.
      showMessage("Your system clock appears incorrect. Please fix it.");
      break;
    default:
      // Show a generic user message for other operational errors.
      showMessage("Something went wrong. Please try again.");
  }
});
Markdown for LLMs