feat: add shadcn component registry build system

.github/workflows/deploy-storybook.yml

@@ -1,4 +1,4 @@
-name: Deploy Storybook to Pages
+name: Deploy Storybook and Registry to Pages
 
 on:
     push:
@@ -50,6 +50,12 @@ jobs:
             - name: Build storybook
               run: npm run build:storybook
 
+            - name: Build registry
+              run: npm run build:registry
+
+            - name: Copy registry into storybook output
+              run: cp -r public/r docs/r
+
             - name: Setup Pages
               uses: actions/configure-pages@v3
 

.github/workflows/pull_request.yml

@@ -44,3 +44,5 @@ jobs:
             - run: npm run type-check
             - run: npm test
             - run: npm run build
+            - run: npm run build:registry
+            - run: npm run test:registry

.gitignore

@@ -11,3 +11,6 @@ lib/
 coverage/
 .vscode/
 stats.html
+public/
+registry/
+registry.json

README.md

@@ -38,6 +38,36 @@ If you prefer to include static files grab the [minified build from the dist fol
 <link rel="stylesheet" type="text/css" href="./node_modules/@doist/reactist/styles/reactist.css" />
 ```
 
+# Registry (shadcn/ui) — experimental
+
+> **Note:** The shadcn registry is experimental and may change without notice.
+
+Reactist is also available as a [shadcn/ui registry](https://ui.shadcn.com/docs/registry), distributing component source files (TypeScript + CSS Modules) directly into your project.
+
+```sh
+npx shadcn add https://doist.github.io/reactist/r
+```
+
+## Setup
+
+Your bundler must support CSS Modules (Vite, Next.js, and webpack do by default). Add a path alias so registry imports resolve correctly:
+
+```json
+{
+    "compilerOptions": {
+        "paths": {
+            "@reactist/*": ["./src/components/reactist/*"]
+        }
+    }
+}
+```
+
+## Mixing npm and registry
+
+Do not import the same component from both `@doist/reactist` (npm) and the registry. Each source applies its own CSS Module scoping, so duplicate components will have conflicting styles.
+
+Different components from different sources (e.g., Button from npm, Box from registry) work fine — CSS Modules scope independently. Migrate one component at a time.
+
 # Changelog
 
 You can find our changelog [here](./CHANGELOG.md).