Preparing a design-system package for publication
While the library only lives in a monorepo via the workspace protocol, distribution bugs stay hidden. As soon as npm publish appears, holes show up: no exports, src/ shipped instead of dist/, consumers miss CSS, TypeScript cannot find types.
This lesson is the “safe to publish” checklist.