@akanjs/cli 2.1.0-rc.8 → 2.1.0

package/index.js

@@ -484,7 +484,18 @@ var DEFAULT_OPTIMIZE_IMPORTS = [
 var WORKSPACE_BARREL_FACETS = ["ui", "webkit", "common", "client", "server"];
 var SSR_RUNTIME_PACKAGES = ["react", "react-dom", "react-server-dom-webpack"];
 var NATIVE_RUNTIME_PACKAGES = ["sharp"];
-var AKAN_RUNTIME_PACKAGES = new Set([...SSR_RUNTIME_PACKAGES, ...NATIVE_RUNTIME_PACKAGES]);
+var DEFAULT_BACKEND_RUNTIME_PACKAGES = ["croner"];
+var DATABASE_MODE_RUNTIME_PACKAGES = {
+  single: [],
+  multiple: ["@libsql/client", "bullmq", "ioredis", "protobufjs"],
+  cluster: ["bullmq", "ioredis", "postgres", "protobufjs"]
+};
+var AKAN_RUNTIME_PACKAGES = new Set([
+  ...SSR_RUNTIME_PACKAGES,
+  ...NATIVE_RUNTIME_PACKAGES,
+  ...DEFAULT_BACKEND_RUNTIME_PACKAGES,
+  ...Object.values(DATABASE_MODE_RUNTIME_PACKAGES).flat()
+]);
 var DEFAULT_AKAN_IMAGE_CONFIG = {
   deviceSizes: [640, 750, 828, 1080, 1200, 1920, 2048, 3840],
   imageSizes: [32, 48, 64, 96, 128, 256, 384],
@@ -693,13 +704,22 @@ CMD [${command.map((c) => `"${c}"`).join(",")}]`;
     if (AKAN_RUNTIME_PACKAGES.has(lib))
       return akanPackageJson.dependencies?.[lib] ?? akanPackageJson.peerDependencies?.[lib];
   }
+  #getProductionRuntimePackages() {
+    return [
+      ...this.externalLibs,
+      ...SSR_RUNTIME_PACKAGES,
+      ...NATIVE_RUNTIME_PACKAGES,
+      ...DEFAULT_BACKEND_RUNTIME_PACKAGES,
+      ...DATABASE_MODE_RUNTIME_PACKAGES[this.defaultDatabaseMode]
+    ];
+  }
   getProductionPackageJson(data = {}) {
     return {
       name: this.app.name,
       description: this.app.name,
       version: "1.0.0",
       main: "./main.js",
-      dependencies: Object.fromEntries([...new Set([...this.externalLibs, ...SSR_RUNTIME_PACKAGES, ...NATIVE_RUNTIME_PACKAGES])].map((lib) => {
+      dependencies: Object.fromEntries([...new Set(this.#getProductionRuntimePackages())].map((lib) => {
         const version = this.#resolveProductionDependencyVersion(lib);
         if (!version)
           throw new Error(`Dependency ${lib} not found in package.json`);
@@ -7166,9 +7186,19 @@ var SSR_RENDER_EXTERNALS = [
   "react/jsx-dev-runtime",
   "react-dom",
   "react-dom/server.browser",
+  "react-server-dom-webpack",
+  "react-server-dom-webpack/server.node",
   "react-server-dom-webpack/client.node",
   "react-server-dom-webpack/client.browser"
 ];
+var AKAN_OPTIONAL_BACKEND_EXTERNALS = [
+  "@libsql/client",
+  "bullmq",
+  "croner",
+  "ioredis",
+  "postgres",
+  "protobufjs"
+];
 
 class ApplicationBuildRunner {
   #app;
@@ -7237,7 +7267,9 @@ class ApplicationBuildRunner {
   }
   async#buildBackend() {
     const akanConfig2 = await this.#app.getConfig();
-    const backendExternals = [...new Set([...akanConfig2.externalLibs, ...SSR_RENDER_EXTERNALS])];
+    const backendExternals = [
+      ...new Set([...akanConfig2.externalLibs, ...SSR_RENDER_EXTERNALS, ...AKAN_OPTIONAL_BACKEND_EXTERNALS])
+    ];
     const backendEntryPoints = [`${this.#app.cwdPath}/main.ts`, `${this.#app.cwdPath}/server.ts`];
     for (const entrypoint of backendEntryPoints) {
       if (!await Bun.file(entrypoint).exists())
@@ -7259,7 +7291,7 @@ class ApplicationBuildRunner {
       naming: { entry: "[name].[ext]", chunk: "chunk-[hash].[ext]" },
       conditions: ["react-server"],
       define: { "process.env.NODE_ENV": JSON.stringify("production") },
-      plugins: akanConfig2.externalLibs.length > 0 ? [this.#createExternalSpecifiersPlugin(akanConfig2.externalLibs)] : []
+      plugins: backendExternals.length > 0 ? [this.#createExternalSpecifiersPlugin(backendExternals)] : []
     });
     return {
       entrypoints: backendEntryPoints.length + 1,
@@ -7607,10 +7639,31 @@ class ApplicationReleasePackager {
   `;
   }
 }
+// pkgs/@akanjs/devkit/applicationTestPreload.ts
+import path33 from "path";
+var SIGNAL_TEST_PRELOAD_PATH = "test/signalTest.preload.ts";
+async function resolveSignalTestPreloadPath(target) {
+  const candidates = [];
+  const addResolvedPackageCandidate = (basePath2) => {
+    try {
+      candidates.push(path33.join(path33.dirname(Bun.resolveSync("akanjs/package.json", basePath2)), SIGNAL_TEST_PRELOAD_PATH));
+    } catch {}
+  };
+  addResolvedPackageCandidate(target.cwdPath);
+  addResolvedPackageCandidate(process.cwd());
+  addResolvedPackageCandidate(path33.dirname(Bun.main));
+  addResolvedPackageCandidate(import.meta.dir);
+  candidates.push(path33.join(target.cwdPath, "../../node_modules/akanjs", SIGNAL_TEST_PRELOAD_PATH), path33.join(target.cwdPath, "../../pkgs/akanjs", SIGNAL_TEST_PRELOAD_PATH), path33.join(process.cwd(), "node_modules/akanjs", SIGNAL_TEST_PRELOAD_PATH), path33.join(process.cwd(), "pkgs/akanjs", SIGNAL_TEST_PRELOAD_PATH), path33.join(path33.dirname(Bun.main), "../../akanjs", SIGNAL_TEST_PRELOAD_PATH), path33.resolve(import.meta.dir, "../../akanjs", SIGNAL_TEST_PRELOAD_PATH));
+  for (const candidate of [...new Set(candidates)]) {
+    if (await Bun.file(candidate).exists())
+      return candidate;
+  }
+  throw new Error(`Failed to locate ${SIGNAL_TEST_PRELOAD_PATH} from ${target.cwdPath}`);
+}
 // pkgs/@akanjs/devkit/builder.ts
 import { existsSync as existsSync2 } from "fs";
 import { mkdir as mkdir9 } from "fs/promises";
-import path33 from "path";
+import path34 from "path";
 var SKIP_ENTRY_DIR_SET = new Set(["node_modules", "dist", "build", ".git", ".next"]);
 var assetExtensions = [".css", ".md", ".js", ".png", ".ico", ".svg", ".json", ".template"];
 var assetLoader = Object.fromEntries(assetExtensions.map((ext) => [ext, "file"]));
@@ -7627,14 +7680,14 @@ class Builder {
   #globEntrypoints(cwd, pattern) {
     const glob = new Bun.Glob(pattern);
     return Array.from(glob.scanSync({ cwd, onlyFiles: true })).filter((relativePath) => {
-      const segments = relativePath.split(path33.sep);
+      const segments = relativePath.split(path34.sep);
       return !segments.some((segment) => SKIP_ENTRY_DIR_SET.has(segment));
-    }).map((rel) => path33.join(cwd, rel));
+    }).map((rel) => path34.join(cwd, rel));
   }
   #globFiles(cwd, pattern = "**/*.*") {
     const glob = new Bun.Glob(pattern);
     return Array.from(glob.scanSync({ cwd, onlyFiles: true })).filter((relativePath) => {
-      const segments = relativePath.split(path33.sep);
+      const segments = relativePath.split(path34.sep);
       return !segments.some((segment) => SKIP_ENTRY_DIR_SET.has(segment));
     });
   }
@@ -7642,17 +7695,17 @@ class Builder {
     const out = [];
     for (const p of additionalEntryPoints) {
       if (p.includes("*")) {
-        const rel = p.startsWith(`${cwd}/`) || p.startsWith(`${cwd}${path33.sep}`) ? p.slice(cwd.length + 1) : p;
+        const rel = p.startsWith(`${cwd}/`) || p.startsWith(`${cwd}${path34.sep}`) ? p.slice(cwd.length + 1) : p;
         out.push(...this.#globEntrypoints(cwd, rel));
       } else
-        out.push(path33.isAbsolute(p) ? p : path33.join(cwd, p));
+        out.push(path34.isAbsolute(p) ? p : path34.join(cwd, p));
     }
     return out;
   }
   #getBuildOptions({ bundle = false, additionalEntryPoints = [] } = {}) {
     const cwd = this.#executor.cwdPath;
     const entrypoints = [
-      ...bundle ? [path33.join(cwd, "index.ts")] : this.#globEntrypoints(cwd, "**/*.{ts,tsx}"),
+      ...bundle ? [path34.join(cwd, "index.ts")] : this.#globEntrypoints(cwd, "**/*.{ts,tsx}"),
       ...this.#resolveAdditionalEntrypoints(cwd, additionalEntryPoints)
     ];
     return {
@@ -7673,9 +7726,9 @@ class Builder {
     for (const relativePath of this.#globFiles(cwd)) {
       if (relativePath === "package.json")
         continue;
-      const sourcePath = path33.join(cwd, relativePath);
-      const targetPath = path33.join(this.#distExecutor.cwdPath, relativePath);
-      await mkdir9(path33.dirname(targetPath), { recursive: true });
+      const sourcePath = path34.join(cwd, relativePath);
+      const targetPath = path34.join(this.#distExecutor.cwdPath, relativePath);
+      await mkdir9(path34.dirname(targetPath), { recursive: true });
       await Bun.write(targetPath, Bun.file(sourcePath));
     }
   }
@@ -7686,13 +7739,13 @@ class Builder {
       return withoutFormatDir;
     if (!hasDotSlash && withoutFormatDir === publishedPath)
       return publishedPath;
-    const parsed = path33.posix.parse(withoutFormatDir);
+    const parsed = path34.posix.parse(withoutFormatDir);
     if (![".js", ".mjs", ".cjs"].includes(parsed.ext))
       return withoutFormatDir;
-    const withoutExt = path33.posix.join(parsed.dir, parsed.name);
+    const withoutExt = path34.posix.join(parsed.dir, parsed.name);
     const sourcePath = withoutExt.startsWith("./") ? withoutExt.slice(2) : withoutExt;
     const sourceCandidates = [`${sourcePath}.ts`, `${sourcePath}.tsx`];
-    const matchedSource = sourceCandidates.find((candidate) => existsSync2(path33.join(this.#executor.cwdPath, candidate)));
+    const matchedSource = sourceCandidates.find((candidate) => existsSync2(path34.join(this.#executor.cwdPath, candidate)));
     if (!matchedSource)
       return withoutFormatDir;
     return hasDotSlash ? `./${matchedSource}` : matchedSource;
@@ -7742,7 +7795,7 @@ class Builder {
 }
 // pkgs/@akanjs/devkit/capacitorApp.ts
 import { cp as cp2, mkdir as mkdir10, rm as rm4 } from "fs/promises";
-import path34 from "path";
+import path35 from "path";
 import { MobileProject } from "@trapezedev/project";
 import { capitalize as capitalize2 } from "akanjs/common";
 
@@ -7936,10 +7989,10 @@ class CapacitorApp {
   constructor(app, target) {
     this.app = app;
     this.target = target;
-    this.targetRootPath = path34.posix.join("mobile", this.target.name);
-    this.targetRoot = path34.join(this.app.cwdPath, this.targetRootPath);
-    this.targetWebRoot = path34.join(this.targetRoot, "www");
-    this.targetAssetRoot = path34.join(this.targetRoot, "assets");
+    this.targetRootPath = path35.posix.join("mobile", this.target.name);
+    this.targetRoot = path35.join(this.app.cwdPath, this.targetRootPath);
+    this.targetWebRoot = path35.join(this.targetRoot, "www");
+    this.targetAssetRoot = path35.join(this.targetRoot, "assets");
     this.project = new MobileProject(this.app.cwdPath, {
       android: { path: this.androidRootPath },
       ios: { path: this.iosProjectPath }
@@ -7955,9 +8008,9 @@ class CapacitorApp {
     await this.#writeCapacitorConfig();
     if (regenerate) {
       if (!platform || platform === "ios")
-        await rm4(path34.join(this.app.cwdPath, this.iosRootPath), { recursive: true, force: true });
+        await rm4(path35.join(this.app.cwdPath, this.iosRootPath), { recursive: true, force: true });
       if (!platform || platform === "android")
-        await rm4(path34.join(this.app.cwdPath, this.androidRootPath), { recursive: true, force: true });
+        await rm4(path35.join(this.app.cwdPath, this.androidRootPath), { recursive: true, force: true });
     }
     const project = this.project;
     await this.project.load();
@@ -8019,7 +8072,7 @@ class CapacitorApp {
     await this.#spawnMobile("npx", ["cap", "sync", "android"], { operation, env });
   }
   async#updateAndroidBuildTypes() {
-    const appGradle = await FileEditor.create(path34.join(this.app.cwdPath, this.androidRootPath, "app/build.gradle"));
+    const appGradle = await FileEditor.create(path35.join(this.app.cwdPath, this.androidRootPath, "app/build.gradle"));
     const buildTypesBlock = `
       debug {
         applicationIdSuffix ".debug"
@@ -8062,7 +8115,7 @@ class CapacitorApp {
     const gradleCommand = isWindows ? "gradlew.bat" : "./gradlew";
     await this.app.spawn(gradleCommand, [assembleType === "apk" ? "assembleRelease" : "bundleRelease"], {
       stdio: "inherit",
-      cwd: path34.join(this.app.cwdPath, this.androidRootPath),
+      cwd: path35.join(this.app.cwdPath, this.androidRootPath),
       env: this.#commandEnv("release", env)
     });
   }
@@ -8091,12 +8144,12 @@ class CapacitorApp {
     await this.#prepareAndroid({ operation: "release", env: "main" });
   }
   async prepareWww() {
-    const htmlSource = path34.join(this.app.dist.cwdPath, "csr", targetHtmlFilename(this.target));
+    const htmlSource = path35.join(this.app.dist.cwdPath, "csr", targetHtmlFilename(this.target));
     if (!await Bun.file(htmlSource).exists())
       throw new Error(`CSR html for mobile target '${this.target.name}' not found: ${htmlSource}`);
     await rm4(this.targetWebRoot, { recursive: true, force: true });
     await mkdir10(this.targetWebRoot, { recursive: true });
-    await Bun.write(path34.join(this.targetWebRoot, "index.html"), this.#injectMobileTargetMeta(await Bun.file(htmlSource).text()));
+    await Bun.write(path35.join(this.targetWebRoot, "index.html"), this.#injectMobileTargetMeta(await Bun.file(htmlSource).text()));
   }
   #injectMobileTargetMeta(html) {
     const basePath2 = this.target.basePath?.replace(/^\/+|\/+$/g, "") ?? "";
@@ -8108,7 +8161,7 @@ class CapacitorApp {
   }
   async#writeCapacitorConfig() {
     await mkdir10(this.targetRoot, { recursive: true });
-    const appInfoPath = path34.relative(this.app.cwdPath, path34.join(this.app.cwdPath, "akan.app.json")).split(path34.sep).join("/");
+    const appInfoPath = path35.relative(this.app.cwdPath, path35.join(this.app.cwdPath, "akan.app.json")).split(path35.sep).join("/");
     const content = `import type { AppScanResult } from "akanjs";
 import { withBase } from "akanjs/capacitor.base.config";
 import appInfo from "${appInfoPath.startsWith(".") ? appInfoPath : `./${appInfoPath}`}";
@@ -8129,18 +8182,18 @@ export default withBase(
   appInfo as AppScanResult,
 );
 `;
-    await Bun.write(path34.join(this.app.cwdPath, "capacitor.config.ts"), content);
+    await Bun.write(path35.join(this.app.cwdPath, "capacitor.config.ts"), content);
   }
   async#prepareTargetAssets() {
     if (!this.target.assets)
       return;
     await mkdir10(this.targetAssetRoot, { recursive: true });
     if (this.target.assets.icon)
-      await cp2(path34.join(this.app.cwdPath, this.target.assets.icon), path34.join(this.targetAssetRoot, "icon.png"), {
+      await cp2(path35.join(this.app.cwdPath, this.target.assets.icon), path35.join(this.targetAssetRoot, "icon.png"), {
         force: true
       });
     if (this.target.assets.splash)
-      await cp2(path34.join(this.app.cwdPath, this.target.assets.splash), path34.join(this.targetAssetRoot, "splash.png"), {
+      await cp2(path35.join(this.app.cwdPath, this.target.assets.splash), path35.join(this.targetAssetRoot, "splash.png"), {
         force: true
       });
   }
@@ -8148,11 +8201,11 @@ export default withBase(
     const files = this.target.files?.[platform];
     if (!files)
       return;
-    const platformRoot = path34.join(this.app.cwdPath, platform === "ios" ? this.iosRootPath : this.androidRootPath);
+    const platformRoot = path35.join(this.app.cwdPath, platform === "ios" ? this.iosRootPath : this.androidRootPath);
     await Promise.all(Object.entries(files).map(async ([to, from]) => {
-      const targetPath = path34.join(platformRoot, to);
-      await mkdir10(path34.dirname(targetPath), { recursive: true });
-      await cp2(path34.join(this.app.cwdPath, from), targetPath, { force: true });
+      const targetPath = path35.join(platformRoot, to);
+      await mkdir10(path35.dirname(targetPath), { recursive: true });
+      await cp2(path35.join(this.app.cwdPath, from), targetPath, { force: true });
     }));
   }
   async#generateAssets({ operation, env }) {
@@ -8162,7 +8215,7 @@ export default withBase(
       "@capacitor/assets",
       "generate",
       "--assetPath",
-      path34.posix.join(this.targetRootPath, "assets"),
+      path35.posix.join(this.targetRootPath, "assets"),
       "--iosProject",
       this.iosProjectPath,
       "--androidProject",
@@ -8347,7 +8400,7 @@ var Pkg = createInternalArgToken("Pkg");
 var Module = createInternalArgToken("Module");
 var Workspace = createInternalArgToken("Workspace");
 // pkgs/@akanjs/devkit/commandDecorators/command.ts
-import path35 from "path";
+import path36 from "path";
 import { confirm, input as input2, select as select2 } from "@inquirer/prompts";
 import { Logger as Logger11 } from "akanjs/common";
 import chalk6 from "chalk";
@@ -8847,7 +8900,7 @@ var runCommands = async (...commands) => {
     process.exit(1);
   });
   const __dirname2 = getDirname(import.meta.url);
-  const packageJsonCandidates = [`${path35.dirname(Bun.main)}/package.json`, `${__dirname2}/../package.json`];
+  const packageJsonCandidates = [`${path36.dirname(Bun.main)}/package.json`, `${__dirname2}/../package.json`];
   let cliPackageJson = null;
   for (const packageJsonPath of packageJsonCandidates) {
     if (!await FileSys.fileExists(packageJsonPath))
@@ -9123,8 +9176,8 @@ var scanModuleSpecifiers = (source, filePath, includeExports) => {
   return importSpecifiers;
 };
 var parseTsConfig = (tsConfigPath = "./tsconfig.json") => {
-  const configFile = ts6.readConfigFile(tsConfigPath, (path36) => {
-    return ts6.sys.readFile(path36);
+  const configFile = ts6.readConfigFile(tsConfigPath, (path37) => {
+    return ts6.sys.readFile(path37);
   });
   return ts6.parseJsonConfigFileContent(configFile.config, ts6.sys, realpathSync(tsConfigPath).replace(/[^/\\]+$/, ""));
 };
@@ -9469,7 +9522,6 @@ class LibraryScript extends script("library", [LibraryRunner]) {
 }
 
 // pkgs/@akanjs/cli/application/application.runner.ts
-import path36 from "path";
 import { confirm as confirm2, input as input4, select as select5 } from "@inquirer/prompts";
 import { StringOutputParser } from "@langchain/core/output_parsers";
 import { PromptTemplate as PromptTemplate2 } from "@langchain/core/prompts";
@@ -9535,14 +9587,14 @@ class ApplicationRunner extends runner("application") {
   }
   async test(exec2) {
     const isSignalTarget = exec2 instanceof AppExecutor || exec2 instanceof LibExecutor;
-    const preloadPath = path36.join(exec2.cwdPath, "../../pkgs/akanjs/test/signalTest.preload.ts");
+    const preloadPath = isSignalTarget ? await resolveSignalTestPreloadPath(exec2) : null;
     const env = isSignalTarget ? {
       AKAN_TEST_SIGNAL: "1",
       AKAN_TEST_TARGET_TYPE: exec2.type,
       AKAN_TEST_TARGET_NAME: exec2.name,
       AKAN_TEST_LIBS: exec2.getScanInfo({ allowEmpty: true })?.getLibs().join(",") ?? ""
     } : {};
-    const args = isSignalTarget ? ["test", "--isolate", "--preload", preloadPath] : ["test", "--isolate"];
+    const args = preloadPath ? ["test", "--isolate", "--preload", preloadPath] : ["test", "--isolate"];
     await exec2.spawn("bun", args, {
       ...isSignalTarget ? { env: { ...process.env, ...env } } : {},
       stdio: "inherit"
@@ -9841,12 +9893,17 @@ class ApplicationScript extends script("application", [ApplicationRunner, Librar
     }
   }
   async test(exec2, { write = true } = {}) {
+    if (exec2 instanceof LibExecutor) {
+      await this.libraryScript.syncLibrary(exec2);
+      const spinner3 = exec2.spinning(`Preparing ${exec2.name}...`);
+      spinner3.succeed(`${exec2.name} prepared`);
+      await this.applicationRunner.test(exec2);
+      return;
+    }
     const spinner2 = exec2.spinning(`Preparing ${exec2.name}...`);
     try {
       if (exec2 instanceof PkgExecutor)
         await exec2.scan({ refresh: true });
-      else if (exec2 instanceof LibExecutor)
-        await this.libraryScript.syncLibrary(exec2);
       else
         await exec2.scanSync({ write });
       spinner2.succeed(`${exec2.name} prepared`);
@@ -10229,17 +10286,21 @@ class PackageScript extends script("package", [PackageRunner]) {
 }
 
 // pkgs/@akanjs/cli/cloud/cloud.runner.ts
+import path38 from "path";
 import { confirm as confirm3 } from "@inquirer/prompts";
 import { Logger as Logger15, sleep } from "akanjs/common";
 import chalk7 from "chalk";
 import * as QRcode from "qrcode";
 
 // pkgs/@akanjs/cli/npmRegistry.ts
-async function getLatestPackageVersion(packageName, tag = "latest") {
-  const url = `https://registry.npmjs.org/${encodeURIComponent(packageName).replace(/^%40/, "@")}`;
+var defaultNpmRegistry = "https://registry.npmjs.org";
+var getNpmRegistryUrl = (registryUrl = process.env.AKAN_NPM_REGISTRY ?? defaultNpmRegistry) => registryUrl.replace(/\/+$/, "");
+async function getLatestPackageVersion(packageName, tag = "latest", registryUrl) {
+  const registry = getNpmRegistryUrl(registryUrl);
+  const url = `${registry}/${encodeURIComponent(packageName).replace(/^%40/, "@")}`;
   const res = await fetch(url);
   if (!res.ok)
-    throw new Error(`Failed to fetch ${packageName} metadata from npm registry`);
+    throw new Error(`Failed to fetch ${packageName} metadata from ${registry}`);
   const metadata = await res.json();
   const version = metadata["dist-tags"]?.[tag];
   if (!version)
@@ -10249,6 +10310,24 @@ async function getLatestPackageVersion(packageName, tag = "latest") {
 
 // pkgs/@akanjs/cli/cloud/cloud.runner.ts
 class CloudRunner extends runner("cloud") {
+  #akanFrameworkPackages = new Set(["akanjs", "@akanjs/devkit", "@akanjs/cli", "create-akan-workspace"]);
+  #getRegistryArgs(registryUrl) {
+    return registryUrl ? ["--registry", getNpmRegistryUrl(registryUrl)] : [];
+  }
+  #getLocalRegistryAuthArgs(registryUrl) {
+    if (!registryUrl)
+      return [];
+    const { host, pathname } = new URL(getNpmRegistryUrl(registryUrl));
+    const registryPath = pathname === "/" ? "/" : `${pathname.replace(/\/+$/, "")}/`;
+    return [`--//${host}${registryPath}:_authToken=akan-local-registry`];
+  }
+  #getRegistryEnv(registryUrl) {
+    return registryUrl ? {
+      ...process.env,
+      AKAN_NPM_REGISTRY: getNpmRegistryUrl(registryUrl),
+      NPM_CONFIG_REGISTRY: getNpmRegistryUrl(registryUrl)
+    } : process.env;
+  }
   async login() {
     const config = await getHostConfig();
     const self = config.auth ? await getSelf(config.auth.token) : null;
@@ -10327,15 +10406,16 @@ ${chalk7.green("\u27A4")} Authentication Required`));
     const pkgs = await workspace.getPkgs();
     return pkgs.filter((pkg) => pkg === "akanjs" || pkg === "create-akan-workspace" || pkg.startsWith("@akanjs/"));
   }
-  async deployAkan(workspace, akanPkgs) {
+  async deployAkan(workspace, akanPkgs, { registryUrl, confirmPublish = true, tag: distTag } = {}) {
+    const registry = registryUrl ? getNpmRegistryUrl(registryUrl) : undefined;
     const akanPackageJson2 = await workspace.readJson("pkgs/akanjs/package.json");
     const [majorVersion, minorVersion, patchVersion, devPatchVersion] = akanPackageJson2.version.split(".");
     const isOfficialRelease = !devPatchVersion;
     const targetVersionPrefix = isOfficialRelease ? `${majorVersion}.${minorVersion}` : `${majorVersion}.${minorVersion}.${patchVersion}`;
-    const tag = isOfficialRelease ? "latest" : patchVersion.split("-").at(1) ?? "dev";
+    const tag = distTag ?? (isOfficialRelease ? "latest" : patchVersion.split("-").at(1) ?? "dev");
     const getNextVersion = async (prefix, tag2) => {
       try {
-        const latestPublishedVersion2 = await getLatestPackageVersion("akanjs", tag2);
+        const latestPublishedVersion2 = await getLatestPackageVersion("akanjs", tag2, registry);
         const latestPatch = latestPublishedVersion2.startsWith(prefix) ? parseInt(latestPublishedVersion2.split(".").at(-1) ?? "-1") : -1;
         const nextVersion2 = `${prefix}.${latestPatch + 1}`;
         return { nextVersion: nextVersion2, latestPublishedVersion: latestPublishedVersion2 };
@@ -10348,37 +10428,46 @@ ${chalk7.green("\u27A4")} Authentication Required`));
     Logger15.info(`Next version of akanjs: ${nextVersion}`);
     for (const library of akanPkgs) {
       const packageJson = await workspace.readJson(`pkgs/${library}/package.json`);
-      const newPackageJsonStr = JSON.stringify({ ...packageJson, version: nextVersion }, null, 2);
+      const newPackageJsonStr = JSON.stringify(this.#normalizeAkanPackageJson(packageJson, library, nextVersion), null, 2);
       await workspace.writeFile(`pkgs/${library}/package.json`, newPackageJsonStr);
       const distPackageJson = await workspace.readJson(`dist/pkgs/${library}/package.json`);
-      const newDistPackageJson = { ...distPackageJson, version: nextVersion };
+      const newDistPackageJson = this.#normalizeAkanPackageJson(distPackageJson, library, nextVersion);
       await workspace.writeJson(`dist/pkgs/${library}/package.json`, newDistPackageJson);
     }
-    const isDeployConfirmed = await confirm3({
-      message: "Are you sure you want to deploy the libraries?"
-    });
-    if (!isDeployConfirmed) {
-      Logger15.error("Deployment cancelled");
-      return;
+    if (confirmPublish) {
+      const isDeployConfirmed = await confirm3({
+        message: "Are you sure you want to deploy the libraries?"
+      });
+      if (!isDeployConfirmed) {
+        Logger15.error("Deployment cancelled");
+        return;
+      }
     }
     await Promise.all(akanPkgs.map(async (library) => {
-      Logger15.info(`Publishing ${library}@${nextVersion} to npm...`);
-      await workspace.exec(`npm publish --tag ${tag}`, { cwd: `dist/pkgs/${library}` });
-      Logger15.info(`${library}@${nextVersion} is published to npm`);
+      Logger15.info(`Publishing ${library}@${nextVersion} to ${registry ?? "npm"}...`);
+      await workspace.spawn("npm", ["publish", "--tag", tag, ...this.#getRegistryArgs(registry), ...this.#getLocalRegistryAuthArgs(registry)], {
+        cwd: path38.join(workspace.workspaceRoot, "dist/pkgs", library),
+        env: this.#getRegistryEnv(registry),
+        stdio: "inherit"
+      });
+      Logger15.info(`${library}@${nextVersion} is published to ${registry ?? "npm"}`);
     }));
-    Logger15.info("All libraries are published to npm");
+    Logger15.info(`All libraries are published to ${registry ?? "npm"}`);
   }
-  async update(workspace, tag = "latest") {
+  async update(workspace, tag = "latest", { registryUrl } = {}) {
+    const registry = registryUrl ? getNpmRegistryUrl(registryUrl) : undefined;
+    const registryArgs = this.#getRegistryArgs(registry);
+    const env = this.#getRegistryEnv(registry);
     if (!await workspace.exists("package.json"))
-      await workspace.spawn("npm", ["update", "-g", "akanjs", "--latest", `--tag=${tag}`]);
+      await workspace.spawn("bun", ["update", "-g", "akanjs", "--latest", `--tag=${tag}`, ...registryArgs], { env });
     else
       await Promise.all([
-        workspace.spawn("npm", ["update", "-g", "akanjs", "--latest", `--tag=${tag}`]),
-        this.#updateAkanPkgs(workspace, tag)
+        workspace.spawn("bun", ["update", "-g", "akanjs", "--latest", `--tag=${tag}`, ...registryArgs], { env }),
+        this.#updateAkanPkgs(workspace, tag, registry)
       ]);
   }
-  async#updateAkanPkgs(workspace, tag = "latest") {
-    const latestPublishedVersion = await getLatestPackageVersion("akanjs", tag);
+  async#updateAkanPkgs(workspace, tag = "latest", registryUrl) {
+    const latestPublishedVersion = await getLatestPackageVersion("akanjs", tag, registryUrl);
     const rootPackageJson = await workspace.getPackageJson();
     if (!rootPackageJson.dependencies)
       throw new Error("No dependencies found in package.json");
@@ -10386,8 +10475,27 @@ ${chalk7.green("\u27A4")} Authentication Required`));
       rootPackageJson.dependencies.akanjs = latestPublishedVersion;
     if (rootPackageJson.devDependencies?.akanjs)
       rootPackageJson.devDependencies.akanjs = latestPublishedVersion;
-    workspace.setPackageJson(rootPackageJson);
-    await workspace.spawn("bun", ["install"]);
+    if (rootPackageJson.dependencies["@akanjs/devkit"])
+      rootPackageJson.dependencies["@akanjs/devkit"] = latestPublishedVersion;
+    if (rootPackageJson.devDependencies?.["@akanjs/devkit"])
+      rootPackageJson.devDependencies["@akanjs/devkit"] = latestPublishedVersion;
+    await workspace.setPackageJson(rootPackageJson);
+    await workspace.spawn("bun", ["install", ...this.#getRegistryArgs(registryUrl)], {
+      env: this.#getRegistryEnv(registryUrl)
+    });
+  }
+  #normalizeAkanPackageJson(packageJson, packageName, version) {
+    const normalized = { ...packageJson, version };
+    for (const field of ["dependencies", "devDependencies", "peerDependencies", "optionalDependencies"]) {
+      const dependencies = normalized[field];
+      if (!dependencies)
+        continue;
+      normalized[field] = Object.fromEntries(Object.entries(dependencies).map(([dep, depVersion]) => [
+        dep,
+        dep !== packageName && this.#akanFrameworkPackages.has(dep) ? version : depVersion
+      ]));
+    }
+    return normalized;
   }
 }
 
@@ -10409,7 +10517,7 @@ class CloudScript extends script("cloud", [CloudRunner, ApplicationScript, Packa
     const session = new AiSession("general", { workspace, isContinued: true });
     await session.ask(question);
   }
-  async deployAkan(workspace, { test = true } = {}) {
+  async deployAkan(workspace, { test = true, registryUrl } = {}) {
     const akanPkgs = await this.cloudRunner.getAkanPkgs(workspace);
     await this.packageScript.updateWorskpaceRootPackageJson(workspace);
     const pkgs = akanPkgs.map((pkgName) => PkgExecutor.from(workspace, pkgName));
@@ -10418,11 +10526,11 @@ class CloudScript extends script("cloud", [CloudRunner, ApplicationScript, Packa
         await this.applicationScript.test(pkg);
     for (const pkg of pkgs)
       await this.packageScript.buildPackage(pkg);
-    await this.cloudRunner.deployAkan(workspace, akanPkgs);
+    await this.cloudRunner.deployAkan(workspace, akanPkgs, { registryUrl });
   }
-  async update(workspace, tag = "latest") {
+  async update(workspace, tag = "latest", { registryUrl } = {}) {
     const spinner2 = workspace.spinning("Updating Akan.js packages and CLI...");
-    await this.cloudRunner.update(workspace, tag);
+    await this.cloudRunner.update(workspace, tag, { registryUrl });
     spinner2.succeed("Akan.js packages and CLI updated, global version is below");
     Logger16.raw("> Akan version: ");
     await workspace.spawn("akan", ["--version"], { stdio: "inherit" });
@@ -10430,6 +10538,9 @@ class CloudScript extends script("cloud", [CloudRunner, ApplicationScript, Packa
 }
 
 // pkgs/@akanjs/cli/cloud/cloud.command.ts
+var localRegistryUrl = () => process.env.AKAN_NPM_REGISTRY ?? "http://127.0.0.1:4873";
+var resolveRegistryUrl = (registry) => registry === "local" ? localRegistryUrl() : undefined;
+
 class CloudCommand extends command("cloud", [CloudScript], ({ public: target }) => ({
   login: target({ desc: "Login to Akan Cloud services" }).with(Workspace).exec(async function(workspace) {
     await this.cloudScript.login(workspace);
@@ -10446,15 +10557,32 @@ class CloudCommand extends command("cloud", [CloudScript], ({ public: target })
   ask: target({ desc: "Ask AI assistant a question about your project" }).option("question", String, { ask: "question to ask" }).with(Workspace).exec(async function(question, workspace) {
     await this.cloudScript.ask(question, workspace);
   }),
-  deployAkan: target({ devOnly: true, desc: "Deploy Akan.js framework to cloud (internal use)" }).option("test", Boolean, { desc: "test the deployment", default: true }).with(Workspace).exec(async function(test, workspace) {
-    await this.cloudScript.deployAkan(workspace, { test });
+  deployAkan: target({ devOnly: true, desc: "Deploy Akan.js framework to cloud (internal use)" }).option("test", Boolean, { desc: "test the deployment", default: true }).option("registry", String, {
+    desc: "registry target for publishing Akan packages",
+    ask: "Select a registry target",
+    enum: [
+      { label: "local", value: "local" },
+      { label: "npm", value: "npm" }
+    ]
+  }).with(Workspace).exec(async function(test, registry, workspace) {
+    await this.cloudScript.deployAkan(workspace, {
+      test,
+      registryUrl: resolveRegistryUrl(registry)
+    });
   }),
   update: target({ desc: "Update Akan.js framework to the latest version" }).with(Workspace).option("tag", String, {
     desc: "tag of the update",
     default: "latest",
     enum: ["latest", "dev", "canary", "beta", "rc", "alpha"]
-  }).exec(async function(workspace, tag) {
-    await this.cloudScript.update(workspace, tag);
+  }).option("registry", String, {
+    desc: "registry target for resolving Akan packages",
+    ask: "Select a registry target",
+    enum: [
+      { label: "npm", value: "npm" },
+      { label: "local", value: "local" }
+    ]
+  }).exec(async function(workspace, tag, registry) {
+    await this.cloudScript.update(workspace, tag, { registryUrl: resolveRegistryUrl(registry) });
   })
 })) {
 }
@@ -10480,14 +10608,14 @@ class GuidelinePrompt extends Prompter {
   async#getScanFilePaths(matchPattern, { avoidDirs = ["node_modules", ".next"], filterText } = {}) {
     const glob = new Bun.Glob(matchPattern);
     const paths = [];
-    for await (const path38 of glob.scan({ cwd: this.workspace.workspaceRoot, absolute: true })) {
-      if (avoidDirs.some((dir) => path38.includes(dir)))
+    for await (const path39 of glob.scan({ cwd: this.workspace.workspaceRoot, absolute: true })) {
+      if (avoidDirs.some((dir) => path39.includes(dir)))
         continue;
-      const fileContent = await FileSys.readText(path38);
+      const fileContent = await FileSys.readText(path39);
       const textFilter = filterText ? new RegExp(filterText) : null;
       if (filterText && !textFilter?.test(fileContent))
         continue;
-      paths.push(path38);
+      paths.push(path39);
     }
     return paths;
   }
@@ -10782,6 +10910,147 @@ class LibraryCommand extends command("library", [LibraryScript], ({ public: targ
 })) {
 }
 
+// pkgs/@akanjs/cli/localRegistry/localRegistry.runner.ts
+import { mkdir as mkdir11, rm as rm5 } from "fs/promises";
+import path39 from "path";
+import { Logger as Logger17 } from "akanjs/common";
+var defaultLocalRegistryUrl = "http://127.0.0.1:4873";
+var containerName = "akan-verdaccio";
+var smokeRepoName = "akan-local-smoke";
+var smokeAppName = "demo";
+
+class LocalRegistryRunner extends runner("localRegistry") {
+  getRegistryUrl(registryUrl = process.env.AKAN_NPM_REGISTRY ?? defaultLocalRegistryUrl) {
+    return getNpmRegistryUrl(registryUrl);
+  }
+  async start(workspace, { registryUrl } = {}) {
+    const registry = this.getRegistryUrl(registryUrl);
+    try {
+      await workspace.spawn("docker", ["inspect", containerName]);
+      Logger17.info(`Local registry is already running at ${registry}`);
+      return registry;
+    } catch {}
+    const configPath2 = path39.join(workspace.workspaceRoot, "pkgs/@akanjs/cli/localRegistry/verdaccio.yaml");
+    const storagePath = path39.join(workspace.workspaceRoot, ".akan/verdaccio/storage");
+    await mkdir11(storagePath, { recursive: true });
+    await workspace.spawn("docker", [
+      "run",
+      "--rm",
+      "-d",
+      "--name",
+      containerName,
+      "-p",
+      "4873:4873",
+      "-v",
+      `${configPath2}:/verdaccio/conf/config.yaml:ro`,
+      "-v",
+      `${storagePath}:/verdaccio/storage`,
+      "verdaccio/verdaccio:6"
+    ], { stdio: "inherit" });
+    Logger17.info(`Local registry is running at ${registry}`);
+    return registry;
+  }
+  async reset(workspace) {
+    try {
+      await workspace.spawn("docker", ["rm", "-f", containerName], { stdio: "inherit" });
+    } catch {}
+    await rm5(path39.join(workspace.workspaceRoot, ".akan/verdaccio"), { recursive: true, force: true });
+    Logger17.info("Local registry storage has been reset");
+  }
+  async smoke(workspace, { registryUrl } = {}) {
+    const registry = this.getRegistryUrl(registryUrl);
+    const smokeRoot = path39.join(workspace.workspaceRoot, ".akan/e2e");
+    await rm5(path39.join(smokeRoot, smokeRepoName), { recursive: true, force: true });
+    await workspace.spawn(process.execPath, [
+      "dist/pkgs/create-akan-workspace/index.js",
+      smokeRepoName,
+      "--app",
+      smokeAppName,
+      "--dir",
+      ".akan/e2e",
+      "--init",
+      "true",
+      "--registry",
+      registry
+    ], {
+      env: { ...process.env, AKAN_NPM_REGISTRY: registry, NPM_CONFIG_REGISTRY: registry },
+      stdio: "inherit"
+    });
+    await workspace.spawn("akan", ["build", smokeAppName], {
+      cwd: path39.join(smokeRoot, smokeRepoName),
+      env: { ...process.env, AKAN_NPM_REGISTRY: registry, NPM_CONFIG_REGISTRY: registry },
+      stdio: "inherit"
+    });
+    Logger17.info(`Local registry smoke test completed for ${smokeRepoName}/${smokeAppName}`);
+  }
+}
+
+// pkgs/@akanjs/cli/localRegistry/localRegistry.script.ts
+class LocalRegistryScript extends script("localRegistry", [
+  LocalRegistryRunner,
+  CloudRunner,
+  ApplicationScript,
+  PackageScript
+]) {
+  async start(workspace, { registryUrl } = {}) {
+    const spinner2 = workspace.spinning("Starting local npm registry...");
+    const registry = await this.localRegistryRunner.start(workspace, { registryUrl });
+    spinner2.succeed(`Local npm registry is ready at ${registry}`);
+  }
+  async reset(workspace) {
+    const spinner2 = workspace.spinning("Resetting local npm registry...");
+    await this.localRegistryRunner.reset(workspace);
+    spinner2.succeed("Local npm registry reset");
+  }
+  async smoke(workspace, { tag = "rc", test = true, registryUrl } = {}) {
+    const registry = await this.localRegistryRunner.start(workspace, { registryUrl });
+    const akanPkgs = await this.cloudRunner.getAkanPkgs(workspace);
+    await this.#preparePackages(workspace, akanPkgs, { test });
+    await this.cloudRunner.deployAkan(workspace, akanPkgs, {
+      registryUrl: registry,
+      confirmPublish: false,
+      tag
+    });
+    await this.localRegistryRunner.smoke(workspace, { registryUrl: registry });
+  }
+  async#preparePackages(workspace, akanPkgs, { test = true } = {}) {
+    await this.packageScript.updateWorskpaceRootPackageJson(workspace);
+    const pkgs = akanPkgs.map((pkgName) => PkgExecutor.from(workspace, pkgName));
+    if (test)
+      for (const pkg of pkgs)
+        await this.applicationScript.test(pkg);
+    for (const pkg of pkgs)
+      await this.packageScript.buildPackage(pkg, { showSpinner: false });
+  }
+}
+
+// pkgs/@akanjs/cli/localRegistry/localRegistry.command.ts
+class LocalRegistryCommand extends command("local-registry", [LocalRegistryScript], ({ public: target }) => ({
+  startRegistry: target({ devOnly: true, desc: "Start the local Verdaccio npm registry" }).with(Workspace).option("registry", String, {
+    desc: "local npm registry URL",
+    default: process.env.AKAN_NPM_REGISTRY ?? "http://127.0.0.1:4873"
+  }).exec(async function(workspace, registry) {
+    await this.localRegistryScript.start(workspace, { registryUrl: registry });
+  }),
+  resetRegistry: target({ devOnly: true, desc: "Stop and clear the local Verdaccio npm registry" }).with(Workspace).exec(async function(workspace) {
+    await this.localRegistryScript.reset(workspace);
+  }),
+  smokeRegistry: target({ devOnly: true, desc: "Publish to local registry and build a generated workspace" }).with(Workspace).option("tag", String, {
+    flag: "g",
+    desc: "dist-tag for local registry publish",
+    default: "rc"
+  }).option("test", Boolean, {
+    desc: "run package tests before publishing",
+    default: true
+  }).option("registry", String, {
+    desc: "local npm registry URL",
+    default: process.env.AKAN_NPM_REGISTRY
+  }).exec(async function(workspace, tag, test, registry) {
+    await this.localRegistryScript.smoke(workspace, { tag, test, registryUrl: registry });
+  })
+})) {
+}
+
 // pkgs/@akanjs/cli/module/module.command.ts
 import { lowerlize } from "akanjs/common";
 
@@ -11577,11 +11846,11 @@ class ScalarCommand extends command("scalar", [ScalarScript], ({ public: target
 }
 
 // pkgs/@akanjs/cli/workspace/workspace.script.ts
-import path39 from "path";
-import { Logger as Logger17 } from "akanjs/common";
+import path41 from "path";
+import { Logger as Logger18 } from "akanjs/common";
 
 // pkgs/@akanjs/cli/workspace/workspace.runner.ts
-import path38 from "path";
+import path40 from "path";
 var defaultWorkspacePeerDependencies = new Set([
   "@radix-ui/react-dialog",
   "@react-spring/web",
@@ -11601,17 +11870,29 @@ var defaultWorkspacePeerDependencies = new Set([
 ]);
 
 class WorkspaceRunner extends runner("workspace") {
-  async createWorkspace(repoName, appName, { dirname: dirname3 = ".", init = true, akanVersion }) {
+  async createWorkspace(repoName, appName, {
+    dirname: dirname3 = ".",
+    init = true,
+    akanVersion,
+    registryUrl
+  }) {
     const cwdPath = process.cwd();
-    const workspaceRoot = path38.join(cwdPath, dirname3, repoName);
+    const workspaceRoot = path40.join(cwdPath, dirname3, repoName);
+    const normalizedRegistryUrl = registryUrl ? getNpmRegistryUrl(registryUrl) : undefined;
     const workspace = WorkspaceExecutor.fromRoot({ workspaceRoot, repoName });
     const templateSpinner = workspace.spinning(`Creating workspace template files in ${dirname3}/${repoName}...`);
-    const latestTypesBunVersion = await getLatestPackageVersion("@types/bun");
+    const [latestBiomeVersion, latestTypesBunVersion] = await Promise.all([
+      getLatestPackageVersion("@biomejs/biome", "latest", normalizedRegistryUrl),
+      getLatestPackageVersion("@types/bun", "latest", normalizedRegistryUrl)
+    ]);
     await workspace.applyTemplate({
       basePath: ".",
       template: "workspaceRoot",
       dict: { repoName, appName, serveDomain: "localhost" }
     });
+    if (normalizedRegistryUrl)
+      await workspace.writeFile(".npmrc", `registry=${normalizedRegistryUrl}/
+`);
     templateSpinner.succeed(`Workspace files created in ${dirname3}/${repoName}`);
     const [rootPackageJson, peerDependencies] = await Promise.all([
       workspace.getPackageJson(),
@@ -11627,7 +11908,9 @@ class WorkspaceRunner extends runner("workspace") {
       },
       devDependencies: {
         ...rootPackageJson.devDependencies,
+        "@biomejs/biome": latestBiomeVersion,
         "@types/bun": latestTypesBunVersion,
+        "@akanjs/devkit": akanVersion,
         ...typescript ? { typescript } : {}
       }
     };
@@ -11650,9 +11933,9 @@ class WorkspaceRunner extends runner("workspace") {
   }
   async#getCliPackageJson() {
     const packageJsonCandidates = [
-      path38.join(import.meta.dir, "../package.json"),
-      path38.join(import.meta.dir, "package.json"),
-      path38.join(path38.dirname(Bun.main), "package.json")
+      path40.join(import.meta.dir, "../package.json"),
+      path40.join(import.meta.dir, "package.json"),
+      path40.join(path40.dirname(Bun.main), "package.json")
     ];
     try {
       packageJsonCandidates.unshift(Bun.resolveSync("@akanjs/cli/package.json", import.meta.dir));
@@ -11668,9 +11951,9 @@ class WorkspaceRunner extends runner("workspace") {
   }
   async#getAkanPackageJson() {
     const packageJsonCandidates = [
-      path38.join(import.meta.dir, "../../../akanjs/package.json"),
-      path38.join(process.cwd(), "pkgs/akanjs/package.json"),
-      path38.join(path38.dirname(Bun.main), "node_modules/akanjs/package.json")
+      path40.join(import.meta.dir, "../../../akanjs/package.json"),
+      path40.join(process.cwd(), "pkgs/akanjs/package.json"),
+      path40.join(path40.dirname(Bun.main), "node_modules/akanjs/package.json")
     ];
     try {
       packageJsonCandidates.unshift(Bun.resolveSync("akanjs/package.json", import.meta.dir));
@@ -11684,13 +11967,13 @@ class WorkspaceRunner extends runner("workspace") {
     }
     let current = import.meta.dir;
     for (let depth = 0;depth < 6; depth++) {
-      const packageJsonPath = path38.join(current, "package.json");
+      const packageJsonPath = path40.join(current, "package.json");
       if (await Bun.file(packageJsonPath).exists()) {
         const packageJson = await FileSys.readJson(packageJsonPath);
         if (packageJson.name === "akanjs")
           return packageJson;
       }
-      const parent = path38.dirname(current);
+      const parent = path40.dirname(current);
       if (parent === current)
         break;
       current = parent;
@@ -11714,12 +11997,18 @@ class WorkspaceScript extends script("workspace", [
   LibraryScript,
   PackageScript
 ]) {
-  async createWorkspace(repoName, appName, { dirname: dirname3 = ".", installLibs = false, init = true }) {
+  async createWorkspace(repoName, appName, {
+    dirname: dirname3 = ".",
+    installLibs = false,
+    init = true,
+    registryUrl
+  }) {
     const akanVersion = await this.packageScript.version(null, { log: false });
     const workspace = await this.workspaceRunner.createWorkspace(repoName, appName, {
       dirname: dirname3,
       init,
-      akanVersion
+      akanVersion,
+      ...registryUrl ? { registryUrl } : {}
     });
     if (installLibs) {
       await this.libraryScript.installLibrary(workspace, "util");
@@ -11733,11 +12022,11 @@ class WorkspaceScript extends script("workspace", [
     } catch (_) {
       gitSpinner.fail("Git repository initialization failed. It's not fatal, you can commit manually");
     }
-    const workspacePath = path39.join(dirname3, repoName);
-    Logger17.rawLog(`
+    const workspacePath = path41.join(dirname3, repoName);
+    Logger18.rawLog(`
 \uD83C\uDF89 Welcome aboard! Workspace created in ${dirname3}/${repoName}`);
-    Logger17.rawLog(`\uD83D\uDE80 Run \`cd ${workspacePath} && akan start ${appName}\` to start the development server.`);
-    Logger17.rawLog(`
+    Logger18.rawLog(`\uD83D\uDE80 Run \`cd ${workspacePath} && akan start ${appName}\` to start the development server.`);
+    Logger18.rawLog(`
 \uD83D\uDC4B Happy coding!`);
   }
   async lint(exec2, workspace, { fix = true } = {}) {
@@ -11792,9 +12081,12 @@ class WorkspaceCommand extends command("workspace", [WorkspaceScript], ({ public
   }).option("init", Boolean, {
     desc: "Do you want to initialize the workspace? (Recommended)",
     default: true
-  }).exec(async function(workspaceName, app, dir, libs, init) {
+  }).option("registry", String, {
+    desc: "npm registry URL for installing Akan packages",
+    default: process.env.AKAN_NPM_REGISTRY
+  }).exec(async function(workspaceName, app, dir, libs, init, registry) {
     const appName = app || "app";
-    await this.workspaceScript.createWorkspace(workspaceName.toLowerCase().replace(/ /g, "-"), appName.toLowerCase().replace(/ /g, "-"), { dirname: dir, installLibs: libs, init });
+    await this.workspaceScript.createWorkspace(workspaceName.toLowerCase().replace(/ /g, "-"), appName.toLowerCase().replace(/ /g, "-"), { dirname: dir, installLibs: libs, init, ...registry ? { registryUrl: registry } : {} });
   }),
   lint: target({ desc: "Lint and fix code in a specific app/lib/pkg" }).with(Exec).option("fix", Boolean, { default: true }).with(Workspace).exec(async function(exec2, fix, workspace) {
     await this.workspaceScript.lint(exec2, workspace, { fix });
@@ -11809,4 +12101,4 @@ class WorkspaceCommand extends command("workspace", [WorkspaceScript], ({ public
 }
 
 // pkgs/@akanjs/cli/index.ts
-runCommands(WorkspaceCommand, ApplicationCommand, LibraryCommand, PackageCommand, ModuleCommand, PageCommand, CloudCommand, GuidelineCommand, ScalarCommand);
+runCommands(WorkspaceCommand, ApplicationCommand, LibraryCommand, LocalRegistryCommand, PackageCommand, ModuleCommand, PageCommand, CloudCommand, GuidelineCommand, ScalarCommand);