Migration Guide

Learn how to migrate from other token formats or upgrade from older versions of DTL.

From JSON Tokens

If you're using JSON-based tokens, you can migrate to DTL for better type safety and tooling support.

From Style Dictionary

Style Dictionary uses a similar structure, making migration straightforward.

Upgrading DTL Versions

DTL v2.0 introduced several improvements while maintaining backward compatibility.

Type Inference

Shorthand Syntax

Theme Syntax

Best Practices

• Migrate incrementally: Don't try to migrate everything at once
• Test thoroughly: Verify output matches your expectations
• Use the CLI: Validate your migrated tokens
• Update tooling: Ensure your build process works with DTL

Related

• Syntax Reference
• Best Practices