Skip to content

Releases: nyambogahezron/react-native-toaster

V.1.0.0-beta

05 Oct 22:11
@nyambogahezron nyambogahezron
v1.0.0-beta
48bb649

Choose a tag to compare

View all tags
V.1.0.0-beta Pre-release
Pre-release

hn-react-native-toaster v1.0.0-beta Release Notes

🎉 We're excited to announce the first beta release of hn-react-native-toaster!

A beautiful, animated toast notification system for React Native with support for Expo and web platforms.

🚀 What's New in v1.0.0-beta

Core Features

  • 🎨 Beautiful Animations: Smooth spring animations powered by React Native Reanimated
  • 🎯 TypeScript Support: Fully typed for better development experience
  • 🎪 Multiple Toast Types: Success, Error, Warning, and Info toasts
  • 📱 Cross-Platform: Works seamlessly on iOS, Android, and Web
  • 🎛️ Highly Customizable: Custom styles, positions, and animations
  • 👆 Gesture Support: Swipe to dismiss functionality
  • 🎈 Lightweight: Minimal bundle size with Zustand for state management

API & Hooks

Main Hook: useToast()

const { success, error, warning, info, custom, hide, clear } = useToast();

Specialized Hooks

  • useApiToast() - Perfect for API call feedback with loading states
  • useFormToast() - Optimized for form validation and submission feedback

Components

  • ToastContainer - Main container component to render toasts
  • ToastDemo - Demo component for testing and showcasing features

Configuration Options

  • Multiple Positions: Top, bottom, center positioning
  • Custom Animations: Configurable duration and animation types
  • Global Configuration: Set default behavior across your app
  • Per-Toast Overrides: Customize individual toasts as needed
  • Auto-dismiss: Configurable duration with manual dismiss support

📦 Installation

# Using npm
npm install hn-react-native-toaster

# Using yarn  
yarn add hn-react-native-toaster

# Using bun
bun add hn-react-native-toaster

Required Peer Dependencies

npm install react react-native react-native-reanimated react-native-gesture-handler react-native-safe-area-context zustand

🏁 Quick Start

1. Setup ToastContainer

Add the ToastContainer to your root component:

import { ToastContainer } from 'hn-react-native-toaster';

export default function App() {
  return (
    <View style={{ flex: 1 }}>
      {/* Your app content */}
      <ToastContainer />
    </View>
  );
}

2. Use the Hook

import { useToast } from 'hn-react-native-toaster';

function MyComponent() {
  const toast = useToast();

  const handleSuccess = () => {
    toast.success('Operation completed successfully!');
  };

  const handleError = () => {
    toast.error('Something went wrong', 'Error');
  };

  return (
    <View>
      <Button title="Success Toast" onPress={handleSuccess} />
      <Button title="Error Toast" onPress={handleError} />
    </View>
  );
}

🧪 Beta Status

This is a beta release, which means:

  • ✅ Core functionality is stable and tested
  • ✅ API is mostly finalized but may have minor changes
  • ⚠️ Some advanced features may still be refined
  • ⚠️ Please report any issues you encounter
  • 📝 Documentation and examples are continuously being improved

🐛 Known Issues & Limitations

  • Performance optimization for large numbers of simultaneous toasts is ongoing
  • Some edge cases with custom animations may need refinement
  • Web platform support is functional but may need platform-specific optimizations

🤝 Contributing

We welcome contributions! Please see our CONTRIBUTING.md for guidelines.

Reporting Issues

  • 🐛 Bug Reports: Use our GitHub issue template
  • 💡 Feature Requests: Share your ideas and use cases
  • 📖 Documentation: Help us improve our docs and examples

🔒 Security

Please review our SECURITY.md for reporting security vulnerabilities.

📄 License

This project is licensed under the MIT License - see the LICENSE file for details.

🙏 Acknowledgments

  • Built with ❤️ by @nyambogahezron
  • Powered by React Native Reanimated for smooth animations
  • State management by Zustand for minimal overhead
  • Gesture handling by React Native Gesture Handler

📚 Resources

What's Next?

After gathering feedback from the beta release, we plan to:

  • 🔧 Address any reported issues and edge cases
  • 📈 Performance optimizations based on real-world usage
  • 🎨 Additional animation presets and customization options
  • 📱 Platform-specific enhancements
  • 📖 Expanded documentation and tutorials
  • 🚀 Stable v1.0.0 release

Try it out and let us know what you think! Your feedback is invaluable in making this the best toast library for React Native.

Released on October 6, 2025

Loading