TIDAL SDK for iOS
  • Swift 96.4%
  • Mustache 2.6%
  • Shell 0.9%
  • HTML 0.1%
Find a file
Repository files (latest commit first)
Filename Latest commit message Latest commit date
2025-07-28 14:27:39 +00:00
.claude Updated README and initialized the CLAUDE.md instructions file to gather information about it for future development 2025-07-15 16:39:52 +02:00
.github Fix workflow checkout conflicts by diffing instead of checkout 2025-07-17 09:22:00 +02:00
.swiftpm/xcode/xcshareddata/xcschemes Flatten history 2024-05-28 06:32:46 +02:00
bin Update swiftlint CLI version 2024-10-11 09:31:33 +02:00
Scripts Use absolute URLs in documentation links 2024-05-28 13:57:17 +02:00
Sources Updating generated code for TidalAPI Changes in Input folder:\n D Sources/TidalAPI/Config/input/tidal-api-oas-prod.json 2025-07-28 14:12:41 +02:00
TestApps Specify simulator target better in unit test CI script 2025-04-15 09:35:12 +02:00
Tests Add extra data to StreamingSessionStart for performance monitoring 2025-04-14 16:45:18 +02:00
.git-blame-ignore-revs Add fix and lint in the pre-commit hook, and update the local-setup script 2024-12-05 13:41:47 +01:00
.gitignore Flatten history 2024-05-28 06:32:46 +02:00
.pre-commit-config.yaml Add fix and lint in the pre-commit hook, and update the local-setup script 2024-12-05 13:41:47 +01:00
.swiftformat Manually fix Identifiable conformance for some generated types 2025-04-01 10:25:53 +02:00
.swiftlint.yml Manually fix Identifiable conformance for some generated types 2025-04-01 10:25:53 +02:00
CHANGELOG.md Bump SDK and update CHANGELOG 2025-07-28 15:58:16 +02:00
CLAUDE.md Updated README and initialized the CLAUDE.md instructions file to gather information about it for future development 2025-07-15 16:39:52 +02:00
generate-module.sh Flatten history 2024-05-28 06:32:46 +02:00
LICENSE Flatten history 2024-05-28 06:32:46 +02:00
local-setup.sh Add fix and lint in the pre-commit hook, and update the local-setup script 2024-12-05 13:41:47 +01:00
Package.resolved Remove swiftlint plugin 2024-12-05 12:18:09 +01:00
Package.swift Remove swiftlint plugin 2024-12-05 12:18:09 +01:00
README.md Updated README and initialized the CLAUDE.md instructions file to gather information about it for future development 2025-07-15 16:39:52 +02:00
renovate.json Flatten history 2024-05-28 06:32:46 +02:00
version.txt Bump SDK and update CHANGELOG 2025-07-28 15:58:16 +02:00

TIDAL iOS SDK

This is the repository for TIDAL SDK modules for iOS development.

Available modules

Getting started

  1. Clone the repository
  2. Run ./local-setup.sh
  3. All done!

How to create a new module

Run the generate-module.sh script. It will prompt you to enter a module name using PascalCase. After confirming the name, a new directory will be created with the basic module setup. Open this in your IDE and start working.

SPM Installation

  1. Navigate to the project inside the project navigator
  2. Select "Package Dependencies" tab
  3. Tap the plus button
  4. Inside the search, paste the following link: https://github.com/tidal-open-source/tidal-sdk-ios
  5. Select the packages you wish to import

note: make sure to select the latest version or a desired branch when importing the SPM

How to preview documentation locally

Using Xcode

  • Go to Product > Build documentation

Using the command line

  • To generate a preview of the documentation from the command line, you first need to set the environment variable $INCLUDE_DOCC_PLUGIN=true
  • Then, run the following command for the desired module you want to preview documentation
swift package --disable-sandbox preview-documentation --target Module

Creating a module release

  1. Bump the version stored in version.txt in the repo root directory to the desired value. Follow Semantic Versioning. Also, you cannot downgrade - the CI/CD pipeline will refuse to work with downgrades.

  2. Update CHANGELOG.md with the new version and the changes made.

  3. Open a Pull Request with your version bump, get it approved and merge it. A release draft will be created for the module you changed.

  4. Find your draft in the releases list and add some meaningful sentences about the release, changelog style (Note: This paragraph is temporary, as we will automate and regulate changelog creation, but for now, you are free to just type)

  5. Check in with your teammates, lead, the module's owner etc. to make sure the release is ready to go.

  6. Click Publish at the bottom of your draft release. This will trigger a workflow to tag the release commit.