# Token Lens

> Token Lens is a design system audit tool that compares your CSS against your design token definitions to find hardcoded values, unused tokens and inconsistencies. It returns a Lighthouse-style score from 0 to 100 with per-category breakdowns and actionable recommendations.

Every page listed below is also published as Markdown at the same URL with a `.md` suffix.
The HTML URL returns Markdown too when the request sends `Accept: text/markdown`, or when the
`?format=md` query parameter is present.

## Product

- [Token Lens — Analyze design token usage in your CSS](https://tokenlens.app/index.md): Homepage: what Token Lens does, the three reasons to use it, and how to start an analysis or open the demo report.
- [New Analysis — Token Lens](https://tokenlens.app/start.md): Upload design token definitions and CSS, then run a design token analysis in the browser.
- [How Token Lens analyzes your design tokens](https://tokenlens.app/how-it-works.md): Supported token formats, the three analysis steps, how the score is calculated, the 9 categories, issue severities and FAQ.

## Updates

- [Changelog — Token Lens](https://tokenlens.app/changelog.md): Release notes for every published version of Token Lens.

## Legal

- [Privacy Policy — Token Lens](https://tokenlens.app/privacy.md): What data Token Lens collects, how it is stored and which rights you have over it.
- [Terms of Service — Token Lens](https://tokenlens.app/terms.md): The terms you agree to when using Token Lens.

## Optional

- [Full site content as a single file](https://tokenlens.app/llms-full.txt): every page above concatenated.
- [Sitemap](https://tokenlens.app/sitemap.xml): canonical HTML URLs.
- [Source repository](https://github.com/zetareticoli/tokenlens): the application source code.
- [Issue tracker](https://github.com/zetareticoli/tokenlens/issues): bug reports and feature requests.

## Notes

These routes are part of the application rather than its public content, so they have no
Markdown version and should not be crawled:

- `/report/:reportId`: Report generated by an analysis. Content is user specific and stored locally, so it has no markdown twin and is not indexable.
- `/reports`: List of saved reports. Requires authentication.
- `/demo/embed`: Demo report rendered without site chrome, embedded in an iframe on the homepage.
- `/signin, /signup, /forgot, /reset, /profile`: Account screens. Requires authentication and has no public content.

Contact: support@tokenlens.app