Skip to content

docs: swift quickstart improvements as guided by evals flywheel to improve Agentic experience #1386

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

Merged
sanchitmehtagit merged 2 commits into from
Jun 15, 2026
Merged

docs: swift quickstart improvements as guided by evals flywheel to improve Agentic experience #1386

Changes from all commits
Commits
Show all changes
2 commits
Select commit Hold shift + click to select a range
5af093a
docs(ios-swift): add CredentialsManager callout in Step 5
sanchitmehtagit Jun 12, 2026
9167b58
adding warning for not using raw values and use plist based approach
sanchitmehtagit Jun 12, 2026
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
10 changes: 9 additions & 1 deletion main/docs/quickstart/native/ios-swift.mdx
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -163,7 +163,11 @@ Your AI assistant will automatically create your Auth0 application, fetch creden
</Step>

<Step title="Create the Authentication Service" stepNumber={5}>
Create `AuthenticationService.swift`:
Create `AuthenticationService.swift` to handle login, logout, and token storage.

<Info>
**Use `CredentialsManager` for token storage.** The `CredentialsManager` class securely stores credentials in the Keychain and automatically refreshes expired access tokens. Always use it — do not store tokens in memory, `UserDefaults`, or `localStorage`.
</Info>

1. Right-click your project → **New File...** → **Swift File**
2. Name it `AuthenticationService`
Expand Down Expand Up @@ -370,6 +374,10 @@ This is **required** for certain features to work properly:
<Accordion title="Advanced Integration">
### Programmatic Configuration

<Warning>
Never hardcode `clientId` or `domain` values directly in Swift source files — they will be committed to version control. Read them from environment variables or a build-time configuration file at runtime. For most apps, prefer `Auth0.plist` (the default approach in this quickstart).
</Warning>

Instead of using `Auth0.plist`, you can pass credentials directly in your code. This is useful when credentials need to be dynamic or environment-specific (e.g., different Auth0 tenants for dev/staging/production).

**Replace `Auth0.webAuth()` calls with `Auth0.webAuth(clientId:domain:)`:**
Expand Down
Loading