The TIDAL SDK for Web enables fast prototyping and development of new web apps built on TIDAL Developer Platform by providing core functionality in a set of easy-to-use software modules.
The TIDAL SDK for Web serves as a complement to, and extension of, the TIDAL API, meaning that some functionality provided by the TIDAL Developer Platform will only be made available through the TIDAL SDK, whereas some functionality will be available via both the TIDAL API and the TIDAL SDK.
All public modules are documented and described. Please also have a look at the examples in the modules since they show more of the use cases.
git clone git@github.com:tidal-music/tidal-sdk-web.git
cd ./tidal-sdk-web
# install deps
pnpm i
# run tests in all packages
pnpm test
# go to the package dir you want to work on
cd ./packages/event-producer
pnpm dev
Run:
./bin/generate-module.sh
And follow the prompts.
Bump your module's version to the desired value in your module's package.json file. You'll find an entry looking like this:
"version": "0.0.1",
Change version to the new value. Follow Semantic Versioning. Also, you cannot downgrade - the CI/CD pipeline will refuse to work with downgrades.
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.
Find your draft in the releases list and add some meaningful sentences about the release, changelog style (Note: We should automate and regulate changelog creation, but for now, you are free to just type).
Check in with your teammates, lead, the module's owner etc. to make sure the release is ready to go.
Click Publish at the bottom of your draft release. This will trigger a workflow to tag the release commit and attach artifacts to the release. It will also trigger publishing the package to Npm, where it should appear under @tidal-music Npm org shortly!