๐Ÿž Editora Toast

Advanced Toast Notification System with Modern UX

13 Beautiful Themes
7 Position Options
9 Animation Types
100% Accessible
โˆž Customizable

๐ŸŽฏ Why Choose Editora Toast?

Editora Toast is a modern, accessible, and feature-rich toast notification system designed for developers who care about user experience. Built with performance, accessibility, and customization in mind.

๐Ÿš€ Key Features

  • 7 Position Options: Top-left, top-center, top-right, bottom-left, bottom-center, bottom-right, center
  • 13 Beautiful Themes: From light and dark to neon and glass effects
  • 9 Animation Types: Spring physics, bounce, slide, zoom, flip, fade, elastic, rotate, and custom
  • Swipe Gestures: Dismiss toasts with intuitive swipe controls
  • Full Accessibility: ARIA support, screen reader friendly, keyboard navigation
  • RTL Support: Perfect for international applications
  • Plugin System: Extensible with custom plugins

๐Ÿ“ฆ Quick Start

Get started in minutes with our simple API. Compatible with any JavaScript framework or vanilla JS.

// Install via npm
npm install @editora/toast

// Or use CDN
<script src="https://cdn.jsdelivr.net/npm/@editora/toast@latest/dist/index.umd.js"></script>
<link rel="stylesheet" href="https://cdn.jsdelivr.net/npm/@editora/toast@latest/dist/toast.css">

// Basic usage
import { toast } from '@editora/toast';
import "@editora/toast/toast.css";
toast.success('Welcome to Editora Toast!', { theme: 'light', position: 'top-right' });
toast.error('Something went wrong!', { theme: 'light', position: 'top-right' });
toast.info('Here is some information', { theme: 'light', position: 'top-right' });

๐Ÿ“ Basic Toast Types

Start with the fundamentals. Our toast system supports all standard notification types with beautiful, consistent styling.

Perfect for: User feedback, form validation, status updates, and general notifications.

๐Ÿ’ป Developer Friendly

// Simple API - Just call the method
toast.info('This is an info message', { theme: 'light', position: 'top-right' });
toast.success('Operation completed!', { theme: 'light', position: 'top-right' });
toast.warning('Please check your input', { theme: 'light', position: 'top-right' });
toast.error('Failed to save data', { theme: 'light', position: 'top-right' });

// Backward compatible with v1.x
import { toast } from '@editora/toast';
import "@editora/toast/toast.css";

๐Ÿ”„ Backward Compatible

Your existing v1.x code continues to work without changes. Upgrade seamlessly!

๐ŸŽจ Beautiful Themes

Choose from 13 professionally designed themes. Each theme is carefully crafted for different use cases and brand requirements.

Current Theme: light

๐ŸŽญ Theme Configuration

Themes can be set globally or per toast. Perfect for applications that need different notification styles for different contexts.

// Set global theme
toast.configure({
  theme: 'dark'
});

// Override per toast
toast.success('Success!', { theme: 'neon' });

// Available themes:
const themes = [
  'light', 'dark', 'colored', 'minimal',
  'glass', 'neon', 'retro', 'ocean',
  'forest', 'sunset', 'midnight', 'spring', 'autumn'
];

๐ŸŽจ Design System Integration

Each theme is designed to work seamlessly with modern design systems and can be easily customized to match your brand.

๐Ÿ“ Toast Positions

Position toasts anywhere on screen. Perfect for different UI layouts and user preferences.

Perfect for: Adapting to different screen layouts, user preferences, and application contexts.

๐ŸŽฌ Animation Types

Choose from 9 different animation types. Each animation is optimized for performance and user experience.

// Set global animation
toast.configure({
  animation: { type: 'spring' }
});

// Or per toast
toast.success('Animated!', {
  animation: { type: 'bounce' }
});

๐Ÿ‘† Swipe to Dismiss

Modern mobile-first interaction. Users can swipe toasts in any direction to dismiss them. Perfect for touch devices and desktop users alike.

๐Ÿงช Try It Now!

Click a button below, then swipe the toast in the specified direction to dismiss it.

๐Ÿ’ก The toast will move slightly as you drag to provide visual feedback

๐Ÿ“ฑ Touch-First Design

Swipe gestures provide an intuitive way to dismiss notifications, especially on mobile devices. Our implementation supports all swipe directions and provides smooth visual feedback.

// Enable swipe globally
toast.configure({
  swipeDismiss: true,
  swipeDirection: 'any' // 'left', 'right', 'up', 'down', 'horizontal', 'vertical', 'any'
});

// Or per toast
toast.info('Swipe to dismiss', {
  swipeDismiss: true,
  swipeDirection: 'horizontal'
});

๐ŸŽฏ Precise Control

Restrict swipe directions to match your UX requirements. Perfect for different contexts.

๐Ÿ“ฑ Cross-Platform

Works seamlessly on touch devices and desktop with mouse interactions.

โœจ Smooth Feedback

Visual feedback during swipe provides clear indication of the interaction.

๐Ÿš€ Advanced Features

Beyond basic toasts - explore powerful features for complex use cases.

โš™๏ธ Configuration Options

Fine-tune the toast behavior to match your application's needs.

// Comprehensive configuration
toast.configure({
  // Positioning (7 options available)
  position: 'bottom-right', // 'top-left', 'top-center', 'top-right',
                           // 'bottom-left', 'bottom-center', 'bottom-right', 'center'

  // Timing
  duration: 4000, // Auto-dismiss after 4 seconds
  maxVisible: 5,  // Maximum visible toasts

  // Appearance
  theme: 'light', // 13 themes available
  animation: { type: 'spring' }, // 9 animation types: 'spring', 'bounce', 'slide',
                                 // 'zoom', 'flip', 'fade', 'elastic', 'rotate', 'custom'

  // Interactions
  pauseOnHover: true,    // Pause on mouse hover
  pauseOnFocus: false,   // Pause on focus
  swipeDismiss: true,    // Enable swipe to dismiss
  swipeDirection: 'any', // Swipe direction control

  // Internationalization
  rtl: false, // Right-to-left support

  // Accessibility
  enableAccessibility: true
});

โ™ฟ Full Accessibility Support

Editora Toast is built with accessibility in mind. All toasts are screen reader friendly, keyboard navigable, and follow WCAG guidelines.

๐ŸŽฏ ARIA Support

Proper ARIA labels, roles, and live regions for screen readers.

โŒจ๏ธ Keyboard Navigation

Full keyboard support for dismissing and interacting with toasts.

๐ŸŽจ High Contrast

All themes meet WCAG contrast requirements for accessibility.

๐ŸŒ Internationalization

RTL support and proper text direction handling for global applications.

๐Ÿš€ Advanced Use Cases

๐Ÿ“ Interactive Feedback Form

Test form validation with different toast responses. Try submitting with missing fields or invalid data.

๐Ÿ”” Notification Center

Simulate a notification center with different types of system notifications.

๐Ÿ“Š Advanced Progress Scenarios

Complex progress tracking with multiple stages and real-time updates.

๐ŸŽ›๏ธ Interactive Actions

Toasts with multiple action buttons, forms, and complex user interactions.

๐Ÿšจ Error Handling Scenarios

Different error types with appropriate toast responses and recovery options.

๐Ÿ”„ Async Operations

Promise-based operations with loading states and success/error handling.