Changelog

v1.1.1

• Release Date: 19/03/25
• Components Version: 1.1.1
• Hooks Version: 1.1.1

1. Relaxed peer dependencies: Updated react and react-dom peer dependencies from exact versions to >=18.2.0, allowing compatibility with React 18.2+ and React 19.
2. Broader React support: Projects using newer React versions (e.g. React 19) can now use the Recommendations SDK without peer dependency conflicts.

Initial Release

• Release Date: 24/11/25
• Components Version: 1.0.0
• Hooks Version: 1.0.0

The first official release of the Recommendations SDK, designed for seamless integration of personalized product recommendations into React applications.

1. Context Management: Context provider for managing recommendation state and API communication.
2. Headless Integration: Core hook providing recommendation fetching, widget response management, and state handling for custom UI implementations.
3. Built-in Components: Pre-built UI components for displaying recommendation widgets with customizable styling and product cards.
4. Widget-Based System: Support for multiple recommendation widgets from a single API call for optimal performance.
5. Smart Recommendations: Recommendations automatically adapt based on page type (HOME, PRODUCT, CATEGORY, CART, BRAND) and user context.
6. Real-Time Fetching: Automatically fetch recommendations when page context or user interactions change.
7. Customizable Components: Fully customizable Widget component with support for custom title, product card, and loader components.
8. TypeScript Support: Full TypeScript definitions for enhanced developer experience.
9. Event Tracking: Built-in support for tracking recommendation interactions through the onEvent callback.
10. Flexible Integration: Use hooks for headless implementations or pre-built components for rapid development.
11. Scrollable Widgets: Built-in horizontal scrolling with navigation arrows for better product browsing experience.
12. Loading States: Comprehensive loading state management for better user experience.