React

Device Intelligence for React

First-party React hook for device identification. Add visitor identification, bot detection, and smart signals to your React application in minutes.

Get Started Live Demo

Quick Install

Add the SDK to your project with your preferred package manager.

npmnpm install @tracio/client

yarnyarn add @tracio/client

pnpmpnpm add @tracio/client

Basic Usage

Get up and running with the minimal setup.

$tsx

import { useTraceId } from '@tracio/client/react'
function App() {
  const { visitorId, confidence } = useTraceId()
  return <div>Visitor: {visitorId}</div>
}

Advanced Patterns

Production-ready patterns with error handling, loading states, and advanced configuration.

Hook with Error Boundary & Loading State — Click to expand

import { useTraceId } from '@tracio/client/react'
function ProtectedPage() {
  const { visitorId, confidence, isLoading, error } = useTraceId({
    timeout: 15000,
    endpoint: '/fp/identify',
  })
  if (isLoading) return <Spinner />
  if (error) return <ErrorBanner message={error.message} />
  return (
    <div>
      <p>Visitor: {visitorId}</p>
      <p>Confidence: {(confidence * 100).toFixed(1)}%</p>
    </div>
  )
}