Best Practices

Follow these proven patterns and conventions to build maintainable, scalable design token systems.

Naming Conventions

Use consistent, descriptive names throughout your system:

Semantic Over Literal

Name tokens by their purpose, not their appearance:

Organization

Keep related tokens together and maintain a clear hierarchy:

Documentation

Document your tokens with comments:

Type Inference

Let DTL infer types when possible, but be explicit when it adds clarity:

Reusability

Build tokens from other tokens to maintain consistency:

Related

• Design Systems
• Tokens Reference