Turnkey Dart SDK

The Turnkey Dart SDK includes functionality to interact with Turnkey in various contexts and ecosystems. It provides everything you need to develop a fully working Flutter app powered by Turnkey.

Packages

Package Name	Description	Link
turnkey_sdk_flutter	An all-in-one package that simplifies the integration of the Turnkey API into Flutter mobile apps.	turnkey_sdk_flutter
turnkey_crypto	This package consolidates common cryptographic utilities used across our applications, particularly primitives related to keys, encryption, and decryption in a pure Dart implementation.	turnkey_crypto
turnkey_api_key_stamper	A Dart package for API stamping functionalities. It is meant to be used with Turnkey's HTTP package.	turnkey_api_key_stamper
turnkey_http	A lower-level, fully typed HTTP client for interacting with the Turnkey API.	turnkey_http
turnkey_encoding	This package contains decoding and encoding functions used by other Turnkey packages.	turnkey_encoding
turnkey_flutter_passkey_stamper	A Flutter package for stamping payloads with passkeys. It is meant to be used with Turnkey's HTTP package.	turnkey_flutter_passkey_stamper

Template

For the quickest and easiest way to create a Turnkey-powered Flutter app, check out our Turnkey Flutter Template.

Example App

For a fully functional Flutter demo app that leverages Turnkey's Dart/Flutter packages, check out our Turnkey Flutter Demo App.

🧑‍💻 Development

Guidelines for setting up the workspace, running tests, and contributing code to the Turnkey Dart SDK

Commit Conventions

Follow Conventional Commits to ensure automated versioning works correctly.

Type	Description	Version bump
fix:	Bug fixes, dependency updates, or non-breaking changes	Patch (0.3.0 → 0.3.1)
feat:	New features or functionality additions	Minor (0.3.0 → 0.4.0 pre-1.0)
feat!: / BREAKING CHANGE:	Backward-incompatible changes	Breaking / Major (0.3.x → 0.4.0 pre-1.0, 1.x → 2.0.0 post-1.0)
chore:, docs:, test:, refactor:	Internal or documentation changes	No bump

🧮 Pre-1.0 rule: Dart treats a minor bump as breaking (0.3.x → 0.4.0).

---

🚀 Releasing

1. Bootstrap workspace

   melos bootstrap

2. Version packages

   melos version

   Auto-bumps versions and updates changelogs from commit history. Use --prerelease --preid=beta for beta tags.

3. Dry-run publish

   melos publish

4. Publish for real

   melos publish --no-dry-run

Melos publishes in dependency order and only releases packages with new versions.