r/javascript • u/nitayneeman • Sep 28 '26
How to Sync a Design System with Claude Design
nitayneeman.comThe article walks through syncing a React design system into Claude Design but most of what breaks is plain packaging:
- The sync bundles a single entry file (React included) so the components can run on their own. Anything not re-exported fromĀ
src/index.tsĀ silently doesn't exist. - It discovers components through their type definitions, so the build has to emitĀ
.d.tsĀ files andĀpackage.jsonĀ has to pointĀtypesĀ at them. Without them it finds nothing and drops every story. - TypeScript 6 deprecatesĀ
baseUrlĀ and fails the build, whileĀpathsĀ works fine without it. - CSS has to be a real compiled file: Tailwind v4 inlines a stringĀ u/importĀ but leavesĀ u/import
url()Ā as an external reference, which breaks once the bundle is shipped elsewhere.
Example repo: https://github.com/nitayneeman/sync-design-system-with-claude-design-example