Skip to content

ErrorFallback

Purpose

ErrorFallback displays a friendly error message when something goes wrong:

  • Clear error messaging
  • Retry and home navigation options
  • Development-only error details

When to use

Use ErrorFallback for:

  • Error boundary fallback UI
  • Unrecoverable error states
  • Top-level error handling

Basic usage

tsx
import ErrorFallback from '@/shared/ui/components/ErrorFallback'

<ErrorFallback
  error={error}
  onReset={() => window.location.reload()}
/>

With ErrorBoundary

tsx
import { ErrorBoundary } from '@/app/providers/ErrorBoundary'
import ErrorFallback from '@/shared/ui/components/ErrorFallback'

<ErrorBoundary
  fallback={({ error, resetErrorBoundary }) => (
    <ErrorFallback error={error} onReset={resetErrorBoundary} />
  )}
>
  <App />
</ErrorBoundary>

Props

PropTypeDefaultDescription
errorError | null-Error object
onReset() => void-Retry callback
showDetailsbooleanimport.meta.env.DEVShow stack trace

Notes

  • Stack trace only shown in development by default
  • "Go to Home" navigates to /
  • Centered card layout for visibility
  • Use with React error boundaries for automatic error catching