Changelog

​

Features

• Added platform tracking to analytics to distinguish mobile from web SDK usage
• Enhanced error reporting for key management operations with detailed context and backend tracking
• Added Stellar wallet support to Swift example app with signing capabilities

​

Bug Fixes

• Fixed dependency update script to properly handle deeply nested example packages
• Fixed release pipeline to run non-interactively without manual confirmation prompts
• Fixed duplicate ‘Change Wallets’ buttons appearing for users with multiple connected partners
• Standardized error message styling to use consistent destructive styling across all components
• Improved error reporting for mobile bridge connections with better structured context
• Fixed worker crashes during failed signing operations by properly handling promise rejections
• Fixed Vercel deployment issues for example applications
• Updated changelog documentation to target v3 instead of v2
• Added loading UI for login upgrade screen
• Fixed wallet creation for users with incomplete wallets from failed key generation
• Updated release authentication to use GitHub App instead of personal access tokens
• Fixed simulate failure overlay blocking the send confirmation button on mobile

​

Maintenance

• Refreshed web examples in examples hub

​

Tests

• Added Stellar wallet testing coverage to Flutter mobile examples

​

Breaking Changes

• Theme type simplified: ParaTheme reduced from 13 properties to 8. Removed darkForegroundColor, darkBackgroundColor, darkAccentColor, overlayBackground, oAuthLogoVariant, customPalette, customFontSizes, customBorderRadii
• foregroundColor now drives the entire palette: Buttons, accents, rings, and primary colors are generated from it via OKLCH color space
• accentColor deprecated: If provided, maps to foregroundColor for backward compatibility
• customPalette replaced by cssOverrides: Use Record<string, string> for raw CSS variable overrides

​

New Features

• Redesigned authentication UI with updated design system, improved theming options, and enhanced user experience throughout the sign-in flow
• foregroundMixRatio: Control how much the foreground color mixes into UI surfaces (default 0.04)
• cssOverrides: Advanced escape hatch for setting raw CSS custom properties
• Automatic dark mode detection: The system auto-detects dark/light mode from your background color lightness — just provide dark colors directly, no more separate dark mode color properties. Use mode only to override if auto-detection misclassifies your background