Modèles React SPA

Cette skill couvre @clerk/react pour Vite/CRA SPAs. Pour Next.js utilisez clerk-nextjs-patterns. Pour TanStack Start utilisez clerk-tanstack-patterns.

De quoi avez-vous besoin ?

Références

Configuration

npm install @clerk/react

.env:

VITE_CLERK_PUBLISHABLE_KEY=pk_...

src/main.tsx:

import { StrictMode } from 'react'
import { createRoot } from 'react-dom/client'
import { ClerkProvider } from '@clerk/react'
import App from './App.tsx'

const PUBLISHABLE_KEY = import.meta.env.VITE_CLERK_PUBLISHABLE_KEY

createRoot(document.getElementById('root')!).render(
  <StrictMode>
    <ClerkProvider publishableKey={PUBLISHABLE_KEY}>
      <App />
    </ClerkProvider>
  </StrictMode>,
)

Modèle Mental

@clerk/react est client uniquement — il n'y a pas d'auth() côté serveur. Tout l'état d'auth provient des hooks.

• isLoaded doit être true avant de faire confiance à isSignedIn — gardez toujours sur isLoaded
• useClerk() donne accès à signOut, openSignIn, openUserProfile et d'autres méthodes
• getToken() de useAuth() récupère le JWT de session pour les appels API

Modèle Minimal

import { useAuth } from '@clerk/react'

export function Dashboard() {
  const { isLoaded, isSignedIn, userId } = useAuth()

  if (!isLoaded) return <div>Loading...</div>
  if (!isSignedIn) return <div>Please sign in</div>

  return <div>Hello {userId}</div>
}

Route Protégée (React Router v6/v7)

import { Navigate, Outlet } from 'react-router-dom'
import { useAuth } from '@clerk/react'

export function ProtectedRoute() {
  const { isLoaded, isSignedIn } = useAuth()

  if (!isLoaded) return <div>Loading...</div>
  if (!isSignedIn) return <Navigate to="/sign-in" replace />

  return <Outlet />
}

<Routes>
  <Route element={<ProtectedRoute />}>
    <Route path="/dashboard" element={<Dashboard />} />
    <Route path="/settings" element={<Settings />} />
  </Route>
  <Route path="/sign-in" element={<SignIn />} />
</Routes>

Token pour les Appels API

import { useAuth } from '@clerk/react'

export function DataFetcher() {
  const { getToken } = useAuth()

  async function fetchData() {
    const token = await getToken()
    if (!token) return

    const res = await fetch('/api/data', {
      headers: { Authorization: `Bearer ${token}` },
    })
    return res.json()
  }

  return <button onClick={fetchData}>Load</button>
}

Pièges Courants

Voir aussi

• clerk-setup - Installation initiale de Clerk
• clerk-custom-ui - Flux personnalisés & apparence
• clerk-orgs - Organisations B2B

Docs

React SDK