> ## Documentation Index
> Fetch the complete documentation index at: https://docs.vibetunnel.sh/llms.txt
> Use this file to discover all available pages before exploring further.

# Docs

# Apple UI Documentation Index

## Quick Navigation

### Liquid Glass Design

* [Overview](liquid-glass/overview.md) - Core concepts, platform availability
* [AppKit Implementation](liquid-glass/appkit.md) - NSGlassEffectView usage
* [SwiftUI Implementation](liquid-glass/swiftui.md) - glassEffect() modifier
* [Common Patterns](liquid-glass/patterns.md) - Reusable components & techniques

### Toolbar Features

* [SwiftUI Toolbar Features](toolbar/swiftui-features.md) - Customization, search, transitions

## API Quick Lookup

### Liquid Glass APIs

| Task             | SwiftUI                                     | AppKit                           |
| ---------------- | ------------------------------------------- | -------------------------------- |
| Apply glass      | `.glassEffect()`                            | `NSGlassEffectView()`            |
| Set shape        | `.glassEffect(in: .rect(cornerRadius: 16))` | `glass.cornerRadius = 16`        |
| Add tint         | `.glassEffect(.regular.tint(.blue))`        | `glass.tintColor = NSColor.blue` |
| Make interactive | `.glassEffect(.regular.interactive())`      | Custom mouse tracking            |
| Container        | `GlassEffectContainer { }`                  | `NSGlassEffectContainerView()`   |
| Button style     | `.buttonStyle(.glass)`                      | Custom GlassButton class         |
| Morphing         | `.glassEffectID("id", in: namespace)`       | Manual animation                 |

### Toolbar APIs

| Task                   | SwiftUI Code                                               |
| ---------------------- | ---------------------------------------------------------- |
| Customizable toolbar   | `.toolbar(id: "main") { }`                                 |
| Add item               | `ToolbarItem(id: "save") { }`                              |
| Add spacer             | `ToolbarSpacer(.flexible)`                                 |
| Minimize search        | `.searchToolbarBehavior(.minimize)`                        |
| Reposition system item | `DefaultToolbarItem(kind: .search, placement: .bottomBar)` |
| Transition source      | `.matchedTransitionSource(id: "btn", in: namespace)`       |

## Decision Trees

### When to Use Liquid Glass

```
Need glass effect?
├─ Single view → .glassEffect() / NSGlassEffectView
└─ Multiple views
   ├─ Need merging → Use Container
   └─ Independent → Individual glass effects
```

### Choosing Framework

```
Platform target?
├─ iOS only → SwiftUI
├─ macOS only
│  ├─ Need AppKit integration → NSGlassEffectView
│  └─ Pure SwiftUI app → .glassEffect()
└─ Cross-platform → SwiftUI with platform checks
```

## Performance Guidelines

| Scenario      | Recommendation               | Max Count |
| ------------- | ---------------------------- | --------- |
| Static UI     | Individual glass effects     | 5-10      |
| Dynamic lists | Container + lazy loading     | 20-30     |
| Animations    | Disable during transitions   | N/A       |
| Scrolling     | Disable glass when scrolling | N/A       |

## Common Tasks

### Create Glass Button

* **SwiftUI**: `Button("Click").buttonStyle(.glass)`
* **AppKit**: See [Glass Button Pattern](liquid-glass/patterns.md#glass-button)

### Animate Glass Tint

* **SwiftUI**: `.glassEffect(.regular.tint(condition ? .blue : .clear))`
* **AppKit**: `NSAnimationContext` with `animator().tintColor`

### Merge Glass Effects

* **SwiftUI**: Wrap in `GlassEffectContainer(spacing: 40)`
* **AppKit**: Use `NSGlassEffectContainerView` with spacing

### Custom Toolbar

* **SwiftUI**: `.toolbar(id: "main")` with `ToolbarItem(id: "item")`

## Platform Requirements

| Feature               | iOS/iPadOS | macOS | visionOS |
| --------------------- | ---------- | ----- | -------- |
| Liquid Glass          | 17.0+      | 14.0+ | 1.0+     |
| Customizable Toolbars | 17.0+      | 14.0+ | N/A      |
| Glass Button Style    | 17.0+      | 14.0+ | 1.0+     |
| Matched Transitions   | 17.0+      | 14.0+ | 1.0+     |

## Migration Guide

### AppKit → SwiftUI

```swift theme={null}
// AppKit
let glass = NSGlassEffectView()
glass.cornerRadius = 16
glass.tintColor = NSColor.blue

// SwiftUI equivalent
View()
    .glassEffect(.regular.tint(.blue), in: .rect(cornerRadius: 16))
```

### Old Toolbar → New Toolbar

```swift theme={null}
// Old
.toolbar {
    Button("Save") { }
}

// New (customizable)
.toolbar(id: "main") {
    ToolbarItem(id: "save") {
        Button("Save") { }
    }
}
```

## Resources

### Apple Documentation

* [NSGlassEffectView](https://developer.apple.com/documentation/AppKit/NSGlassEffectView)
* [View.glassEffect](https://developer.apple.com/documentation/SwiftUI/View/glassEffect)
* [CustomizableToolbarContent](https://developer.apple.com/documentation/SwiftUI/CustomizableToolbarContent)

### Sample Projects

* [Landmarks: Liquid Glass](https://developer.apple.com/documentation/SwiftUI/Landmarks-Building-an-app-with-Liquid-Glass)

### WWDC Sessions

* Liquid Glass design principles
* Toolbar customization in SwiftUI