@context-action/react Pattern Guide

Complete guide to the core patterns available in @context-action/react framework.

Note: This guide has been moved to the Patterns section for better organization.

📋 Quick Reference

Choose the right pattern for your use case:

Pattern	Use Case	Import	Best For
🎯 Action Only	Action dispatching without stores	createActionContext	Event systems, command patterns
🏪 Store Only	State management without actions	createStoreContext	Pure state management, data layers
🔧 Ref Context (Advanced)	Direct DOM manipulation with zero re-renders	createRefContext	High-performance UI, animations, real-time interactions
⚡ Selective Subscription (Advanced)	Performance optimization through strategic subscription management	Pattern combination	High-frequency updates, performance-critical apps

For complex applications, compose patterns together for maximum flexibility and separation of concerns.

📚 Detailed Documentation

Core Framework Patterns

• 🎯 Action Only Pattern - Pure action dispatching without state management
• 🏪 Store Only Pattern - Type-safe state management without actions (Recommended)

Advanced Patterns

• 🔧 Ref Context Pattern - Direct DOM manipulation with zero re-renders
• Pattern Composition - Combining patterns for complex applications
• Selective Subscription Patterns - Pre-memoization optimization through strategic subscription management
• Domain Context Architecture - Document-centric context separation
• MVVM Architecture - Modern Model-View-ViewModel implementation

Implementation Patterns

• Real-time State Access - Patterns for accessing real-time state
• Ref Context Setup - High-performance DOM manipulation setup
• Wait Then Execute - Waiting and execution patterns
• Conditional Await - Conditional waiting patterns
• Timeout Protection - Timeout protection in async operations

Migration Guide

From Legacy Patterns

For users upgrading from earlier versions, see the Migration Guide for comprehensive upgrade instructions.

🔍 Examples

See the examples/ directory for complete working examples of each pattern and the Pattern Guide documentation for comprehensive implementation details.