Skip to content

Conversation

Abdullah85MBA
Copy link

Summary

I was trying to understand how tailwindcss works under the hood so I created a diagram for it using code-canvas.com. I think it will be pretty helpful for contributors to quickly onboard to the inner-works of tailwindcss.

Here is the generated diagram for tailwindcss grouped by the application's use-cases and their runtime data flows: Open interactive diagram ->

image

Test plan

@Abdullah85MBA Abdullah85MBA requested a review from a team as a code owner October 4, 2025 22:00
@Abdullah85MBA Abdullah85MBA changed the title Codecanvas diagram 1759601047358 tailwindcss diagram Oct 4, 2025
@Abdullah85MBA Abdullah85MBA changed the title tailwindcss diagram Add interactive diagram for tailwindcss Oct 4, 2025
@Eveeifyeve
Copy link

why not https://mermaid.js.org ?

@RobinMalfait
Copy link
Member

Hey! I appreciate the PR but I don't think we need something like this. The service you linked to took minutes to generate something and I wonder if this actually useful to anyone trying to contribute, not just cool looking. This is what it generated after a few minutes:
image

It also included words like JIT, which is a term we don't use in this codebase anymore. So I think it's going to be more confusing and I think it's also going to be much more clear if you look at the actual code in your editor and jump to definitions and follow function calls instead.

If we ever need some visual on how everything works, I think we'd just generate an SVG or use mermaid directly in the README or CONTRIBUTING markdown files.

Going to close this PR for now.

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
None yet
Projects
None yet
Development

Successfully merging this pull request may close these issues.

3 participants