@ops-ai/nuxt-toggly-core

Core feature flag utilities for Nuxt

Install

npm install @ops-ai/nuxt-toggly-core

Optional gRPC transport (Node/Nitro server only):

npm install @grpc/grpc-js @grpc/proto-loader

Import gRPC helpers from @ops-ai/nuxt-toggly-core/telemetry/grpc — do not import that subpath from browser or Nitro edge bundles. Browser @ops-ai/nuxt-toggly-client does not send usage/metrics; use the server package for telemetry.

Live updates

WebSocket live updates are enabled when enableLiveUpdates is unset or true (browser, Node with globalThis.WebSocket, or an injected webSocketImpl). Edge runtimes skip long-lived sockets. Pass webSocketImpl from the ws package on Node 18 when no global WebSocket exists (done automatically by @ops-ai/nuxt-toggly-server).

Documentation

• docs.toggly.io
• SDK catalog: root README

Entity context

Pass a domain object on each isFeatureOn / evaluateFeatureGate call. setContext is the user, not the page entity. Register mappers with registerContext locally — this client does not PUT entity schemas.

Entity gates fail closed without context. See Nuxt SDK.

client.registerContext('Order', (order) => ({
  kind: 'Order',
  key: String(order.id),
  attributes: { Status: order.status },
}))

await client.isFeatureOn('OrderBadge', order, 'Order')

License

MIT — see also the repository LICENSE.

Issues

Use the structured issue templates.