Thumbprint Tokens

Design variables that power Thumbtack’s UI.

Thumbprint Tokens are published as JavaScript, SCSS, Swift, and Kotlin.

Platform	Languages	Package
Web	React & SCSS
Android	Kotlin
iOS	Swift	Swift Package Manager

API

You can use the Thumbprint Tokens GraphQL server to query tokens and view the schema.

Releasing

1. Pull latest changes: Run git checkout master && git pull to grab the latest changes rom GitHub.
2. Update the package.json and changelog: Edit the version in the package.json and then open the CHANGELOG.md file and look at the unreleased changes. Add the new version number (following SemVer) and date as a heading under the ## Unreleased heading.
3. Commit the changelog changes: Commit the changes on master with git add CHANGELOG.md package.json && git commit -m "Preparing for release."
4. Create a Git tag: Run git tag vX.Y.Z, replacing X.Y.Z with the new version number.
5. Release to NPM: Run yarn install && yarn release.
6. Push to GitHub: Run git push --tags to push the changes to GitHub.
7. Publish to JitPack: Visit https://jitpack.io/com/github/thumbtack/thumbprint-tokens/12.1.1/build.log but replace 12.1.1 with the new version number. This will kick off a build in JitPack which will be indicated on the JitPack Thumbprint Tokens page.

Installation

Swift Package Manager

Swift Package Manager is a tool for managing the distribution of Swift code. It’s integrated with the Swift build system to automate the process of downloading, compiling, and linking dependencies.

Xcode 11+ is required to build SwiftRunOnce using Swift Package Manager.

To integrate ThumbprintTokens into your Xcode project using Swift Package Manager, add it to the dependencies value of your Package.swift:

dependencies: [
    .package(url: "https://github.com/thumbtack/thumbprint-tokens.git", .upToNextMajor(from: "12.3.0"))
]

Changelog

Unreleased

Fixed

13.0.1 - 2023-03-28

• [Patch] Fix font weight for iOS

13.0.0 - 2023-03-28

Changed

• [Patch] Use Swift Package Manager instead of CocoaPods

12.2.2 - 2023-01-30

Fixed

• [Patch] Attempt to fix the Android build, part 2.

12.2.1 - 2023-01-27

Fixed

• [Patch] Attempt to fix the Android build.

12.2.0 - 2023-01-24

Added

• [Minor] Add font size, weight, line height, corner radius, and letter spacing for Android.

12.1.1 - 2020-07-08

Changed

• [Patch] Update color palette to improve accessibility.

12.1.0 - 2020-01-22

Changed

• [Minor] Add UIFont.TextStyle properties to support Dynamic Type.

12.0.1 - 2020-01-15

Changed

• [Patch] Fix the bold/normal token schema. This doesn't affect the distributed code.

Fixed

• [Patch] Fix value of Title 2 font size on iOS.

12.0.0 - 2020-01-14

Added

• [Minor] Add iOS, JavaScript, and SCSS CornerRadius tokens. (#25)

Deprecated

• [Patch] Deprecate BorderRadius in favor of a more cross-platform friendly CorderRadius. (#25)

Changed

• [Major] Rename iOS duration tokens to one, two, three (and so on…) rather than duration1, duration2, etc…

11.0.0 - 2019-12-18

Changed

• [Major] Change JS and Android duration tokens from number to string.

10.1.4 - 2019-12-13

Fixed

• [Patch] Prepend $ to duration and easing SCSS tokens.
• [Patch] Remove ms from duration JS tokens.

10.1.3 - 2019-12-10

Fixed

• [Patch] Actually fix tag types in Android build. (#11)

10.1.2 - 2019-12-09

Fixed

• [Patch] Fix white token value for iOS. It broke in 10.1.1. (#12)
• [Patch] Fix tag types in Android build. (#11)

10.1.1 - 2019-12-06

Fixed

• [Patch] Fix code generated by Swift output. (#9)

10.1.0 - 2019-12-06

Added

• [Minor] Add tokens for light and dark scrims. These are values for transparent light and dark curtains that cover content.
• [Minor] Add tokens for animation durations for all platforms and easings for SCSS/JS only.

10.0.0 - 2019-11-05

• [Minor] Add Android support through JitPack.

8.3.3 - 2019-10-17

Added

• [Minor] Add TypeScript definitions to the CJS and ESM tokens, and switch to using the TypeScript compiler to generate these files.

8.3.2 - 2019-09-17

Changed

• [Patch] Upgrade handlebars, a devDependency. This does not affect the outputted code.

8.3.1 - 2019-09-03

Changed

• [Patch] Upgrade fs-extra, a devDependency. This does not affect the outputted code.

8.3.0 - 2019-08-21

Added

• [Minor] Add shadow tokens for web.

Deprecated

• [Patch] Deprecate shadow-card token for web. It has been replaced by shadow-100, shadow-200, shadow-300, and shadow-400

8.2.0 - 2019-07-31

Added

• [Minor] Create an Android output.

8.1.1 - 2019-07-15

Changed

• [Patch] Refactor source files to document iOS tokens. This does not affect the "dist" files.

8.1.0 - 2019-07-01

Added

• [Minor] Add iOS output and publish as the ThumbprintTokens CocoaPod.

8.0.2 - 2019-06-03

Changed

• [Patch] Remove the temporary tokens added in 8.0.1.

8.0.1 - 2019-05-28

Changed

• [Patch] Temporarily bring back removed Tokens to make it easier to migrate to 8.0.0.

8.0.0 - 2019-05-24

Changed

• [Major] Rename a handful of SCSS and JavaScipt tokens.
• [Patch] Change the internals of how tokens are stored and generated. This does not affect the outputted code.

7.0.0 - 2019-05-17

Removed

• [Major] Remove all deprecated tokens. Old values can be found on a previous version of the Thumbprint site.

6.3.4 - 2019-05-15

Changed

• [Patch] Remove the "name" field from tokens in their source files. This does not affect the outputted code.

6.3.3 - 2019-04-08

Changed

• [Minor] Add supported platforms to each token (#198)

6.3.2 - 2019-04-02

Changed

• [Patch] Simplify script that generates tokens.
• [Patch] Under-the-hood changes that will allow for future tokens without a tp prefix.

6.3.1 - 2019-03-11

Changed

• [Patch] Remove notion of "private" tokens. They now all documented and can be used. (#145)

6.3.0 - 2019-02-07

Added

• [Minor] Add title type styles for sizes 6, 7, and 8. (#70)

6.2.4 - 2019-01-30

Changed

• [Patch] Use Apache License 2.0.

6.2.3 - 2018-11-27

Changed

• [Patch] Publish package to public NPM.

Deprecated

• [Patch] Deprecate the tokens in the "Avatar" section.