iOS

circle-info

For technical detailed release information, visit our Github repository

https://github.com/Lucra-Sports/lucra-ios-sdk/releasesarrow-up-right

3.3.0arrow-up-right Latestarrow-up-right

🏆 Tournament & Game Enhancements

  • Improved tournament bottom sheet titles to correctly show final results.

  • Updated leaderboard crowns and tournament join logic.

  • Removed unnecessary payout and reward columns in tournament views.

  • Applied cosmetic and layout updates to F2P tournaments.

🎮 UI/UX Improvements

  • Fixed header issues on small devices and improved button layouts.

  • Enhanced drag-and-drop behavior in Manage Matchup by removing the green plus indicator.

  • Adjusted card alignment and invite state handling after matches.

  • Improved games loading state display.

📢 Messaging & Communication

  • Added a temporary KYC failure notification message

3.2.0

🔒Private Tournaments

  • Clients have the ability to toggle the private tournament feature on via the console

  • Clients can manually set a 6 character join code via the console

  • Users are able to join private tournaments via the key icon on the search page in the UI and join a tournament by entering the code created by an admin

  • Private tournaments will be signified in the UI by a small key icon found on the home dashboard screen on the specific tournament tile and the tournament details screen.

 🤾‍♂️ Play Again

  • Clients have the ability to toggle the play again feature on via the console

  • Users will currently only be have 3 attempts per tournament.

  • When a user completes a round/game in a tournament they will receive a replay reminder at the top of their home dashboard screen in our UI to push them to buy in again

  • We have specific copy depending on user ranking that is shown to users after their round is completed which has the goal of persuading them to join again

 💯Age Assurance Removal

  • Users will no longer have to provide KYC information to be approved for Free to Play Games & Tournaments

  • Users will now be prompted for basic demographic information

    • DOB, Zip, Email

3.1.1

  • Bug fixes and improvements

3.1.0

Free to Play Games

  • Users can now wager on peer-to-peer matchups for rewards

  • Web SDK reward ingestion at run time

  • Rewards carousels for users to pick which prizes they play for

3.0.1

• Misc Bug Fixes

3.0.0

This is a major release that includes breaking API changes. If you are integrating or upgrading, please refer to the official migration guide:

📚 iOS SDK Migration Guidearrow-up-right


Breaking Changes & Migration

New APIs:

  • getRecreationalGamesMatchup(matchupId:)

  • createRecreationalGame(...)

  • acceptVersusRecreationalGame(...)

  • acceptFreeForAllRecreationalGame(...)

  • cancelRecreationalGame(...)

Deprecated APIs:

  • getGamesMatchup(...)

  • createContest(...)

  • acceptGamesMatchup(...)

  • cancelGamesYouPlayContest(...)

Updated Event Names:

Lucra SDK Events have been renamed to reflect the updated GYP model:

  • GameMatchupCreatedRecreationalGameCreated

  • GameMatchupAcceptedRecreationalGameJoined

  • GameMatchupCancelledRecreationalGameCanceled

  • GameMatchupOutcomeRecreationalGameCompleted

Please update your event listeners accordingly. Refer to the migration guidearrow-up-right for event payload changes and migration examples.


Code Updates

  • Support for Group Play and Free-for-All matchup types.

  • Introduced new matchup model: LucraMatchup with updated group structures and metadata.

  • Tournament support improvements and new tournament details display logic.

  • Spread logic removed from matchup creation; adjusted display conditions.

  • Simplified matchup creation by removing the confirm step after team selection.

  • Enhanced Terms of Service presentation and acceptance tracking.

  • Location prompting added for sensitive flows (withdrawal/deposit).

  • sdkVersion and deviceOS headers now included in all network requests.

  • Public feed segmented by "Live" and "Coming Up" games.

  • Firebase Crashlytics integration added to the SDK sample app.

  • UI and bug fixes across matchup details, group handling, and result tracking.


Version Summary

Version
Notes

3.0.0

Major release with API-breaking changes and updated model structure

2.5.x

Fast-follow updates for new features and bugfixes

2.4.x and earlier

Legacy API support, not compatible with new matchup formats


2.5.3

2.5.2

• Resolves a display issue with the "Payout" section of the Tournament Matchup Card.

2.5.1

• Resolved a bug with incorrect mapping for the TournamentsMatchup Participant object.

2.5.0

  • Games You Play experience improvements

  • Live Sports You Watch functionality

2.4.3

  • Introduced GamesMatchupById Flow

  • Introduced Tournaments FE events

  • Various bug fixes

2.3.0

  • Introduced UX support for Tournament functionality

  • Tournament payload updates

2.2.0

  • Introduced support for Tournament headless functionality

2.1.2

• Introduced Nuvei for Deposits • Allow CreateGamesMatchupById LucraFlow • Various Bug Fixes

2.0.0

  • Introduced support for Free to Play Sports

1.9.1

  • 🔨Adds support for Xcode 16.1.

1.9.0

  • Updated Payment Processor For Withdrawals - We have updated our payment processor for withdrawals from Interchecks to Nuvei

  • Updated Games Icons - Support for colored GYP icons

1.8.3

  • Fix to prevent SDK warnings from showing

1.8.2

  • Welcome Screen - Users will now see a welcome screen after they authenticate that gives them a brief education about our feature!

  • Add Funds Tooltip - We have added a tooltip that pushes users to add funds when they land on the “Choose Your Game” screen in an attempt to get them to deposit before the end of the CAC flow.

  • Updated Contest Share Flow

1.8.1

  • Convert to Credit - Users can now convert their funds to credit for potential bonuses! Clients can determine a conversion amount for these transactions. They can pass in the name of the credit and other details about it to inform the user of the bonuses they will receive for using this feature.

  • Various Fixes and Improvements

1.8.0

  • Paypal/Venmo - Users now have the ability to deposit and withdraw via Paypal or Venmo! All withdrawals are instantaneous as well!

  • Rematch Flow - After users finish a GYP contest they now have the ability to rematch the user that they played with before, automatically sending them a notification to join the new contest.

1.7.0

  • Light/Dark Mode Support - We will now be able to change our theming based on if the user is in light or dark mode!

  • Decrease Opacity of User Avatar Before Contest is Joined - To make it more obvious that a user is not yet in a contest we have decreased the opacity of their username and avatar until they have joined.

  • Configurable Withdrawal Screen Copy - We can now adjust any of the text in the warning message about the waiting period until a user can withdraw or remove it entirely.

  • Copy Change of “Contest” to “Matchup” - We now consistently use “matchup” across iOS and Android

  • Various Bug Fixes and Improvements

1.6.1

  • Withdrawal Waiting Period - Users will now only have to wait 24 hours between a deposit and withdrawal. users will also have to complete a contest during this time before withdrawing.

  • Implementation of suggested contest amounts

  • Various Bug Fixes and Improvements

1.5.0

  • Ability to Edit Usernames - Users can now edit their usernames in their profile.

  • Responsible Gaming - Users can now self-exclude themselves from depositing, creating, and accepting contests.

  • Removed Logging To OSLog if LucraLogging Callback Is Registered

  • Added Codable Conformance to SportsMatchup and GamesMatchup models

  • Various Bug Fixes and Improvements

1.4.1

  • Games You Play Module - Users can engage in contests on recreational activities against their peers. They can share these contests via QR code or text.

  • Take 'em Cards - These new contest cards allow users to quickly create contests based on recommended players and stats for the day. They will be present throughout the public feed.

  • Notifications - Push notifications have been enabled in the SDK which will notify users for things such as another user joining their contest, a contest completing, etc so that they are aware in real time.

  • Contest Card Component - Our contest cards are now available as embeddable components to be placed anywhere in client apps.

  • H2H Stats - In the user profile, users will now be able to click on another user’s username and view their stats against that user.

  • Lock User Phone Number When Passed In - When a user’s phone number is passed in they will not be able to edit it during the authentication flow to prevent account issues.

  • Sharing via QR/Text in SYW - Users can now share sports contests via QR code and text!

  • Recommended matchup as a component - Our recommended matchups banner can now be embedded throughout client apps.

  • Remove Biometric SDK Init - Face ID removed when the profile pill is present on screens throughout client app to prevent a poor UX of being face ID’d several times

  • Removes blocked state screen allowing user to view the public feed

  • Reduces SDK XCFramework size by over 30%

  • Fixed dynamic view sizing for UIKit Components

  • SYW Contest Details Endpoint Exposed

  • Various Bug Fixes and Improvements

1.3.8

  • Updated Lucra Wordmark and Copy - Updates to several screens that deal with authentication and transactions to include the lucra logo and have also made minor copy updates to meet bank requirements.

  • Upgrade to Mobile Intelligence SDK - Upgrade to our mobile intelligence SDK to prevent crashing issues that occurred on the version we were previously running.

  • Various Bug Fixes and Improvements - Fixes a bug that caused the search bar and public feed filters to be pushed up when there was no recommended matchup present.

1.3.3

  • Bug Fixes and Improvements

1.3.0

  • Mini Public Feed as a Component - public feed can now be launched on its own as a component

  • User Profile Pill as a Component - user profile pill can now be launched on its own as a component

  • Contest Details API Call - Contest details such as wager amount, status, game type, time of creation can now be called from our API

  • KYC info can now be passed in by the client and pre-populated when a user goes through our KYC flow.

  • Various Bug Fixes and Improvements

1.0.2

Breaking changes:

  • The LucraClient init environment now takes in a new field apiURL and authenticationClientID renamed to apiKey

  • The configure function has been updated to be async/await and throw errors if the update failed.

Navigational Improvements:

  • There is now a notifications bell that appears on the user profile pill when they have notifications to view.

  • There is also a glow that will appear on the user profile pill when a user has an active contest.

  • These changes are meant to assist users in finding their contests and notifications.

Other Changes:

  • Updated public feed to not require login so users can get a preview of the functionality before providing phone number

  • Fixed an issue where remaining deposit matching amount was sometimes off by 1 transaction

  • Various enhancements and bug fixes to KYC flow

  • Addition of analytics event tracking to support the client dashboard

  • Updated the withdrawal selection UI to simplify user interaction

  • Added a withdrawal minimum amount to cover 3rd party fees

0.8.0

  • LF-2340 Player 2 sort order wrong for season avgs

  • LF-2610 Enable SDK Test Phone Numbers

  • LF-2544 - Re-work Pop-up After User Creates Contest

  • LF-2397 - “Why You Need Info” Popup Issue

0.7.5

  • Fixing bugs and improving user experience

  • Updating and fixing create a contest flow

  • Updating MobileIntelligence SDK

  • Add funds error handling updates

  • Updating add bank account flow

  • Fixing and updating user profile error handling

  • Fixing crash during withdraw funds flow

  • Updating player sort feature

  • Search bar text updates

0.7.4

  • My contest fixes

  • Contact support sdk fixes

  • LF-2390 notifications page

  • Lf 2419 add card error

  • My contests banner missing info

  • Misc fixes for onboarding phone number views

  • 🏆 CAC module

  • Fixing geocomply errors, and exposing static sdk version

  • LF-2431: ID Scan Loop

  • Lf 2408 withdraw available funds

  • Contest Details

  • LF-1863: Transition Bank Aggregation From Yodlee to Aerosync

  • 📈 My Stats

  • LF-2461 - Show Username in User Profile

  • LF-2483: Remove Share Button from Contest Cards

  • LF-2480: Unable to Delete CCs

  • LF-2484 - Remove Card State with "Send Reminders"

  • LF-2498 - Contest Accepted Popup Not Shown in Contest Details

  • LF-2408 - Fixing money no cents rounding

  • Sdk package updates

  • LF-2376: Sardine in the SDK

  • LF-2533 x button from view contest not working,

  • LF-2519 remove clickable usernames

  • LF-2523: Use New BE Action Related to Deleting Payment Methods

  • Removing pasteboard from sardine sdk popping up constantly

0.6.0

  • Recommended Matchups Banner on public feed module

  • Public Contest Feed module

  • Viewing 'My Contests' in User Profile which shows all active contests for the user

  • Access to Apple Pay as a Deposit Method

  • Improvements to onboarding screens including better handling continue button placement, submitting state, and error state fixes

  • Onboarding Privacy Policy link fix

Last updated