searchbar
by szpakkamil
Search & ResearchBrief
Expert guidance on SearchBar, a customizable SwiftUI search component.
Description
What This Skill Does
SearchBar is a SwiftUI library that provides a unified search component across iOS, iPadOS, macOS, and visionOS. It wraps UISearchBar on iOS and visionOS while using a native SwiftUI implementation on macOS, exposing a consistent modifier-based API for both. Advanced features like search tokens and dynamic suggestions require iOS 16+ or visionOS 1.0+.
Using UISearchBar directly requires UIKit bridging on iOS and has no macOS equivalent, while this library exposes one SwiftUI API that works consistently across all Apple platforms.
When to Use It
- Adding a styled search bar to a SwiftUI app without UIKit bridging
- Filtering content with tappable search tokens on iOS 16+
- Showing contextual suggestions as users type in a search field
- Applying glass or capsule visual styles to a search bar
- Shipping the same search UI across iPhone, iPad, Mac, and Vision Pro
Example Workflow
User asks: How do I add a search bar with token filtering to my SwiftUI app?
- 1
Confirm the deployment target is iOS 16.0+ to ensure token and suggestions support
- 2
Set up @State properties for text, active tokens, and suggestions array
- 3
Initialize SearchBar with the text binding and a prompt string
- 4
Attach .searchBarCurrentTokens and .searchBarSuggestions modifiers with their bindings
- 5
Apply .searchBarStyle to set shape and colors if custom appearance is needed
A SwiftUI view with a functional search bar that displays filter tokens and dynamic suggestions
Installation
clawhub install szpakkamil/searchbarRun the CLI command, or paste the prompt into Claude Code, Cursor, Codex or whichever coding agent you use.