Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

update ios quickstart #1983

Merged
merged 1 commit into from
Feb 5, 2025
Merged

update ios quickstart #1983

Changes from all commits
Commits
Show all changes
1 commit
Select commit
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
38 changes: 20 additions & 18 deletions docs/quickstarts/ios.mdx
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -47,28 +47,30 @@ description: Add authentication and user management to your iOS app with Clerk.
To use Clerk in your app, you must first configure and load `Clerk`.

- Inside your new project in Xcode, open your `@main` app file.
- Import `ClerkSDK`.
- Add a new variable `clerk` marked with the `@ObservedObject` property wrapper.
- Import `Clerk`.
- Create a reference to the shared `Clerk` instance.
- Replace `ContentView()` with the below `ZStack`.
- Inject your reference to the shared `clerk` instance into the environment.
- Attach a `.task` modifier to the new `ZStack`. In the body of the task, configure `clerk` with your Publishable Key, and then load `clerk`. You can get your Publishable Key from the [**API keys**](https://dashboard.clerk.com/last-active?path=api-keys) page in the Clerk Dashboard.

```swift {{ filename: 'ClerkQuickstartApp.swift', mark: [2, 6, [10, 20]] }}
```swift {{ filename: 'ClerkQuickstartApp.swift', mark: [2, 6, [10, 21]] }}
import SwiftUI
import ClerkSDK
import Clerk

@main
struct ClerkQuickstartApp: App {
@ObservedObject private var clerk = Clerk.shared
private var clerk = Clerk.shared

var body: some Scene {
WindowGroup {
ZStack {
if clerk.loadingState == .notLoaded {
ProgressView()
} else {
if clerk.isLoaded {
ContentView()
} else {
ProgressView()
}
}
.environment(clerk)
.task {
clerk.configure(publishableKey: "{{pub_key}}")
try? await clerk.load()
Expand All @@ -83,16 +85,16 @@ description: Add authentication and user management to your iOS app with Clerk.
To render content based on whether a user is authenticated or not:

- Open your `ContentView` file.
- Import `ClerkSDK`.
- Add a new variable `clerk` marked with the `@ObservedObject` property wrapper.
- Import `Clerk`.
- Access the shared `Clerk` instance that you injected into the environment in the previous step.
- Replace the content of the view body with a conditional that checks for a `clerk.user`.

```swift {{ filename: 'ContentView.swift', mark: [2, 5, [8, 14]] }}
import SwiftUI
import ClerkSDK
import Clerk

struct ContentView: View {
@ObservedObject private var clerk = Clerk.shared
@Environment(Clerk.self) private var clerk

var body: some View {
VStack {
Expand All @@ -114,7 +116,7 @@ description: Add authentication and user management to your iOS app with Clerk.

```swift {{ filename: 'SignUpView.swift' }}
import SwiftUI
import ClerkSDK
import Clerk

struct SignUpView: View {
@State private var email = ""
Expand Down Expand Up @@ -180,7 +182,7 @@ description: Add authentication and user management to your iOS app with Clerk.

```swift {{ filename: 'SignInView.swift' }}
import SwiftUI
import ClerkSDK
import Clerk

struct SignInView: View {
@State private var email = ""
Expand Down Expand Up @@ -253,10 +255,10 @@ description: Add authentication and user management to your iOS app with Clerk.

```swift {{ filename: 'ContentView.swift', mark: [12] }}
import SwiftUI
import ClerkSDK
import Clerk

struct ContentView: View {
@ObservedObject private var clerk = Clerk.shared
@Environment(Clerk.self) private var clerk

var body: some View {
VStack {
Expand All @@ -279,10 +281,10 @@ description: Add authentication and user management to your iOS app with Clerk.

```swift {{ filename: 'ContentView.swift', mark: [[11, 13]] }}
import SwiftUI
import ClerkSDK
import Clerk

struct ContentView: View {
@ObservedObject private var clerk = Clerk.shared
@Environment(Clerk.self) private var clerk

var body: some View {
VStack {
Expand Down