@bettercone/ui
Back to home

Changelog

All notable changes to @bettercone/ui

v0.5.2
Feature
React 19 Support & Documentation Cleanup • 2025-11-21

🛠️ Peer Dependencies - React 19 Compatibility

  • Extended lucide-react peer dependency range for React 19 support
  • Updated from ^0.300.0 to ^0.300.0 || ^0.400.0 || ^0.500.0
  • Supports latest lucide-react versions (v0.546.0+)
  • Eliminates peer dependency conflicts with modern React stacks
  • Enables smooth CLI installation: npx @bettercone/ui init works everywhere

📚 Documentation Cleanup

  • Removed changelog duplication from README.md
  • README now points to CHANGELOG.md for detailed release notes
  • Cleaner, more focused README with installation and usage examples
  • Updated QUICK_START.md with CLI installation method
  • Updated showcase version badges to v0.5.2

🔧 Enhanced Compatibility

  • Broader peer dependency ranges for modern stack compatibility
  • No breaking changes - all existing functionality preserved
  • Improved developer experience with cleaner documentation
v0.5.1
Feature
Enhanced Compatibility & Modern Stack Support • 2025-11-21

🛠️ Peer Dependencies - Better Compatibility

  • Relaxed lucide-react peer dependency: ^0.300.0 to ^0.344.0 → ^0.300.0
  • Supports latest lucide-react versions (v0.546.0+)
  • Relaxed tailwind-merge peer dependency: ^2.0.0 → ^2.0.0 || ^3.0.0
  • Supports Tailwind v3.x series
  • Relaxed tailwindcss peer dependency: ^3.4.0 → ^3.4.0 || ^4.0.0
  • Supports upcoming Tailwind v4.x

✅ Compatibility Improvements

  • Eliminates peer dependency conflicts during npm install
  • Supports latest library versions (Lucide v0.546, Tailwind v4)
  • Enables smooth CLI installation: npx @bettercone/ui init works everywhere
  • Compatible with React 19, Tailwind v4, and modern stacks
  • No breaking changes - all existing functionality preserved
v0.5.0
Clean Architecture: No Bundle Bloat • 2025-11-21

🚀 Major Architectural Improvement

  • Eliminated 712KB+ bundle bloat by removing shadcn/ui component bundling
  • shadcn/ui components are no longer bundled in @bettercone/ui package
  • Automatic CLI installation - npx @bettercone/ui init installs everything
  • 50%+ bundle size reduction - From ~1.4MB to ~700KB
  • Clean separation - Bettercone focuses on specialized auth components only

🛠️ Enhanced CLI Tool

  • Smart one-command setup: npx @bettercone/ui init
  • Detects existing shadcn/ui installations
  • Installs missing dependencies automatically
  • Installs essential shadcn/ui components
  • Comprehensive component verification (dependencies + files)

📦 Bundle Size Optimization

  • Before: ~1.4MB (including shadcn/ui components)
  • After: ~700KB (auth components only)
  • Savings: 50%+ bundle size reduction

🔄 Component Architecture Refinement

  • Bettercone focuses on specialized features:
  • 🔐 Authentication & Security - Core auth components
  • 🏢 Organization Management - Team and org features
  • 💳 Billing & Subscriptions - Payment integration
  • 🔑 API Key Management - Developer tools
  • shadcn/ui handles UI primitives:
  • 🎨 UI Components - Button, Card, Input, etc.
  • 🎯 Design System - Consistent styling
  • 🔧 Customization - Full control over components

💥 Breaking Changes

  • Installation now requires CLI: npx @bettercone/ui init
  • Old way still works but manual: npm install + npx shadcn@latest init + add components
  • shadcn/ui components no longer exported from @bettercone/ui
  • Correct: import { Button } from '@/components/ui/button'
  • Incorrect: import { Button } from '@bettercone/ui'
v0.4.0
API Key Components Overhaul • 2025-11-10

Breaking Changes

  • Removed ApiUsageCard, UsageDashboard, UsageHistoryChart, FeatureAccessCard (not Better Auth native)
  • Removed @bettercone/usage-tracking plugin package (custom business logic)
  • Migration: Use ApiKeyUsageCard for per-key usage tracking instead

New Components

  • ApiKeyUsageCard - Per-key usage visualization with progress bars, rate limits, refill countdowns
  • UpdateApiKeyDialog - Edit API key settings with three-tab interface (Basic | Usage & Refills | Rate Limits)

Enhanced Components

  • ApiKeyCell - Added remaining requests, rate limits, refill countdown, permissions badges
  • CreateApiKeyDialog - Added usage limits, auto-refill settings, rate limiting configuration

Component Organization

  • Moved API Key components from components/developer/ to components/apiKey/
  • Import paths remain unchanged - no breaking changes to public API

Type Enhancements

  • Updated ApiKey interface with all Better Auth native fields
  • Added: remaining, refillAmount, refillInterval, lastRefillAt
  • Added: rateLimitEnabled, rateLimitTimeWindow, rateLimitMax, requestCount, lastRequest
  • Added: expiresAt, enabled, permissions, metadata

Better Auth Features Now Exposed

  • Usage caps & remaining requests with progress bars
  • Auto-refill schedules with countdown timers
  • Rate limiting per time window with tracking
  • Permissions management with badge display
  • Enable/disable toggle in UpdateApiKeyDialog
  • Expiration dates with visual indicators
  • Metadata storage support
v0.3.12
Bug Fix
Build Fix - Use Client Directive • 2025-11-10

Build

  • Added 'use client' directive to bundled output files
  • Fixed Next.js client component errors when importing from package
  • Implemented post-build script to inject directive into dist files
  • Bundled react-hook-form internally for better compatibility
v0.3.11
Bug Fix
React Hook Form Dependency Fix • 2025-11-10

Build

  • Externalized react-hook-form dependency to fix module resolution errors
  • Fixed 'FormProvider is not exported' errors in consuming applications
  • Added react-hook-form to tsup external dependencies configuration
v0.3.10
Bug Fix
CSS Export Fix • 2025-11-10

Build

  • Added styles.css to published package distribution
  • Fixed CSS export path (@bettercone/ui/css) resolution
v0.3.9
Feature
Modern Design System Update • 2025-11-10

Style Modernization

  • UserAvatar and OrganizationLogo - Updated to rounded-lg styling (sm size remains rounded-full)
  • Typography - Changed from font-semibold to font-medium across all view components
  • Colors - Replaced opacity-70 with semantic text-muted-foreground for consistency
  • Spacing - Modernized with consistent gap-2 and px-2 py-1.5 patterns
  • UserButton - Updated to match modern design patterns
  • OrganizationSwitcher - Redesigned style with proper labels

Bug Fixes

  • Fixed setActiveSession undefined guard check in UserButton
  • Removed deprecated warning message for UserButton size prop
v0.3.8
Feature
Dashboard & View Components • 2025-11-08

New Components

  • OrganizationView - Complete organization management interface
  • UsageHistoryChart - Interactive usage visualization with Shadcn Charts + Recharts
  • OrganizationSettingsCards - Composite organization settings component

Features

  • Tab-based navigation for OrganizationView (Settings, Members, API Keys)
  • Responsive design: desktop sidebar, mobile drawer
  • Multiple chart types: Line, Bar, Area with smooth transitions
  • Time range controls: 7d, 30d, 90d, 1y, all time
  • Automatic trend indicators (TrendingUp/TrendingDown badges)
  • Interactive tooltips with formatted values
  • Client-side time range filtering
  • Deep linking support for section navigation
  • Accessibility layer for keyboard navigation and screen readers

Enhancements

  • ApiUsageCard - Enhanced with plugin support
  • FeatureAccessCard - Enhanced with plugin support
  • UsageDashboard - Enhanced with plugin support
  • OrganizationView - Made organizationOptions optional with safe navigation
v0.3.7
Feature
🎉 Complete Better Auth Coverage - Enterprise SSO & OIDC Provider • 2025-11-07

New Components

  • SSOConfigCard - Complete OIDC & SAML SSO configuration for enterprise customers
  • SAMLSetupWizard - Guided 5-step SAML setup wizard with IdP presets
  • OIDCProviderCard - OAuth2/OIDC Provider client application management (RFC 7591)

Features

  • Full OIDC (OpenID Connect) SSO configuration
  • Complete SAML 2.0 SSO setup with metadata parsing
  • OAuth2/OIDC Provider - manage client applications
  • Dynamic client registration (RFC 7591 compliant)
  • Support for Azure AD, Okta, Google Workspace, OneLogin, Auth0, JumpCloud
  • XML metadata auto-parsing for SAML
  • Attribute mapping for OIDC claims and SAML assertions
  • Client types: web, SPA, native, machine-to-machine
  • One-time secret display for OAuth2 clients
  • Connection testing before completion

Documentation

  • Streamlined enterprise component docs (49% reduction in length)
  • Comprehensive setup guides for all major IdPs
  • RFC 7591 and SAML 2.0 specification references
  • Better Auth SSO and OIDC Provider plugin integration guides

Milestone

  • 🎉 100% Better Auth coverage achieved
  • All Better Auth plugins fully implemented
  • Complete authentication, security, billing, and enterprise features
v0.3.6
Feature
Device Authorization Components • 2024-11-06

New Components

  • DeviceAuthorizationCard - User code input for device authorization
  • DeviceApprovalCard - Approve/deny device authorization requests
  • DeviceCodeDisplay - Display codes for CLI/IoT applications
  • LastLoginBadge - Show last authentication method used

Features

  • OAuth 2.0 Device Authorization Grant (RFC 8628) support
  • Auto-formatting for device codes (ABCD-1234)
  • QR code support for mobile scanning
  • Real-time polling for authorization status
  • Countdown timer with color-coded urgency
  • Copy-to-clipboard for URLs and codes
  • Support for Smart TVs, CLI apps, IoT devices
  • Better Auth Device Authorization plugin integration

Improvements

  • AuthView integration with anonymous and SIWE authentication
v0.3.5
Feature
Admin Components • 2024-11-06

New Components

  • UserManagementTable - Admin table with pagination, search, and actions
  • BanUserDialog - Ban users with reason and duration
  • ImpersonateUserDialog - Impersonate users for support

Features

  • User management with pagination (10 per page)
  • Search by email or name
  • Ban/unban users with custom duration
  • Delete users with confirmation
  • Impersonate users for support purposes
  • Status badges (active/banned, verified/unverified)
  • Role display support
  • Better Auth admin plugin integration

Infrastructure

  • Added Table UI component
v0.3.4
Feature
Passkeys, Organizations & Account Management • 2024-11-06

New Components

  • PasskeySetupWizard - 5-step passkey registration wizard
  • TransferOwnershipDialog - Organization ownership transfer
  • LinkAccountCard - Link OAuth providers to accounts
  • UnlinkAccountCard - Unlink OAuth providers from accounts
  • ChangeEmailCard - Email change with verification
  • EmailVerificationBanner - Prompt email verification

Features

  • Platform vs cross-platform authenticator selection
  • Organization ownership transfer with role management
  • OAuth account linking and unlinking
  • Two-step email change process with verification
  • Minimum account protection (prevent unlinking last account)
  • AlertDialog and RadioGroup UI components added
v0.3.3
Feature
Anonymous Authentication • 2024-11-05

New Components

  • AnonymousSignInButton - Guest authentication without PII
  • AnonymousUpgradeCard - Prompt guests to upgrade accounts

Features

  • One-click anonymous/guest authentication
  • Account linking support (email and OAuth)
  • Full localization and customization options
  • Better Auth anonymous plugin integration

Documentation

  • Complete setup guide for anonymous authentication
  • Component API reference pages
  • Best practices and examples
v0.3.2
Documentation
Documentation Updates • 2024-11-04

Documentation

  • Enhanced README with v0.3.0 and v0.3.1 features
  • Improved package documentation on npm
v0.3.1
Bug Fix
Bug Fixes • 2024-11-03

Bug Fixes

  • Fixed wallet schema for SIWE components
  • Improved TypeScript type definitions
v0.3.0
Feature
Better Auth Stripe & SIWE • 2024-11-02

New Components

  • BillingDashboard - Complete billing overview
  • SubscriptionCard - Manage subscriptions
  • PaymentMethodCard - Payment method management
  • InvoiceHistoryCard - Invoice history with downloads
  • SiweSignInButton - Ethereum wallet authentication
  • SiweSignInForm - Complete SIWE auth form
  • WalletConnectButton - Connect wallet button

Features

  • Full Stripe plugin support for Better Auth
  • Sign-In with Ethereum (SIWE) integration
  • Subscription management workflows
  • Payment method handling
  • Invoice viewing and downloading
v0.2.2
Feature
Phone Authentication • 2024-10-28

New Components

  • PhoneSignInForm - Sign in with phone + password
  • PhoneSignUpForm - Sign up with phone + OTP
  • PhoneNumberCard - Manage phone number in settings

Features

  • Phone number authentication support
  • SMS OTP verification
  • Phone number management in account settings
v0.2.0
Feature
Production Release • 2024-10-25

Components

  • 71 production-ready components
  • Authentication, Security, Organizations
  • Billing, Pricing, Team, Usage tracking
  • Complete API key management

Features

  • Full Better Auth integration
  • Multi-framework support (Next.js, Vite, Remix)
  • Backend-agnostic (Convex, Prisma, Supabase, Drizzle)
  • Complete TypeScript support
  • Full customization with Tailwind CSS
  • i18n ready

For detailed migration guides and breaking changes, see the full CHANGELOG on GitHub.