@gostudent/shared-ui-library 1.10.0 → 1.11.0

package/README.md

@@ -129,21 +129,40 @@ npm run build           # Build tokens + TypeScript + Vite
 npm run build-storybook # Build Storybook static site
 ```
 
-### Local development against web-app
+### Local development against a consuming app
 
-To develop the library locally and test changes in the web-app without publishing:
+There are two ways to use the library locally without publishing.
 
-```bash
-npm run dev:copy
+#### Option 1 — `file:` dependency (recommended for Vite/React apps)
+
+In the consuming app's `package.json`:
+
+```json
+"@gostudent/shared-ui-library": "file:../shared-ui-library"
 ```
 
-This watches for changes, builds on each change, and copies the output directly into the web-app's `node_modules`:
+Then install and build:
+
+```bash
+# in shared-ui-library
+npm run build        # or: npm run build -- --watch for continuous rebuild
 
+# in consuming app
+npm install          # links node_modules entry to the source directory
 ```
-../web-app/legacy/node_modules/@gostudent/shared-ui-library
+
+With `--watch`, every rebuild is immediately visible in the consuming app without any extra copy step.
+
+#### Option 2 — `dev:copy` watch scripts (for webpack/legacy apps)
+
+```bash
+npm run dev:copy               # copies to ../web-app/legacy/node_modules/...
+npm run dev:copy:student-app   # copies to ../student-app/node_modules/...
 ```
 
-Minification is automatically disabled when `COPY_TO` is set (faster rebuilds, readable output for debugging).
+This watches for changes, builds on each change, and copies the output directly into the consuming app's `node_modules`. Minification is automatically disabled (faster rebuilds, readable output).
+
+> **Note:** `dev:copy` skips automatically if the destination resolves to the source directory (e.g. when a `file:` dependency is already in place) and logs a message instead of crashing.
 
 **Web-app requirements:**
 

package/dist/.storybook/preview.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"preview.d.ts","sourceRoot":"","sources":["../../.storybook/preview.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,kBAAkB,CAAC;AAChD,OAAO,4BAA4B,CAAC;AACpC,OAAO,4BAA4B,CAAC;AAEpC,QAAA,MAAM,OAAO,EAAE,OAyCd,CAAC;AAEF,eAAe,OAAO,CAAC"}
+{"version":3,"file":"preview.d.ts","sourceRoot":"","sources":["../../.storybook/preview.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,kBAAkB,CAAC;AAChD,OAAO,4BAA4B,CAAC;AACpC,OAAO,4BAA4B,CAAC;AAEpC,QAAA,MAAM,OAAO,EAAE,OA2Cd,CAAC;AAEF,eAAe,OAAO,CAAC"}