@tindalabs/blindspot-react

React integration for Blindspot — observability without surveillance. Provider, React Router v6/7 route tracing, and a hook for the active span.

npm install @tindalabs/blindspot-react @tindalabs/blindspot

Requires React ≥18. react-router-dom is an optional peer (only for <BlindspotRoutes>).

Usage

Wrap your app root — BlindspotProvider takes the same config as init():

import { BlindspotProvider } from '@tindalabs/blindspot-react'

<BlindspotProvider config={{ endpoint: '…/v1/traces', serviceName: 'app' }}>
  <App />
</BlindspotProvider>

Trace navigations with a drop-in replacement for <Routes> (creates a root span per navigation):

import { BlindspotRoutes } from '@tindalabs/blindspot-react'

<BlindspotRoutes>
  <Route path="/checkout" element={<Checkout />} />
</BlindspotRoutes>

Attach events/attributes to the active span from any component:

import { useSpan } from '@tindalabs/blindspot-react'

const { addEvent, setAttribute } = useSpan()
addEvent('form.validation.failed', { field: 'postcode' })

Docs

API reference · Architecture & privacy model

The Tindalabs stack

| Package | What it does | |---|---| | @tindalabs/blindspot | Privacy-first OTel frontend observability | | @tindalabs/shield | Tamper detection & content protection | | @tindalabs/scent | Probabilistic identity continuity |

License

MIT