Skip to content

v0.0.2

Choose a tag to compare

View all tags
@gauravfs-14 gauravfs-14 released this 19 Oct 06:17
v0.0.2
00e0c24

Adaptly Release Notes

Version 0.0.2 - October 19, 2025

🎉 Major Release: Multi-LLM Support & Persistent Storage

This release introduces significant enhancements to Adaptly, including multi-LLM provider support, persistent storage capabilities, and comprehensive documentation improvements.

🚀 New Features

Multi-LLM Provider Support

  • OpenAI GPT Integration: Full support for GPT-4o, GPT-4o-mini, GPT-4-turbo, and GPT-3.5-turbo models
  • Anthropic Claude Integration: Support for Claude 3.5 Sonnet, Claude 3.5 Haiku, and Claude 3 Opus models
  • Google Gemini Integration: Enhanced support for Gemini 2.0 Flash (experimental), Gemini 1.5 Pro, and Gemini 1.5 Flash
  • Provider Selection: Dynamic provider switching with model selection for different AI capabilities and cost optimization
  • Environment Configuration: Support for multiple API keys across different providers

Persistent Storage System

  • Automatic State Management: UI state is automatically saved and restored across browser sessions
  • Version Control: Storage includes versioning for backward compatibility
  • Manual Controls: Developers can manually save, load, and clear storage state
  • Storage Service: New StorageService class for advanced storage management
  • localStorage Integration: Seamless integration with browser localStorage

Enhanced Documentation

  • Comprehensive API Reference: Complete documentation of all hooks, services, and types
  • Advanced Features Guide: Detailed guide for custom loaders, multi-provider setups, and performance optimizations
  • LLM Provider Configuration: Step-by-step setup for each supported provider
  • Component Registry Guide: Detailed adaptly.json configuration documentation
  • Troubleshooting Guide: Common issues and solutions

🔧 Improvements

Core Architecture Enhancements

  • Enhanced LLM Service: Improved service architecture with better error handling and provider management
  • Component Validation: Automatic validation of registered components to ensure compatibility
  • Auto-save Functionality: Automatic saving of component modifications and UI state changes
  • Enhanced Logging: Improved debugging capabilities with comprehensive logging system

UI/UX Improvements

  • Loading Overlay: Enhanced loading indicators with animated dots and modern spinner design
  • Command Interface: Improved ⌘K command bar with better AI suggestions and key generation
  • Adaptive Grid: Better handling of object arrays and component layout
  • Portal Rendering: Improved loading overlay with portal rendering for better z-index management

Developer Experience

  • TypeScript Support: Enhanced type definitions and IntelliSense support
  • Component Registry: Improved adaptly.json validation and error handling
  • Build Configuration: Enhanced Rollup configuration for better bundling
  • Dependency Management: Updated to latest versions of all AI SDK packages

🐛 Bug Fixes

Component Management

  • Key Generation: Fixed key generation issues in AdaptiveCommand for AI suggestions
  • Component Filtering: Improved component validation and filtering in AdaptiveUIProvider
  • State Management: Fixed auto-save functionality for component modifications
  • Grid Handling: Better handling of object arrays in AdaptiveGrid component

UI Components

  • Dashboard Sidebar: Refined key usage and improved metrics processing
  • Resource Monitor: Enhanced key assignment for uniqueness and better performance
  • Team Members: Improved key assignment for better component rendering
  • Notification Center: Streamlined component structure and improved functionality

Documentation

  • Code Block Formatting: Fixed raw code block support for better documentation formatting
  • Dark Color Scheme: Added dark color scheme support to configuration
  • README Updates: Removed outdated documentation and streamlined project presentation

📦 Dependencies & Compatibility

Updated Dependencies

  • AI SDKs: Updated to latest versions (@ai-sdk/openai ^2.0.52, @ai-sdk/anthropic ^2.0.33, @ai-sdk/google ^2.0.23)
  • React Support: Full support for React 18+ and React 19+
  • Next.js Integration: Enhanced support for Next.js 15+ with App Router
  • TypeScript: Updated to TypeScript 5.9+ for improved type safety

Peer Dependencies

  • React: ^18.0.0 || ^19.0.0
  • React DOM: ^19.2.0

Build Tools

  • Rollup: Enhanced configuration for better bundling
  • TypeScript: Improved type definitions and compilation
  • Development Tools: Updated dev dependencies for better development experience

🔄 Migration Guide

From v0.0.1 to v0.0.2

1. Update AdaptlyProvider Configuration

// Before (v0.0.1)
<AdaptlyProvider 
  apiKey="your-key" 
  model="gemini-2.0-flash-exp" 
/>

// After (v0.0.2)
<AdaptlyProvider 
  apiKey="your-key" 
  provider="google" // or "openai" or "anthropic"
  model="gemini-2.0-flash-exp"
  enableStorage={true}
  storageKey="my-app-ui"
/>

2. Environment Variables Setup

# Google (existing)
NEXT_PUBLIC_GOOGLE_GENERATIVE_AI_API_KEY=your-key

# OpenAI (new)
NEXT_PUBLIC_OPENAI_API_KEY=your-key

# Anthropic (new)
NEXT_PUBLIC_ANTHROPIC_API_KEY=your-key

3. Access New Storage Methods

import { useAdaptiveUI } from 'adaptly';

function MyComponent() {
  const { saveToStorage, loadFromStorage, clearStorage } = useAdaptiveUI();
  
  // Use storage methods
  const handleSave = () => saveToStorage();
  const handleLoad = () => loadFromStorage();
  const handleClear = () => clearStorage();
}

4. Update adaptly.json Configuration

Ensure your adaptly.json includes the latest version:

{
  "version": "1.0.0",
  "components": {
    // Your component definitions
  }
}

🎯 Key Highlights

Multi-LLM Capabilities

  • Provider Flexibility: Choose the best AI provider for your specific needs
  • Cost Optimization: Select models based on performance requirements and cost considerations
  • Model Selection: Fine-tune AI behavior with different model options per provider
  • Environment Management: Easy configuration for different API keys and environments

Persistent Storage Features

  • Session Persistence: UI state automatically saved and restored
  • Version Control: Storage includes versioning for compatibility
  • Manual Controls: Full control over storage operations
  • Local Storage: Seamless browser integration

Enhanced Developer Experience

  • Comprehensive Documentation: Complete guides and API references
  • TypeScript Support: Full type safety and IntelliSense
  • Component Registry: JSON-based component configuration
  • Advanced Features: Custom loaders, multi-provider setups, performance optimizations

🔮 What's Next

Upcoming Features

  • Custom CLI: Project scaffolding and adaptly.json validation tools
  • Enhanced Customization: More layout options and configuration flexibility
  • Performance Optimizations: Faster AI responses and improved rendering
  • Advanced Storage: Cloud sync capabilities and team collaboration features
  • Component Marketplace: Sharing and discovering components
  • Real-time Collaboration: Team environment features
  • Advanced AI Features: Context-aware suggestions and intelligent recommendations

Roadmap

  • v0.0.3: Performance optimizations and enhanced customization
  • v0.1.0: Custom CLI and component marketplace
  • v0.2.0: Real-time collaboration and advanced AI features
  • v1.0.0: Full feature set with enterprise capabilities

📚 Documentation Updates

New Documentation

Updated Documentation

🛠️ Technical Details

Architecture Improvements

  • Enhanced LLM Service: Better provider management and error handling
  • Storage Service: New service for persistent state management
  • Component Registry: Improved validation and component management
  • Loading System: Enhanced loading indicators and user feedback

Performance Enhancements

  • Component Validation: Automatic validation for better performance
  • State Management: Improved state handling and auto-save functionality
  • Grid System: Better handling of dynamic layouts and component arrays
  • Portal Rendering: Improved z-index management and overlay rendering

Code Quality

  • TypeScript: Enhanced type definitions and IntelliSense support
  • Error Handling: Improved error handling and debugging capabilities
  • Logging: Enhanced logging system for better debugging
  • Testing: Improved component testing and validation

🎉 Community & Support

Getting Help

  • Documentation: Comprehensive guides and API references
  • GitHub Issues: Report bugs and request features
  • Discussions: Community discussions and Q&A
  • Examples: Working examples and demos in the examples directory

Contributing

  • Code of Conduct: Community standards and guidelines
  • Contributing Guidelines: How to contribute to the project
  • Security Policy: Responsible disclosure of security vulnerabilities
  • License: MIT License for open source usage

📋 Release Checklist

Content Accuracy ✅

  • All new features are correctly listed
  • Bug fixes are described clearly and concisely
  • Known issues are documented
  • Version numbers and dates are correct

Clarity and Readability ✅

  • Language is clear and non-technical when needed
  • Sections are logically organized (Features, Fixes, Improvements, Known Issues)
  • Bullet points are concise and action-oriented
  • Important changes are highlighted (breaking changes, new features)

Technical Consistency ✅

  • Release version matches codebase version tag
  • Commit references and issue IDs are linked correctly
  • Dependencies and upgrade steps are documented
  • Compatibility information (OS, browsers, APIs) is included

Presentation ✅

  • Proper markdown formatting is used
  • Headings and subheadings are consistent
  • Links, references, and changelogs work correctly
  • Tone and style match previous release notes and project standards

🏷️ Version Information

  • Current Version: 0.0.2
  • Release Date: October 19, 2025
  • Previous Version: 0.0.1
  • Next Version: 0.0.3 (planned)
  • Breaking Changes: None (backward compatible)
  • Deprecations: None
  • Security Updates: None

For questions about this release or migration assistance, please visit our GitHub Discussions or Documentation.

Assets 2
Loading