v2.7.0

2.7.0 (2026-08-07)

Button, Avatar, and Badge Geist Alignment

This release aligns the Button, Avatar, and Badge components with the Geist design system, modernizes the documentation, and updates the development workflow.

Changes

Button

• Renamed variant="primary" to variant="default".
• Replaced iconPrefix/iconSuffix with prefix/suffix snippets.
• Added svgOnly, shape, and shadow props.
• Improved loading and disabled accessibility behavior.
• Added per-variant disabled styles and cursor states.
• Split styles and types into testable modules.
• Updated documentation and internal call sites.

Avatar

• Added src, username, letter, and placeholder support.
• Added image fallback handling.
• Added AvatarGroup with limit, reverse, and overlap.
• Added AvatarWithIcon.
• Added unit tests for avatar utilities and styles.
• Removed provider-specific avatar wrappers and the old AvatarText implementation.
• Added accessible icon-avatar examples.

Badge

• Added the Geist-aligned variant, contrast, and size API.
• Added trial, turbo, and pill variants.
• Badges render as <span> by default and <a> when href is provided.
• Added badgeVariants() for styling external links.
• Added Lucide Svelte icons to the badge documentation.
• Added Geist badge best practices.
• Added badge style unit tests.
• Updated Turbo styling to use the branded gradient.

Breaking Changes

• Button:
  • variant="primary" is now variant="default".
  • iconPrefix and iconSuffix are replaced by prefix and suffix snippets.
• Avatar:
  • Removed GitHubAvatar, GitLabAvatar, BitbucketAvatar, and AvatarText.
  • Use Avatar, AvatarGroup, and AvatarWithIcon instead.
• Badge:
  • Replace variant="gray-subtle" with variant="gray" contrast="low".
  • Replace size="small", size="medium", and size="large" with sm, md, and lg.

Documentation

Updated the Button, Avatar, and Badge documentation and examples.

Validation

• Type checking passes.
• Lint passes.
• Production build passes.
• Avatar, badge, button, and utility tests were added or updated.