Skip to content

A smart and customizable React Error Boundary component with dynamic fallback rendering and TypeScript support. Perfect for handling runtime errors in modern React apps.

License

Notifications You must be signed in to change notification settings

AkshayPanchivala/react-smart-error-boundary

Repository files navigation

🛡️ React Smart Error Boundary

⚠️ This package is currently under development and not yet ready for production use. Please ⭐️ the repository and check back soon for updates!


A lightweight and customizable error boundary component for React applications. Gracefully catch and display runtime errors in your UI — with zero configuration and full flexibility.


🚧 Status: Under Construction

We're actively working to finalize and publish this package. Expect improvements, breaking changes, and feature additions in upcoming releases.

If you'd like to contribute or follow progress:


🚀 Planned Installation

Coming soon via npm or yarn:

npm install react-smart-error-boundary
# or
yarn add react-smart-error-boundary

📊 Planned Usage

import { ErrorBoundary } from 'react-smart-error-boundary';

function App() {
  return (
    <ErrorBoundary
      fallback={(error, info) => (
        <div style={{ padding: '1rem', background: '#ffe5e5', color: '#a00' }}>
          <h2>🚨 Error: {error.message}</h2>
          <details>
            <summary>Stack Trace</summary>
            <pre>{info.componentStack}</pre>
          </details>
        </div>
      )}
    >
      <YourComponent />
    </ErrorBoundary>
  );
}

🧩 Props (Planned)

Prop Type Description
children ReactNode Child components that should be protected.
fallback ReactNode or (error: Error, info: React.ErrorInfo) => ReactNode Custom UI to render when an error occurs.
onError (error: Error, info: React.ErrorInfo) => void Callback for logging or reporting the error.

✨ Planned Features

  • ⚙️ Support for React 17 & 18
  • 🎨 Fully customizable fallback UI
  • 🧠 Supports static and dynamic fallback rendering
  • 💡 Written in TypeScript
  • 💼 Production-ready best practices

📄 License

MIT © Akshay Panchivala


❤️ Contribution

We welcome contributions once development stabilizes. Feel free to open issues or submit a PR in the future.


Made with ❤️ by Akshay Panchivala

About

A smart and customizable React Error Boundary component with dynamic fallback rendering and TypeScript support. Perfect for handling runtime errors in modern React apps.

Topics

Resources

License

Code of conduct

Stars

Watchers

Forks

Packages

No packages published