@unisphere/nx 2.0.0 → 2.1.0

package/README.md

@@ -1,167 +1,4 @@
-# Getting Started with Unisphere Project
+# Unisphere Workspace NX Plugin
 
-> This is a temporary documentation to the @unisphere/nx plugin until the official documentation is available.
 
-> ⚠️ **This generator is currently available only to Kaltura developers.**
-> It depends on internal resources such as CI/CD templates, design systems, and private NPM packages. External support for Kaltura customers is on our roadmap.
 
-Unisphere is Kaltura’s frontend framework for building dynamic, composable experiences. A **Unisphere project** is a structured repository that allows developers to create and organize **applications**, **runtimes**, and **packages** under a single cohesive experience. This setup encourages healthy module separation, runtime decoupling, reusability, and clean ownership boundaries — all key ingredients for scaling product development in a multi-team environment.
-
-Whether you're building a full application like _Content Lab_ or a lightweight widget like _Chat_, Unisphere gives you the tooling and conventions to do it the right way from the start.
-
-## Step 1 - Create a New Unisphere Project
-
-Before creating a new Unisphere project, make sure you have a valid `GITHUB_TOKEN` exported in your environment. This is required for GitHub operations during setup.
-
-To scaffold a new project you can use [create-unisphere-project](https://www.npmjs.com/package/create-unisphere-project) npm package with all necessary tooling and structure, run:
-
-```bash
-npm create unisphere-project@latest
-```
-
-### Set Up the GitHub Repository
-
-Once the project is generated locally, you’ll need to create a new GitHub repository so that CI/CD can operate correctly and your team has proper access.
-
-Please contact **Eran Sakal** or **Omri Ceisler** to provision the repository. The following steps will be completed as part of this process:
-
-1. **Repository Creation**
-   The new repo will be created with **internal scope** and named according to this convention:
-
-   ```
-   unisphere-{friendly-experience-name}
-   ```
-
-   The friendly name is derived from your declared experience name (e.g., `unisphere.widget.reactions` → `reactions` → `unisphere-reactions` as the repository name).
-
-2. **Team Access Configuration**
-   The appropriate GitHub teams will be granted access to the repository to match the experience's ownership and collaboration needs.
-
-3. **CI/CD Enablement**
-   These steps are required to ensure that CI/CD workflows are automatically triggered for builds, deployments, versioning, and testing.
-
-Once created, you can push your local project into the new repository and begin active development.
-
----
-
-## Step 2 - Use the `@unisphere/nx` Plugin
-
-After your project is set up, you’ll use the `@unisphere/nx` plugin to generate and manage your project’s core elements. All generators are interactive and designed to enforce Unisphere best practices and conventions.
-
-All generators support interactive usage through `nx g` and prompt you for the correct configuration.
-
-### 🧹 `add-runtime`
-
-Creates a new **runtime**, one of the possible entry points into an experience. Runtimes define **where** and **how** a specific part of the experience is used.
-
-For example, in the **Genie experience**, there's a runtime called **page** used when the host injects the experience into the main body of a site, and another called **player-plugin** for injecting it into a player drawer. We have additional runtimes, one for each tool that is used by the experience, e.g **flashcards-tool**, **source-tool**, **follow-up-tool** etc.
-
-Naming your runtime based on its integration point helps communicate its purpose and role clearly.
-
-```bash
-npx nx g @unisphere/nx:add-runtime
-```
-
-#### Prompts
-
-- **Runtime name** – e.g., `page`, `player-plugin`, `flashcards-tool`, `source-tool`, `follow-up-tool`, `content-lab-drawer`.
-
-- **How will this runtime be used?**
-
-  - **Loaded by External Host**u
-
-    - Deployed independently and loaded at runtime
-
-  - **Embedded in Widget Playground**
-    - Composed by other runtimes, no standalone deployment
-
-- **How will this runtime be used?**
-
-  - **Independent experience used as an entry point (loaded by host or another experience)**
-
-    - Includes an Dev playground application for developing and simulating a host environment
-
-  - **Composed into another runtime of this experience (not used as an entry point)**
-
-    - Composed by another runtime within the same experience
-
-    - Assume it is developed using a playground dev application of another runtime in the project
-
-### 🎨 `add-visual`
-
-Creates a **visual component** within a runtime — the building blocks of your UI.
-
-```bash
-npx nx g @unisphere/nx:add-visual
-```
-
-#### Prompts
-
-- **Runtime name** – Where this visual belongs
-- **Visual name** – e.g., `card`, `toolbar`, `timeline-visual`
-- **Is this visual limited to a single occurrence?**
-  Choose `Yes` for singleton visuals (e.g., when the visual represent a container that can only have one instance), otherwise `No`.
-
-### 📱 `add-application`
-
-Creates an **application** that acts as a host for your runtime(s). These apps can be used for development, standalone deployments, or iframe integrations. The application can be used as a playground for developing and simulating a host environment without the need to deploy the experience to a customer, or it can be an additional entry point for the experience and use the Unisphere ci/cd to be publically available in multi region environments.
-
-```bash
-npx nx g @unisphere/nx:add-application
-```
-
-#### Prompts
-
-- **Application name**
-
-- **Serving type**
-
-  - **Local Dev Playground** – Local development playground (for development and testing)
-  - **Self-Hosted** – Standalone deployment with routing/auth (used for publically available applications)
-  - **Iframe + Query Params** – Embedded apps with config in URL (used for embedding into other applications like Kaltura Admin or KMC)
-  - **Iframe + Post Messages** – Embedded apps using `postMessage` API (used for embedding into other applications like Kaltura Admin or KMC) - this will replace eventually the query param method to be more secure and reliable but is not yet available.
-
-- **Runtime to load in playground** (if Playground selected)
-
-- **HTML page title** (if not using Playground)
-
-### 📦 `add-package`
-
-Creates a shared **package** for separating concerns within an experience. Most of the actual code in a Unisphere project lives in packages — not in runtimes — making it easier to reuse components, services, and logic across multiple entry points. These packages are usually not distributed externally but serve as internal modules consumed by runtimes.
-
-By using packages this way, you can introduce multiple runtimes (e.g., page, player-plugin, admin-panel) that share the same functionality while remaining decoupled.
-
-Some packages, however, are designed for external consumption. For example:
-
-- Each experience has a `Core` package expose the types needed for runtime integration.
-- Differetn `kit` packages act as extendable, design-system-driven building blocks that allow other teams to plug into your experience in a consistent and styled way.
-
-Packages can be published to GitHub or npm, but in most cases, they serve as a clean internal abstraction layer inside the experience repository without being deployed.
-
-```bash
-npx nx g @unisphere/nx:add-package
-```
-
-#### Prompts
-
-- **Package name**
-- **Package scope**
-
-  - **None (no scope)** - Used only internally by the experience runtimes.
-  - **Internal** - Published to GitHub packages (`@kaltura/unisphere-<experience-name>-<package-name>`)
-  - **Public** - Published to npm (`@unisphere/<experience-name>-<package-name>`)
-
-## Best Practices
-
-🧠 Use descriptive names that reflect the purpose of the runtime or visual. For example, use `player-plugin` for a runtime that integrates into a video player, or `container` for visual that represent a container that can only have one instance, or `drawer` if it is a drawer runtime.
-
-🎯 Select the correct runtime type depending on the deployment context. Choose "Independent experience" if the runtime will be loaded by a host or standalone app, and "Composed into another runtime" if it will only exist as part of a larger experience.
-
-♻️ Share logic and components using packages. Most Unisphere code lives in packages rather than runtimes. This promotes reusability and modularity — for instance, content-lab-drawer and content-lab-modal runtimes may reuse the same internal package. Use the non scoped package if you are not sure what to choose.
-
-🔍 Use the interactive CLI mode to generate all project elements. This ensures naming consistency, correct scaffolding, and alignment with Unisphere conventions.
-
-## What’s Next?
-
-Stay tuned for full documentation on each concept and tool at
-**[unisphere.kaltura.com](https://unisphere.kaltura.com)** _(coming soon)_

package/dist/generators/add-application/add-application.js

@@ -113,7 +113,7 @@ async function addApplicationGenerator(tree, options) {
     (0, devkit_1.generateFiles)(tree, path.join(__dirname, templatePath), projectRoot, templateVariables);
     // Install selected dependencies
     (0, dependency_config_1.installSelectedDependencies)(tree, selectedDependencies);
-    const distributionChannel = options.servingType !== 'local-dev-playground' ? 'none' : 'unisphere';
+    const distributionChannel = options.servingType === 'local-dev-playground' ? 'none' : 'unisphere';
     // Update .unisphere configuration
     (0, utils_1.updateUnisphereConfig)(tree, 'applications', userInputApplicationName, {
         sourceRoot: `unisphere/applications/${userInputApplicationName}`,

package/dist/generators/add-application/templates/default/package.json.template

@@ -1,8 +1,5 @@
 {
   "name": "unisphere-application-<%= applicationName__lowerDashCase %>",
-  "version": "1.0.0",
-  "private": true,
-  "dependencies": {
-
-  }
+  "version": "1.0.0",  
+  "dependencies": {}
 }

package/dist/generators/add-application/templates/local-dev-playground/package.json

@@ -1,5 +1,6 @@
 {
   "name": "unisphere-application-<%= applicationName__lowerDashCase %>",
   "version": "1.0.0",
+  "private": true,
   "dependencies": {}
 }

package/dist/generators/add-package/add-package.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"add-package.d.ts","sourceRoot":"","sources":["../../../src/generators/add-package/add-package.ts"],"names":[],"mappings":"AAAA,OAAO,EAA8B,IAAI,EAA2B,MAAM,YAAY,CAAC;AAEvF,OAAO,EAAE,yBAAyB,EAAE,MAAM,UAAU,CAAC;AAyJrD,wBAAsB,mBAAmB,CACvC,IAAI,EAAE,IAAI,EACV,OAAO,EAAE,yBAAyB,uBAgInC;AAED,eAAe,mBAAmB,CAAC"}
+{"version":3,"file":"add-package.d.ts","sourceRoot":"","sources":["../../../src/generators/add-package/add-package.ts"],"names":[],"mappings":"AAAA,OAAO,EAA8B,IAAI,EAA2B,MAAM,YAAY,CAAC;AAEvF,OAAO,EAAE,yBAAyB,EAAE,MAAM,UAAU,CAAC;AA6DrD,wBAAsB,mBAAmB,CACvC,IAAI,EAAE,IAAI,EACV,OAAO,EAAE,yBAAyB,uBA8HnC;AAED,eAAe,mBAAmB,CAAC"}

package/dist/generators/add-package/add-package.js

@@ -36,88 +36,6 @@ function resolveUnisphereRuntimeVersion(tree) {
         return defaultVersion;
     }
 }
-function generateDemoComponent(tree, projectRoot, vars) {
-    // path: packages/<pkg>/src/lib/panel-demo.tsx
-    const targetPath = `${projectRoot}/src/lib/${vars['packageName__lowerDashCase']}-demo.tsx`;
-    // component and logger names
-    const loggerName = `${vars['packageName__lowerDashCase']}-demo`;
-    const demoName = `${vars['packageName__pascalCase']}Demo`;
-    let content;
-    if (demoName.includes('react')) {
-        content = `import { useContext, useEffect } from 'react';
-import {
-  ScopedUnisphereWorkspaceContext,
-  useGetScopedWorkspaceLogger,
-} from '@unisphere/runtime-react';
-
-const Hihi = () => {
-  return (
-    <div
-      style={{
-        border: '2px dashed #888',
-        borderRadius: '8px',
-        padding: '2rem',
-        margin: '2rem auto',
-        maxWidth: '500px',
-        textAlign: 'center',
-        fontFamily: 'sans-serif',
-        color: '#444',
-        backgroundColor: '#fcfcfc',
-      }}
-    >
-      <h2
-        style={{
-          marginBottom: '1rem',
-          fontSize: '1.25rem',
-          fontWeight: 500,
-        }}
-      >
-        Hihi :)
-      </h2>
-      <p
-        style={{
-          lineHeight: 1.5,
-          marginBottom: '1.5rem',
-          fontSize: '1rem',
-        }}
-      >
-        This '${demoName}' component shows you how to connect with the Unisphere workspace and set up a scoped logger.
-      </p>
-    </div>
-  );
-};
-
-export const ${demoName} = () => {
-  const { unisphereWorkspace } = useContext(ScopedUnisphereWorkspaceContext);
-  const logger = useGetScopedWorkspaceLogger({
-    type: 'react',
-    name: '${loggerName}',
-  });
-
-  useEffect(() => {
-    // example only - feel free to remove
-    logger?.log('${loggerName} mounted');
-    return () => {
-      logger?.log('${loggerName} unmounted');
-    };
-  }, []);
-
-  useEffect(() => {
-    if (!unisphereWorkspace) return;
-    
-    // you can access the unisphere workspace that renders the runtime this component is mounted in
-  }, [unisphereWorkspace]);
-
-  // render your visual
-  return <Hihi />;
-};
-`;
-    }
-    else {
-        content = `export const ${demoName} = {}`;
-    }
-    tree.write(targetPath, content);
-}
 async function addPackageGenerator(tree, options) {
     // Validate and read .unisphere configuration
     const unisphereConfig = (0, utils_1.validateUnisphereConfig)(tree);
@@ -194,7 +112,6 @@ async function addPackageGenerator(tree, options) {
     });
     // Update tsconfig.base.json with path mapping
     (0, utils_1.updateTsConfigPaths)(tree, packageJsonName, `unisphere/packages/${userInputPackageName}/src/index.ts`);
-    generateDemoComponent(tree, projectRoot, templateVariables);
     // Install selected dependencies
     (0, dependency_config_1.installSelectedDependencies)(tree, selectedDependencies);
     await (0, devkit_1.formatFiles)(tree);

package/dist/generators/add-package/templates/new-package/package.json.template

@@ -9,14 +9,5 @@
     "url": "<%= githubUrl %>"
   },
   "types": "./index.esm.d.ts",
-  "dependencies": {
-    "@unisphere/runtime": "<%= unisphereRuntimeVersion %>"
-  },
-  "publishConfig": {
-    <% if (distributionChannel === 'github') { %>
-    "registry": "https://npm.pkg.github.com"
-    <% } else if (distributionChannel === 'npm') { %>
-    "registry": "https://registry.npmjs.org"
-    <% } %>
-  }
+  "dependencies": {}
 }

package/dist/generators/add-package/templates/new-package/src/index.ts.template

@@ -1 +0,0 @@
-export * from './lib/<%= packageName__lowerDashCase %>-demo';

package/dist/generators/add-runtime/add-runtime.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"add-runtime.d.ts","sourceRoot":"","sources":["../../../src/generators/add-runtime/add-runtime.ts"],"names":[],"mappings":"AAAA,OAAO,EAA8B,IAAI,EAAiB,MAAM,YAAY,CAAC;AAE7E,OAAO,EAAE,yBAAyB,EAAE,MAAM,UAAU,CAAC;AA6CrD,wBAAsB,mBAAmB,CACvC,IAAI,EAAE,IAAI,EACV,OAAO,EAAE,yBAAyB,uBAwInC;AAED,eAAe,mBAAmB,CAAC"}
+{"version":3,"file":"add-runtime.d.ts","sourceRoot":"","sources":["../../../src/generators/add-runtime/add-runtime.ts"],"names":[],"mappings":"AAAA,OAAO,EAA8B,IAAI,EAAiB,MAAM,YAAY,CAAC;AAE7E,OAAO,EAAE,yBAAyB,EAAE,MAAM,UAAU,CAAC;AA4CrD,wBAAsB,mBAAmB,CACvC,IAAI,EAAE,IAAI,EACV,OAAO,EAAE,yBAAyB,uBAyHnC;AAED,eAAe,mBAAmB,CAAC"}

package/dist/generators/add-runtime/add-runtime.js

@@ -26,8 +26,8 @@ function updateTypesIndexExport(tree, runtimeName, basePath) {
     tree.write(indexPath, updatedContent);
 }
 async function addRuntimeGenerator(tree, options) {
-    // Normalize standalone option - Nx list prompts may return string labels instead of boolean values
-    let isStandalone = options?.standalone === 'yes' ? true : false;
+    // Normalize consumer option - Nx list prompts may return string labels instead of boolean values
+    let isExternal = options?.consumer === 'external' ? true : false;
     // Validate and read .unisphere configuration
     const unisphereConfig = (0, utils_1.validateUnisphereConfig)(tree);
     // Validate dependencies
@@ -38,7 +38,6 @@ async function addRuntimeGenerator(tree, options) {
     const widgetName = unisphereConfig.name;
     // Validate and correct runtime naming for React/DS dependencies
     let userInputRuntimeName = (0, devkit_1.names)(options.name).fileName;
-    userInputRuntimeName = (0, dependency_config_1.validateReactNaming)(userInputRuntimeName, selectedDependencies);
     // Find types package (or fallback to core)
     const typesPackageInfo = (0, utils_1.findTypesOrCorePackageInfo)(tree);
     // Prepare template variables
@@ -78,17 +77,8 @@ async function addRuntimeGenerator(tree, options) {
     const runtimePathKey = `unisphere-runtime-${userInputRuntimeName}`;
     const runtimePathValue = `unisphere/runtimes/${userInputRuntimeName}/src/index.ts`;
     (0, utils_1.updateTsConfigPaths)(tree, runtimePathKey, runtimePathValue);
-    // // Create a package with the same name as the runtime and distribution set to none
-    // const packageResult = await addPackageGenerator(tree, {
-    //   packageName: userInputRuntimeName,
-    //   scope: 'none',
-    // });
-    // // Execute the package generation callback if it exists
-    // if (packageResult && typeof packageResult === 'function') {
-    //   packageResult();
-    // }
-    // Handle standalone usage - create dev application
-    if (isStandalone === true) {
+    // Handle internal usage - create dev application
+    if (!!isExternal) {
         // Create a dev application without prompts
         const applicationResult = await (0, add_application_1.addApplicationGenerator)(tree, {
             name: `${userInputRuntimeName}-dev`,
@@ -111,8 +101,8 @@ async function addRuntimeGenerator(tree, options) {
         devkit_1.logger.info('');
         devkit_1.logger.info(`🚀 Runtime Name: ${userInputRuntimeName}`);
         devkit_1.logger.info(`📁 Location: ${projectRoot}`);
-        devkit_1.logger.info(`🔧 Standalone: ${isStandalone ? 'Yes' : 'No'}`);
-        if (isStandalone === true) {
+        devkit_1.logger.info(`🔧 Consumer: ${isExternal ? 'External' : 'Internal'}`);
+        if (isExternal === true) {
             devkit_1.logger.info('');
             devkit_1.logger.info('📦 Additional components created:');
             devkit_1.logger.info(`   • Dev Application: ${userInputRuntimeName}-dev`);

package/dist/generators/add-runtime/schema.d.ts

@@ -1,5 +1,5 @@
 export interface AddRuntimeGeneratorSchema {
   name: string;
-  standalone: string;
+  consumer: string;
   dependencies?: string[];
 }

package/dist/generators/add-runtime/schema.json

@@ -10,20 +10,20 @@
       "pattern": "^[a-zA-Z][a-zA-Z0-9\\-\\s]*$",
       "x-prompt": "What's the runtime name? (letters, numbers, dashes and spaces allowed)"
     },
-    "standalone": {
+    "consumer": {
       "type": "string",
-      "description": "Is this experience being loaded by the host application, or by another experience (not this one)?",
+      "description": "Is this runtime loaded from within the same experience or by an external consumer?",
       "x-prompt": {
-        "message": "Is this experience being loaded by the host application, or by another experience (not this one)?",
+        "message": "Is this runtime loaded from within the same experience or by an external consumer?",
         "type": "list",
         "items": [
           {
-            "value": "yes",
-            "label": "Yes -loaded by host application"
+            "value": "external",
+            "label": "Loaded by an external consumer"
           },
           {
-            "value": "no",
-            "label": "No - loaded by another experience"
+            "value": "internal",
+            "label": "Loaded by another runtime or application within this experience"
           }
         ]
       }
@@ -63,6 +63,6 @@
   },
   "required": [
     "name",
-    "standalone"
+    "consumer"
   ]
-}
+}

package/dist/migrations/1-22-0/check-nx-version.js

@@ -12,7 +12,7 @@ function checkNxVersion(tree) {
     }
     const majorVersion = parseInt(nxVersion.match(/\d+/)?.[0] ?? '0');
     if (majorVersion < 22) {
-        const errorMessage = `❌ This migration requires Nx 22 or higher. read https://unisphere.kaltura.com/docs/create/changelog/1-22-4-changelog`;
+        const errorMessage = `❌ This migration requires Nx 22 or higher. read https://unisphere.kaltura.com/docs/create/changelog/1-22-6-changelog`;
         devkit_1.logger.error(errorMessage);
         throw new Error(errorMessage);
     }

package/dist/migrations/1-22-0/patches/@nx+rollup+22.1.3.patch

@@ -0,0 +1,27 @@
+diff --git a/node_modules/@nx/rollup/src/plugins/with-nx/with-nx.js b/node_modules/@nx/rollup/src/plugins/with-nx/with-nx.js
+index 1135bba..4762053 100644
+--- a/node_modules/@nx/rollup/src/plugins/with-nx/with-nx.js
++++ b/node_modules/@nx/rollup/src/plugins/with-nx/with-nx.js
+@@ -149,7 +149,13 @@ dependencies) {
+         else {
+             options.generatePackageJson ??= true;
+         }
+-        const compilerOptions = createTsCompilerOptions(projectRoot, tsConfig, options, dependencies);
++        let compilerOptionsInterceptor = ((config) => config);
++        if (rollupConfig.unisphere?.interceptors?.compilerOptions) {
++            console.log(`[unisphere.nx.rollup] using monkey patched interceptor for TS compiler options`);
++            compilerOptionsInterceptor = rollupConfig.unisphere?.interceptors?.compilerOptions;
++        }
++
++        const compilerOptions = compilerOptionsInterceptor(createTsCompilerOptions(projectRoot, tsConfig, options, dependencies));
+         compilerOptions.outDir = Array.isArray(finalConfig.output)
+             ? finalConfig.output[0].dir
+             : finalConfig.output.dir;
+@@ -170,6 +176,7 @@ dependencies) {
+                     return require('rollup-plugin-typescript2')({
+                         check: !options.skipTypeCheck,
+                         tsconfig: tsConfigPath,
++                        exclude: ['**/*.stories.ts', '**/*.stories.tsx'],
+                         tsconfigOverride: {
+                             compilerOptions,
+                         },

package/dist/migrations/1-22-0/replace-patches.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"replace-patches.d.ts","sourceRoot":"","sources":["../../../src/migrations/1-22-0/replace-patches.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,IAAI,EAAyB,MAAM,YAAY,CAAC;AAKzD,wBAA8B,MAAM,CAAC,IAAI,EAAE,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAiC9D"}
+{"version":3,"file":"replace-patches.d.ts","sourceRoot":"","sources":["../../../src/migrations/1-22-0/replace-patches.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,IAAI,EAAmC,MAAM,YAAY,CAAC;AASnE,wBAA8B,MAAM,CAAC,IAAI,EAAE,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAwD9D"}

package/dist/migrations/1-22-0/replace-patches.js

@@ -3,10 +3,26 @@ Object.defineProperty(exports, "__esModule", { value: true });
 exports.default = update;
 const devkit_1 = require("@nx/devkit");
 const path_1 = require("path");
-const removePatchList = ['@changesets+cli'];
+const removePatchList = ['nx+rollup+', '@changesets+cli'];
+const forcePatchVersions = {
+    '@nx/rollup': '22.1.3',
+    '@changesets/cli': '2.29.7'
+};
 async function update(tree) {
     devkit_1.logger.info('🔄 Creating patches');
     try {
+        // Check @nx/rollup version
+        if (Object.keys(forcePatchVersions).length !== 0) {
+            devkit_1.logger.info('removing patches of older versions');
+            const pkg = (0, devkit_1.readJson)(tree, 'package.json');
+            Object.keys(forcePatchVersions).forEach(key => {
+                const version = pkg.devDependencies?.[key] || pkg.dependencies?.[key];
+                if (version !== forcePatchVersions[key]) {
+                    devkit_1.logger.error(`❌ ${key} version must be exactly ${forcePatchVersions[key]}`);
+                    throw new Error(`${key} version must be exactly ${forcePatchVersions[key]}. did you migrate nx to other version?`);
+                }
+            });
+        }
         // Create patches
         const patchesPath = 'patches';
         const patchesTemplatePath = (0, path_1.join)(__dirname, 'patches');
@@ -26,6 +42,11 @@ async function update(tree) {
         }
         // Copy all patch files using generateFiles
         (0, devkit_1.generateFiles)(tree, patchesTemplatePath, `./${patchesPath}`, {});
+        // Log created patches
+        const createdPatches = tree.children(patchesPath);
+        for (const patchFile of createdPatches) {
+            devkit_1.logger.info(`✅ Created patch: ${patchFile}`);
+        }
         // Always log that patches were created
         devkit_1.logger.info(`✅ All patches created successfully`);
     }

package/dist/migrations/1-22-2/add-os-and-cpu.js

@@ -9,7 +9,7 @@ async function update(tree) {
             json.os = [
                 "darwin",
                 "linux",
-                "windows"
+                "win32"
             ];
             json.cpu = [
                 "x64",

package/dist/migrations/1-22-2/templates/_publish-artifacts.template

@@ -12,7 +12,7 @@ jobs:
       has_applications: ${{ steps.check.outputs.has_applications }}
     steps:
       - name: Checkout Repo
-        uses: actions/checkout@v3
+        uses: actions/checkout@v4
         with:
           ref: ${{ github.event_name == 'pull_request' && github.head_ref || github.ref }}
           fetch-tags: true
@@ -58,7 +58,7 @@ jobs:
       commit_sha: ${{ steps.capture_commit_sha.outputs.commit_sha }}
     steps:
       - name: Checkout Repo
-        uses: actions/checkout@v3
+        uses: actions/checkout@v4
         with:
           ref: ${{ github.event_name == 'pull_request' && github.head_ref || github.ref }}
           fetch-tags: true
@@ -107,14 +107,14 @@ jobs:
     runs-on: codebuild-ovp-unisphere-runner-${{ github.run_id }}-${{ github.attempt }}
     steps:
       - name: Checkout Repo
-        uses: actions/checkout@v3
+        uses: actions/checkout@v4
         with:
           ref: ${{ github.event_name == 'pull_request' && github.head_ref || github.ref }}
           fetch-tags: true
       - name: Setup Node.js
         uses: actions/setup-node@v4
         with:
-          node-version: 20
+          node-version-file: '.nvmrc'
       
       - name: Setup JFrog        
         uses: jfrog/setup-jfrog-cli@v4
@@ -140,7 +140,7 @@ jobs:
           # Debug token existence (safely)
           echo "::debug::Token exists: $([ ! -z "$NPM_TOKEN" ] && echo 'true' || echo 'false')"
       - name: Deploy to registry
-        run: npx unisphere package publish --verbose --githubToken ${{ secrets.GITHUB_TOKEN }} --jfrogToken ${{ steps.setup-jfrog.outputs.oidc-token }} --npmToken ${{ env.NPM_TOKEN }} --branch "${{ github.event_name == 'pull_request' && github.head_ref || github.ref }}"
+        run: npx unisphere package publish --verbose --githubToken ${{ secrets.GITHUB_TOKEN }} --npmToken ${{ env.NPM_TOKEN }} --branch "${{ github.event_name == 'pull_request' && github.head_ref || github.ref }}"
 
   deploy-runtimes:
     if: needs.prepare-runtimes.outputs.hasArtifacts == 'true'
@@ -162,14 +162,14 @@ jobs:
       - name: Check available disk space
         run: df -h
       - name: Checkout Repo at specific commit
-        uses: actions/checkout@v3
+        uses: actions/checkout@v4
         with:
           ref: ${{ needs.prepare-runtimes.outputs.commit_sha }}
           fetch-tags: true
       - name: Setup Node.js
         uses: actions/setup-node@v4
         with:
-          node-version: 20
+          node-version-file: '.nvmrc'
       
       - name: Setup JFrog        
         uses: jfrog/setup-jfrog-cli@v4
@@ -212,7 +212,7 @@ jobs:
       commit_sha: ${{ steps.capture_commit_sha.outputs.commit_sha }}
     steps:
       - name: Checkout Repo
-        uses: actions/checkout@v3
+        uses: actions/checkout@v4
         with:
           ref: ${{ github.event_name == 'pull_request' && github.head_ref || github.ref }}
           fetch-tags: true
@@ -224,10 +224,18 @@ jobs:
         run: git reset --hard HEAD
       - name: Clean npm cache
         run: npm cache clean --force
+      - name: Setup JFrog        
+        uses: jfrog/setup-jfrog-cli@v4
+        id: setup-jfrog
+        env:
+          JF_URL: https://kalturaa.jfrog.io
+        with:
+          oidc-provider-name: ovp-github-oidc
       - name: Install dependencies
-        run: npm ci --ignore-scripts
+        run: npm ci --ignore-scripts          
         env:
           GIT_TOKEN: ${{ secrets.GITHUB_TOKEN }}
+          KALTURA_JFROG_TOKEN: ${{ steps.setup-jfrog.outputs.oidc-token }}
       - name: Prepare Unisphere Applications
         id: prepare-applications
         run: npx unisphere application publish prepare --verbose
@@ -263,18 +271,26 @@ jobs:
       fail-fast: false
     steps:
       - name: Checkout Repo at specific commit
-        uses: actions/checkout@v3
+        uses: actions/checkout@v4
         with:
           ref: ${{ needs.prepare-applications.outputs.commit_sha }}
           fetch-tags: true
       - name: Setup Node.js
         uses: actions/setup-node@v4
         with:
-          node-version: 20
+          node-version-file: '.nvmrc'
+      - name: Setup JFrog        
+        uses: jfrog/setup-jfrog-cli@v4
+        id: setup-jfrog
+        env:
+          JF_URL: https://kalturaa.jfrog.io
+        with:
+          oidc-provider-name: ovp-github-oidc
       - name: Install dependencies
-        run: npm ci --ignore-scripts
+        run: npm ci --ignore-scripts          
         env:
           GIT_TOKEN: ${{ secrets.GITHUB_TOKEN }}
+          KALTURA_JFROG_TOKEN: ${{ steps.setup-jfrog.outputs.oidc-token }}
       - name: Download artifacts folder
         uses: actions/download-artifact@v4
         with:

package/dist/migrations/{summaries/2-0-0-summary.d.ts → 1-22-4/summary.d.ts}

@@ -1,2 +1,2 @@
 export default function (): Promise<void>;
-//# sourceMappingURL=2-0-0-summary.d.ts.map
+//# sourceMappingURL=summary.d.ts.map

package/dist/migrations/1-22-4/summary.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"summary.d.ts","sourceRoot":"","sources":["../../../src/migrations/1-22-4/summary.ts"],"names":[],"mappings":"AAEA,0CAOC"}

package/dist/migrations/{summaries/1-22-4-summary.js → 1-22-4/summary.js}

@@ -7,6 +7,5 @@ async function default_1() {
     devkit_1.logger.info('🎉 Migration to @unisphere/nx 1.22.4 finished successfully!');
     devkit_1.logger.info('');
     devkit_1.logger.info('📋 Full details:');
-    devkit_1.logger.info('https://unisphere.kaltura.com/docs/create/changelog/1-22-4-changelog');
-    devkit_1.logger.info('');
+    devkit_1.logger.info('https://unisphere.kaltura.com/docs/create/changelog/1-22-6-changelog');
 }

package/dist/migrations/2-0-0/summary.d.ts

@@ -0,0 +1,2 @@
+export default function (): Promise<void>;
+//# sourceMappingURL=summary.d.ts.map

package/dist/migrations/2-0-0/summary.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"summary.d.ts","sourceRoot":"","sources":["../../../src/migrations/2-0-0/summary.ts"],"names":[],"mappings":"AAEA,0CAOC"}

package/dist/migrations/2-1-0/remove-react-overrides.d.ts

@@ -0,0 +1,3 @@
+import { Tree } from '@nx/devkit';
+export default function update(tree: Tree): Promise<void>;
+//# sourceMappingURL=remove-react-overrides.d.ts.map

package/dist/migrations/2-1-0/remove-react-overrides.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"remove-react-overrides.d.ts","sourceRoot":"","sources":["../../../src/migrations/2-1-0/remove-react-overrides.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,IAAI,EAAsB,MAAM,YAAY,CAAC;AAEtD,wBAA8B,MAAM,CAAC,IAAI,EAAE,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CA+D9D"}

package/dist/migrations/2-1-0/remove-react-overrides.js

@@ -0,0 +1,59 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.default = update;
+const devkit_1 = require("@nx/devkit");
+async function update(tree) {
+    devkit_1.logger.info('🔄 Removing React overrides from package.json...');
+    const packageJsonPath = 'package.json';
+    if (!tree.exists(packageJsonPath)) {
+        devkit_1.logger.warn('⚠️ package.json not found');
+        throw new Error('package.json not found');
+    }
+    try {
+        (0, devkit_1.updateJson)(tree, packageJsonPath, (packageJson) => {
+            let overridesRemoved = 0;
+            if (packageJson.overrides) {
+                // Find overrides that contain React-related dependencies
+                const overridesToRemove = Object.keys(packageJson.overrides).filter(key => {
+                    const override = packageJson.overrides[key];
+                    // Check if the override contains React-related dependencies
+                    if (typeof override === 'object' && override !== null) {
+                        return Object.entries(override).some(([dep, version]) => (dep === 'react' ||
+                            dep.startsWith('react-') ||
+                            dep.startsWith('@types/react')) && (typeof version === 'string' && (version.startsWith('18') || version.startsWith('^18'))));
+                    }
+                    // Check if the key itself is React-related
+                    return key === 'react' ||
+                        key.startsWith('react-') ||
+                        key.startsWith('@types/react');
+                });
+                // Remove the identified overrides
+                overridesToRemove.forEach(key => {
+                    delete packageJson.overrides[key];
+                    overridesRemoved++;
+                });
+                // If overrides object is now empty, remove it entirely
+                if (Object.keys(packageJson.overrides).length === 0) {
+                    delete packageJson.overrides;
+                    devkit_1.logger.info('📦 Removed empty overrides object');
+                }
+                if (overridesRemoved > 0) {
+                    devkit_1.logger.info(`📦 Removed ${overridesRemoved} React-related overrides from package.json`);
+                }
+                else {
+                    devkit_1.logger.info('ℹ️ No React-related overrides found to remove');
+                }
+            }
+            else {
+                devkit_1.logger.info('ℹ️ No overrides section found in package.json');
+            }
+            return packageJson;
+        });
+        devkit_1.logger.info('✅ Successfully processed React overrides removal');
+    }
+    catch (error) {
+        const errorMessage = error instanceof Error ? error.message : 'Unknown error';
+        devkit_1.logger.error(`❌ Could not update package.json: ${errorMessage}`);
+        throw new Error(`Could not update package.json: ${errorMessage}`);
+    }
+}

package/dist/migrations/2-1-0/remove-rollup-plugin-node-builtins.d.ts

@@ -0,0 +1,3 @@
+import { Tree } from '@nx/devkit';
+export default function update(tree: Tree): Promise<void>;
+//# sourceMappingURL=remove-rollup-plugin-node-builtins.d.ts.map

package/dist/migrations/2-1-0/remove-rollup-plugin-node-builtins.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"remove-rollup-plugin-node-builtins.d.ts","sourceRoot":"","sources":["../../../src/migrations/2-1-0/remove-rollup-plugin-node-builtins.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,IAAI,EAAsB,MAAM,YAAY,CAAC;AAEtD,wBAA8B,MAAM,CAAC,IAAI,EAAE,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAwD9D"}

package/dist/migrations/2-1-0/remove-rollup-plugin-node-builtins.js

@@ -0,0 +1,54 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.default = update;
+const devkit_1 = require("@nx/devkit");
+async function update(tree) {
+    devkit_1.logger.info('🔄 Removing rollup-plugin-node-builtins dependency...');
+    const packageJsonPath = 'package.json';
+    if (!tree.exists(packageJsonPath)) {
+        devkit_1.logger.warn('⚠️ package.json not found');
+        throw new Error('package.json not found');
+    }
+    try {
+        let dependencyRemoved = false;
+        (0, devkit_1.updateJson)(tree, packageJsonPath, (packageJson) => {
+            const targetDependency = 'rollup-plugin-node-builtins';
+            // Check and remove from dependencies
+            if (packageJson.dependencies && packageJson.dependencies[targetDependency]) {
+                delete packageJson.dependencies[targetDependency];
+                dependencyRemoved = true;
+                devkit_1.logger.info(`📦 Removed ${targetDependency} from dependencies`);
+            }
+            // Check and remove from devDependencies
+            if (packageJson.devDependencies && packageJson.devDependencies[targetDependency]) {
+                delete packageJson.devDependencies[targetDependency];
+                dependencyRemoved = true;
+                devkit_1.logger.info(`📦 Removed ${targetDependency} from devDependencies`);
+            }
+            // Check and remove from peerDependencies
+            if (packageJson.peerDependencies && packageJson.peerDependencies[targetDependency]) {
+                delete packageJson.peerDependencies[targetDependency];
+                dependencyRemoved = true;
+                devkit_1.logger.info(`📦 Removed ${targetDependency} from peerDependencies`);
+            }
+            // Check and remove from optionalDependencies
+            if (packageJson.optionalDependencies && packageJson.optionalDependencies[targetDependency]) {
+                delete packageJson.optionalDependencies[targetDependency];
+                dependencyRemoved = true;
+                devkit_1.logger.info(`📦 Removed ${targetDependency} from optionalDependencies`);
+            }
+            return packageJson;
+        });
+        if (dependencyRemoved) {
+            devkit_1.logger.info('✅ Successfully removed rollup-plugin-node-builtins dependency');
+        }
+        else {
+            devkit_1.logger.info('ℹ️ rollup-plugin-node-builtins dependency not found');
+        }
+    }
+    catch (error) {
+        const errorMessage = error instanceof Error ? error.message : 'Unknown error';
+        devkit_1.logger.error(`❌ Could not update package.json: ${errorMessage}`);
+        throw new Error(`Could not update package.json: ${errorMessage}`);
+    }
+}

package/dist/migrations/2-1-0/remove-storybook.d.ts

@@ -0,0 +1,3 @@
+import { Tree } from '@nx/devkit';
+export default function update(tree: Tree): Promise<void>;
+//# sourceMappingURL=remove-storybook.d.ts.map

package/dist/migrations/2-1-0/remove-storybook.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"remove-storybook.d.ts","sourceRoot":"","sources":["../../../src/migrations/2-1-0/remove-storybook.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,IAAI,EAAsB,MAAM,YAAY,CAAC;AAEtD,wBAA8B,MAAM,CAAC,IAAI,EAAE,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAsG9D"}

package/dist/migrations/2-1-0/remove-storybook.js

@@ -0,0 +1,88 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.default = update;
+const devkit_1 = require("@nx/devkit");
+async function update(tree) {
+    devkit_1.logger.info('🔄 Removing Storybook files and dependencies...');
+    let removedItems = 0;
+    // 1. Remove storybook folder if it exists
+    if (tree.exists('storybook')) {
+        tree.delete('storybook');
+        devkit_1.logger.info('📁 Removed storybook folder');
+        removedItems++;
+    }
+    // 2. Remove storybook dependencies from package.json
+    const packageJsonPath = 'package.json';
+    if (tree.exists(packageJsonPath)) {
+        try {
+            (0, devkit_1.updateJson)(tree, packageJsonPath, (packageJson) => {
+                let dependenciesRemoved = 0;
+                // Remove from dependencies
+                if (packageJson.dependencies) {
+                    const depsToRemove = Object.keys(packageJson.dependencies).filter(dep => dep === 'storybook' || dep.startsWith('@storybook/'));
+                    depsToRemove.forEach(dep => {
+                        delete packageJson.dependencies[dep];
+                        dependenciesRemoved++;
+                    });
+                }
+                // Remove from devDependencies
+                if (packageJson.devDependencies) {
+                    const devDepsToRemove = Object.keys(packageJson.devDependencies).filter(dep => dep === 'storybook' || dep.startsWith('@storybook/'));
+                    devDepsToRemove.forEach(dep => {
+                        delete packageJson.devDependencies[dep];
+                        dependenciesRemoved++;
+                    });
+                }
+                // Remove from peerDependencies
+                if (packageJson.peerDependencies) {
+                    const peerDepsToRemove = Object.keys(packageJson.peerDependencies).filter(dep => dep === 'storybook' || dep.startsWith('@storybook/'));
+                    peerDepsToRemove.forEach(dep => {
+                        delete packageJson.peerDependencies[dep];
+                        dependenciesRemoved++;
+                    });
+                }
+                if (dependenciesRemoved > 0) {
+                    devkit_1.logger.info(`📦 Removed ${dependenciesRemoved} Storybook dependencies from package.json`);
+                    removedItems++;
+                }
+                return packageJson;
+            });
+        }
+        catch (error) {
+            const errorMessage = error instanceof Error ? error.message : 'Unknown error';
+            devkit_1.logger.warn(`⚠️ Could not update package.json: ${errorMessage}`);
+            throw new Error(`⚠️ Could not update package.json: ${errorMessage}`);
+        }
+    }
+    // 3. Remove storybook paths from tsconfig.base.json
+    const tsconfigPath = 'tsconfig.base.json';
+    if (tree.exists(tsconfigPath)) {
+        try {
+            (0, devkit_1.updateJson)(tree, tsconfigPath, (tsconfig) => {
+                let pathsRemoved = 0;
+                if (tsconfig.compilerOptions?.paths) {
+                    const pathsToRemove = Object.entries(tsconfig.compilerOptions.paths).filter(([key, paths]) => paths.some(path => path.startsWith('storybook/'))).map(([key]) => key);
+                    pathsToRemove.forEach(key => {
+                        delete tsconfig.compilerOptions.paths[key];
+                        pathsRemoved++;
+                    });
+                    if (pathsRemoved > 0) {
+                        devkit_1.logger.info(`� Removed ${pathsRemoved} Storybook paths from tsconfig.base.json`);
+                        removedItems++;
+                    }
+                }
+                return tsconfig;
+            });
+        }
+        catch (error) {
+            const errorMessage = error instanceof Error ? error.message : 'Unknown error';
+            throw new Error(`⚠️ Could not update tsconfig.base.json: ${errorMessage}`);
+        }
+    }
+    if (removedItems === 0) {
+        devkit_1.logger.info('ℹ️ No Storybook files, dependencies, or paths found to remove');
+    }
+    else {
+        devkit_1.logger.info(`✅ Successfully removed Storybook components (${removedItems} operations completed)`);
+    }
+}

package/dist/migrations/2-1-0/replace-readme-md.d.ts

@@ -0,0 +1,3 @@
+import { Tree } from '@nx/devkit';
+export default function update(tree: Tree): Promise<void>;
+//# sourceMappingURL=replace-readme-md.d.ts.map

package/dist/migrations/2-1-0/replace-readme-md.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"replace-readme-md.d.ts","sourceRoot":"","sources":["../../../src/migrations/2-1-0/replace-readme-md.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,IAAI,EAAoB,MAAM,YAAY,CAAC;AAIpD,wBAA8B,MAAM,CAAC,IAAI,EAAE,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAiD9D"}

package/dist/migrations/2-1-0/replace-readme-md.js

@@ -0,0 +1,50 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.default = update;
+const devkit_1 = require("@nx/devkit");
+const fs_1 = require("fs");
+const path_1 = require("path");
+async function update(tree) {
+    devkit_1.logger.info('🔄 Replacing README.md from template...');
+    const readmePath = 'README.md';
+    const readmeTemplatePath = (0, path_1.join)(__dirname, 'templates', 'readme.md.template');
+    const unispherePath = '.unisphere';
+    // Read the template content
+    const readmeTemplateContent = (0, fs_1.readFileSync)(readmeTemplatePath, 'utf-8');
+    // Read and parse .unisphere file
+    let processedContent = readmeTemplateContent;
+    if (tree.exists(unispherePath)) {
+        try {
+            const unisphereContent = (0, devkit_1.readJson)(tree, unispherePath);
+            if (!unisphereContent) {
+                throw new Error('.unisphere file is empty');
+            }
+            const unisphereConfig = JSON.parse(unisphereContent);
+            // Replace placeholders with values from .unisphere
+            if (unisphereConfig.company) {
+                processedContent = processedContent.replace(/\{\{company-name\|human-readable\}\}/g, unisphereConfig.company);
+            }
+            if (unisphereConfig.name) {
+                processedContent = processedContent.replace(/\{\{project-name\|human-readable\}\}/g, unisphereConfig.name);
+            }
+            devkit_1.logger.info(` Replaced template placeholders with company: "${unisphereConfig.company}", name: "${unisphereConfig.name}"`);
+        }
+        catch (error) {
+            const errorMessage = error instanceof Error ? error.message : 'Unknown error';
+            devkit_1.logger.warn(` Could not parse .unisphere file: ${errorMessage}`);
+            devkit_1.logger.info(' Using template content without placeholder replacement');
+        }
+    }
+    else {
+        devkit_1.logger.warn(' .unisphere file not found');
+        devkit_1.logger.info(' Using template content without placeholder replacement');
+    }
+    const readmeExists = tree.exists(readmePath);
+    tree.write(readmePath, processedContent);
+    if (readmeExists) {
+        devkit_1.logger.info(`✅ Updated ${readmePath}`);
+    }
+    else {
+        devkit_1.logger.info(`✅ Created ${readmePath}`);
+    }
+}

package/dist/migrations/2-1-0/templates/readme.md.template

@@ -0,0 +1,134 @@
+# Unisphere - {{company-name|human-readable}} {{project-name|human-readable}}
+
+## Overview
+
+This repository is a **Unisphere workspace** for an experience named **{{project-name|human-readable}}**.
+
+It contains everything you need to:
+- Create and publish npm / JFrog packages  
+- Bundle and version runtime artifacts  
+- Build and deploy applications  
+- Develop locally and promote changes to production  
+
+The Unisphere workspace acts as the single entry point for the entire lifecycle — from local development, through CI/CD, and all the way to production deployment.
+
+To better understand the ideas behind Unisphere and how it works, read more at:  
+https://unisphere.kaltura.com/
+
+---
+
+## Prerequisites
+
+At the moment, **deploying Unisphere experiences is available only to Kaltura employees**.
+
+Before doing anything else, make sure your machine is properly configured to access:
+- Kaltura GitHub repositories  
+- Kaltura JFrog Artifactory registries  
+
+Follow the setup guide here:  
+https://unisphere.kaltura.com/docs/create/kaltura-employees/setup-machine
+
+---
+
+## Add the Experience to Kaltura Github Organization
+
+Before you can deploy or activate this experience, it must be registered in Github under Kaltura Organization.
+
+This step connects your Unisphere workspace to the relevant Kaltura infrastructure and enables CI/CD, deployment, and activation flows.
+
+Follow the guide here:  
+https://unisphere.kaltura.com/docs/create/devops/create-github-repository
+
+---
+
+## Create Artifacts
+
+Unisphere allows you to create and manage different types of artifacts, including:
+- Packages  
+- Runtimes  
+- Applications  
+
+Each artifact type has its own role in the ecosystem, but they all live and evolve together inside this workspace.
+
+Read more about creating artifacts here:  
+https://unisphere.kaltura.com/docs/create/overview
+
+---
+
+## Deploy
+
+To deploy **packages, applications, and runtimes**, follow the deployment guide:  
+https://unisphere.kaltura.com/docs/create/devops/deploy
+
+For **applications and runtimes**, deployment is only part of the process.  
+After deployment, they must also be activated to become available in production.
+
+Activation guide:  
+https://unisphere.kaltura.com/docs/create/devops/activate
+
+---
+
+## Local Development
+
+Unisphere provides a structured local development flow that mirrors production as closely as possible, while still keeping things fast and developer-friendly.
+
+This includes:
+- Local builds  
+- Watching and rebuilding artifacts  
+- Running applications in isolation or as part of a larger workspace  
+
+Read more about local development here:  
+https://unisphere.kaltura.com/docs/create/local-development
+
+---
+
+## Available Commands
+
+This workspace exposes a small set of opinionated commands to help you explore, validate, and manage the experience.
+
+### Start
+Lists all available commands for each artifact in the experience, including how to build and serve runtimes, and how to spawn applications.
+
+```bash
+npm run start
+```
+
+
+### Info
+Displays information about the current workspace, including detected artifacts, configuration, and environment details.
+
+```bash
+npm run info
+```
+
+### Check
+Validates the workspace setup and verifies that all required artifacts and configurations are in place.
+
+```bash
+npm run check
+```
+
+### Reset
+Resets the workspace to a clean state. Useful when experimenting or when local state becomes inconsistent.
+
+```bash
+npm run reset
+```
+
+
+---
+
+## Next Steps
+
+If this is your first time working with Unisphere, a great next step is to **create a runtime with a playground**.
+
+Follow the Hello World walkthrough here:
+[https://unisphere.kaltura.com/docs/create/overview](https://unisphere.kaltura.com/docs/create/overview)
+
+The walkthrough will guide you through:
+
+* Creating your first runtime
+* Running it locally with a playground
+* Understanding how runtimes, packages, and applications connect together
+
+This will give you a strong foundation for building and evolving the experience over time.

package/migrations.json

@@ -18,10 +18,10 @@
     },
     "1-22-0-replace-patches": {
       "version": "1.22.0",
-      "description": "Replaces patches with updated version for Nx 22.1.3",
+      "description": "Replaces patches with updated version for Nx 22.1.3 and changeset cli",
       "factory": "./dist/migrations/1-22-0/replace-patches.js",
       "cli": {
-        "postUpdateMessage": "✅ Patches have been replaced with updated version for Nx 22.1.3."
+        "postUpdateMessage": "✅ Patches have been replaced with updated version for Nx 22.1.3 and changeset cli."
       }
     },
     "1-22-1-sync-inner-package-json-dependencies": {
@@ -58,6 +58,11 @@
       "description": "Adds kaltura-tools to preinstall script",
       "factory": "./dist/migrations/1-22-4/add-kaltura-tools-to-pre-install.js"
     },
+    "1-22-4-summary": {
+      "version": "1.22.4",
+      "description": "Migration completion summary for 1.22.4",
+      "factory": "./dist/migrations/1-22-4/summary.js"
+    },
     "2-0-0-update-npmrc": {
       "version": "2.0.0",
       "description": "Updates .npmrc to remove legacy-peer-deps=true",
@@ -102,15 +107,42 @@
         "postUpdateMessage": "✅ Patches have been replaced"
       }
     },
-    "000-1-22-4-summary": {
-      "version": "1.22.4",
-      "description": "Migration completion summary for 1.22.4",
-      "factory": "./dist/migrations/summaries/1-22-4-summary.js"
-    },
-    "000-2-0-0-summary": {
+    "2-0-0-summary": {
       "version": "2.0.0",
       "description": "Migration completion summary for 2.0.0",
-      "factory": "./dist/migrations/summaries/2-0-0-summary.js"
+      "factory": "./dist/migrations/2-0-0/summary.js"
+    },
+    "2-1-0-replace-readme-md": {
+      "version": "2.1.0",
+      "description": "Replaces README.md from template",
+      "factory": "./dist/migrations/2-1-0/replace-readme-md.js",
+      "cli": {
+        "postUpdateMessage": "✅ README.md has been replaced"
+      }
+    },
+    "2-1-0-remove-storybook": {
+      "version": "2.1.0",
+      "description": "Removes storybook files and dependencies",
+      "factory": "./dist/migrations/2-1-0/remove-storybook.js",
+      "cli": {
+        "postUpdateMessage": "✅ Storybook files and dependencies have been removed"
+      }
+    },
+    "2-1-0-remove-react-overrides": {
+      "version": "2.1.0",
+      "description": "Removes React overrides from package.json",
+      "factory": "./dist/migrations/2-1-0/remove-react-overrides.js",
+      "cli": {
+        "postUpdateMessage": "✅ React overrides have been removed"
+      }
+    },
+    "2-1-0-remove-rollup-plugin-node-builtins": {
+      "version": "2.1.0",
+      "description": "Removes rollup-plugin-node-builtins dependency",
+      "factory": "./dist/migrations/2-1-0/remove-rollup-plugin-node-builtins.js",
+      "cli": {
+        "postUpdateMessage": "✅ rollup-plugin-node-builtins dependency has been removed"
+      }
     }
   },
   "packageJsonUpdates": {
@@ -162,6 +194,14 @@
           "version": "^7.3.4",
           "alwaysAddToPackageJson": false
         },
+        "@mui/x-date-pickers": {
+          "version": "8.11.3",
+          "alwaysAddToPackageJson": false
+        },
+        "@mui/x-tree-view": {
+          "version": "7.29.1",
+          "alwaysAddToPackageJson": false
+        },
         "@mui/icons-material": {
           "version": "^7.3.4",
           "alwaysAddToPackageJson": false
@@ -191,7 +231,11 @@
           "alwaysAddToPackageJson": false
         },
         "@types/node": {
-          "@types/node": "24.3.2",
+          "version": "24.3.2",
+          "alwaysAddToPackageJson": false
+        },
+        "@unisphere/runtime-react": {
+          "version": "^1.80.1",
           "alwaysAddToPackageJson": false
         },
         "@types/react": {
@@ -213,6 +257,10 @@
         "@emotion/styled": {
           "version": "11.14.1",
           "alwaysAddToPackageJson": false
+        },
+        "@vitejs/plugin-react": {
+          "version": "^4.7.0",
+          "alwaysAddToPackageJson": false
         }
       }
     }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@unisphere/nx",
-  "version": "2.0.0",
+  "version": "2.1.0",
   "private": false,
   "main": "./dist/index.js",
   "module": "./dist/index.js",

package/dist/migrations/summaries/1-22-4-summary.d.ts

@@ -1,2 +0,0 @@
-export default function (): Promise<void>;
-//# sourceMappingURL=1-22-4-summary.d.ts.map

package/dist/migrations/summaries/1-22-4-summary.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"1-22-4-summary.d.ts","sourceRoot":"","sources":["../../../src/migrations/summaries/1-22-4-summary.ts"],"names":[],"mappings":"AAEA,0CAOC"}

package/dist/migrations/summaries/2-0-0-summary.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"2-0-0-summary.d.ts","sourceRoot":"","sources":["../../../src/migrations/summaries/2-0-0-summary.ts"],"names":[],"mappings":"AAEA,0CAOC"}