Clarify configuration in CDN mode

[francislavoie]

Documentation Is:

Missing

Link to relevant page or pages

• https://twind.style/installation#twind-cdn

Please Explain in Detail...

I'm using twind like this:

<script src="https://cdn.twind.style" crossorigin></script>

I'm trying to figure out how to disable class hashing, cause I find it annoying during development to not be able to see the class names on my HTML. But when I try to use the following, all classes fail to apply:

twind.install({
	hash: false,
});

I assume the problem is the CDN mode automatically does an install call and has some defaults, so trying to install a second time breaks it, or uses the wrong defaults, not merging it with the built-in defaults.

Your Proposal for Changes

I'd like to see a section that shows how to apply certain config overrides without losing the "smart defaults".

Or maybe I misunderstand how to disable hashing, there's also a gap in the docs for hash, it's only listed in the API config that it takes a boolean type. I also saw the below for twind.run which suggests it should work to set it to false:

twind/sites/twind.run/src/twind.config.ts

Lines 113 to 114 in 82d72d8

	// For now no hashing - seems to break monaco
	hash: false,

Alternatives considered

No response