diff --git a/packages/design-tokens/README.md b/packages/design-tokens/README.md
index 09e0187c9..f115abb74 100644
--- a/packages/design-tokens/README.md
+++ b/packages/design-tokens/README.md
@@ -13,3 +13,43 @@ yarn
 ```
 npm run build
 ```
+
+## Exported Tokens
+
+### Sass
+
+`_tokens.scss` contains exported token values as Sass variables.
+
+```sass
+@import "~@cockroachlabs/design-tokens/dist/web/tokens"
+
+.example {
+    background-color: $color-background-button-primary-success-base;
+    color: $color-font-button-primary-success-base;
+    border-width: 1px;
+    border-style: solid;
+    border-color: $color-border-button-primary-success-base;
+}
+```
+
+### JavaScript
+
+`tokens.js` contains exported token values as JavaScript constants.
+
+```jsx
+import {
+  ColorFont1,
+  ColorBaseBlue,
+  ColorBasePurple,
+} from "@cockroachlabs/design-tokens";
+
+// ...
+
+<SomeComponent
+  fontColor={ColorFont1}
+  interactionColor={ColorBaseBlue}
+  progressColor={ColorBasePurple}
+/>;
+```
+
+a `tokens.d.ts` file is also generated to act as types for tokens for TypeScript support.
diff --git a/packages/design-tokens/config.json b/packages/design-tokens/config.json
index 59e7d29ed..cc9553b4d 100644
--- a/packages/design-tokens/config.json
+++ b/packages/design-tokens/config.json
@@ -20,6 +20,16 @@
           "destination": "tokens.js"
         }
       ]
+    },
+    "ts": {
+      "transformGroup": "js",
+      "buildPath": "dist/web/",
+      "files": [
+        {
+          "format": "javascript/es6",
+          "destination": "tokens.d.ts"
+        }
+      ]
     }
   }
 }
diff --git a/packages/design-tokens/package.json b/packages/design-tokens/package.json
index b6d3bec10..51e82cb09 100644
--- a/packages/design-tokens/package.json
+++ b/packages/design-tokens/package.json
@@ -9,10 +9,11 @@
   "keywords": [
     "tokens"
   ],
-  "main": "build.js",
+  "main": "dist/web/tokens.js",
+  "types": "dist/web/tokens.d.ts",
   "scripts": {
-    "build": "node_modules/.bin/style-dictionary build",
-    "clean": "node_modules/.bin/style-dictionary clean",
+    "build": "style-dictionary build",
+    "clean": "style-dictionary clean",
     "test": "echo \"Error: no test specified\" && exit 1"
   },
   "license": "MIT",