# Seam Mobile Components for iOS

#### Prerequisites

* Xcode 15+
* iOS 16+ target

You should already have a Seam workspace and API key set up. If you’re new to Seam, start with the [Seam Mobile SDK](https://docs.seam.co/latest/developer-tools/mobile-sdks/ios-sdk).

***

### Installation

Add the [Seam Mobile Components](https://github.com/seamapi/ios) package via Swift Package Manager:

```swift
dependencies: [
    .package(url: "https://github.com/seamapi/iOS", from: "1.0.0")
]
```

Then import it in your SwiftUI code:

```swift
import SeamComponents
```

***

### Quick Start: `SeamAccessView`

The fastest way to get started is with SeamAccessView.

This view orchestrates all the underlying Mobile Seam Components to deliver a complete unlock experience.

```swift
import SwiftUI
import SeamSDK
import SeamComponents

struct ContentView: View {
    init() {
        try? Seam.initialize(clientSessionToken: "YOUR_CLIENT_SESSION_TOKEN")
    }

    var body: some View {
        SeamAccessView()
    }
}
```

That’s it — you now have a ready-to-use, production-ready unlock interface.

***

### How It Works with the Seam Mobile SDK

* If you’re using Seam Mobile SDK:

  SeamAccessView automatically hooks into the SDK for device discovery, credential management, and unlock flows. No extra setup is needed.
* If you’re only using Mobile Seam Components:

  You still get a fully functional unlock UI without writing SDK-level code. Under the hood, the component takes care of talking to the Seam SDK for you.

Think of SeamAccessView as a shortcut to a complete access solution, while the SDK gives you deeper programmatic control.

***

### Customization with `SeamTheme`

Mobile Seam Components are white-label ready. You can use SeamTheme to apply your brand colors, fonts, and visual style across all components.

```swift
SeamAccessView()
    .seamTheme(.init(
        accentColor: .blue,
        backgroundColor: .black,
        cornerRadius: 12
    ))
```

By default, components are styled with Seam’s design system, but theming lets you align them to your app’s identity.

***

### See Also

* Explore [Seam Mobile SDK](https://docs.seam.co/latest/developer-tools/mobile-sdks/ios-sdk)


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.seam.co/latest/ui-components/seam-mobile-components/seam-mobile-components-for-ios.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
