Skip to content

docs: graduate v2 to stable releases #163

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鈥檒l occasionally send you account related emails.

Already on GitHub? Sign in to your account

Merged
xiaoyijun merged 1 commit into from
Sep 10, 2026
Merged

docs: graduate v2 to stable releases #163

Show file tree
Hide file tree
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
9 changes: 4 additions & 5 deletions MIGRATION.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -210,9 +210,8 @@ button.
Browser sign-in and browser sign-out are currently available on iOS. On non-iOS
platforms, use `clearCredentials()` for local credential clearing.

## Installing the beta
## Installing v2

v2 is released through Git tags. For the first beta, use the prerelease tag
`v2.0.0-beta.1` when it is published. Swift Package Manager and Xcode can resolve
SemVer prerelease tags, but callers should select the prerelease explicitly instead
of relying on a normal version range to pick it automatically.
v2 is released through Git tags. Select `2.0.0` or a later `2.x` version when adding
the package in Swift Package Manager or Xcode. The `2.0.0-beta.x` prereleases are
superseded by the stable release.
6 changes: 3 additions & 3 deletions README.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -16,8 +16,8 @@ The monorepo for [Logto](https://github.com/logto-io) SDKs written in Swift. Che

| Version | Branch | Status |
|---|---|---|
| v2 (beta) | [`master`](https://github.com/logto-io/swift/tree/master) | In development - released as `2.0.0-beta.x` prereleases until GA |
| v1 (stable) | [`v1.x`](https://github.com/logto-io/swift/tree/v1.x) | Maintenance - bug fixes only |
| v2 (stable) | [`master`](https://github.com/logto-io/swift/tree/master) | Active development - new features and fixes |
| v1 (maintenance) | [`v1.x`](https://github.com/logto-io/swift/tree/v1.x) | Bug fixes only |

v2 moves the iOS sign-in experience from an embedded WebView to `ASWebAuthenticationSession` (the system browser), unlocks WebAuthn/passkeys and shared browser sessions, removes native social plugin targets, and revamps the sign-out API.

Expand All @@ -34,7 +34,7 @@ Since Xcode 11, you can [directly import a swift package](https://developer.appl
https://github.com/logto-io/swift.git
```

v2 is in beta: use `2.0.0-beta.1` for the first beta, or the latest `2.0.0-beta.x` prerelease when selecting a package version. For the stable v1 line, see [Versions](#versions).
Select `2.0.0` or a later `2.x` version when adding the package. For the v1 maintenance line, see [Versions](#versions).

### Carthage

Expand Down
Loading