@akanjs/cli 2.1.0-rc.9 → 2.1.1-rc.0

package/index.js

@@ -22,9 +22,12 @@ import { mkdir } from "fs/promises";
 var basePath = `${Bun.env.HOME ?? Bun.env.USERPROFILE}/.akan`;
 var configPath = `${basePath}/config.json`;
 var akanCloudHost = process.env.AKAN_PUBLIC_OPERATION_MODE === "local" ? "http://localhost" : "https://cloud.akanjs.com";
-var akanCloudUrl = `${akanCloudHost}${process.env.AKAN_PUBLIC_OPERATION_MODE === "local" ? ":8282" : ""}/\uBA54\u3151`;
+var akanCloudUrl = `${akanCloudHost}${process.env.AKAN_PUBLIC_OPERATION_MODE === "local" ? ":8282" : ""}/api`;
 var defaultHostConfig = {};
-var defaultAkanGlobalConfig = { cloudHost: {}, llm: null };
+var defaultAkanGlobalConfig = {
+  cloudHost: {},
+  llm: null
+};
 
 // pkgs/@akanjs/devkit/fileSys.ts
 import { stat } from "fs/promises";
@@ -484,7 +487,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 +707,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`);
@@ -2118,7 +2141,6 @@ class Executor {
     this.logger = new Logger4(name);
     this.logs = [];
     this.cwdPath = cwdPath;
-    //! TODO: 테스트 확인 필요
   }
   #stdout(data) {
     if (Executor.verbose)
@@ -3960,6 +3982,16 @@ function findRootBoundaries(pageKeys, appCwdPath, basePaths) {
   }
   return [...boundaries.values()].sort((a, b) => a.segments.join("/").localeCompare(b.segments.join("/")));
 }
+function hasAncestorRootBoundary(boundary, boundaries) {
+  return boundaries.some((candidate) => candidate !== boundary && candidate.segments.length < boundary.segments.length && candidate.segments.every((segment, index) => boundary.segments[index] === segment));
+}
+function findExplicitRootLayoutAbsPath(pageKeys, appCwdPath) {
+  const rootLayoutKey = pageKeys.find((key) => {
+    const segments = getRootBoundarySegments(key);
+    return segments !== null && segments.length === 0;
+  });
+  return rootLayoutKey ? path10.resolve(appCwdPath, "page", rootLayoutKey.replace(/^\.\//, "")) : null;
+}
 function routePrefixForSegments(segments) {
   const visible = segments.filter((segment) => !/^\(.+\)$/.test(segment));
   return visible[0] ?? null;
@@ -3976,21 +4008,27 @@ async function writeGeneratedRootLayoutFile(opts) {
   await mkdir3(path10.dirname(absPath), { recursive: true });
   const sourceRel = opts.boundary.sourceAbsPath ? path10.relative(path10.dirname(absPath), opts.boundary.sourceAbsPath).split(path10.sep).join("/") : null;
   const sourceSpecifier = sourceRel ? sourceRel.startsWith(".") ? sourceRel : `./${sourceRel}` : null;
+  const inheritedSourceAbsPath = opts.rootSourceAbsPath && opts.rootSourceAbsPath !== opts.boundary.sourceAbsPath ? opts.rootSourceAbsPath : null;
+  const inheritedSourceRel = inheritedSourceAbsPath ? path10.relative(path10.dirname(absPath), inheritedSourceAbsPath).split(path10.sep).join("/") : null;
+  const inheritedSourceSpecifier = inheritedSourceRel ? inheritedSourceRel.startsWith(".") ? inheritedSourceRel : `./${inheritedSourceRel}` : null;
   const clientImport = opts.includeStInit ? `import { st } from "@apps/${opts.appName}/client";
 void st;
 ` : `import "@apps/${opts.appName}/client";
+`;
+  const inheritedImport = inheritedSourceSpecifier ? `import * as inheritedLayout from ${JSON.stringify(inheritedSourceSpecifier)};
+` : `const inheritedLayout = {};
 `;
   const prefix = routePrefixForSegments(opts.boundary.segments);
   const userImport = sourceSpecifier ? `import UserLayout, * as userLayout from ${JSON.stringify(sourceSpecifier)};
 ` : `const UserLayout = ({ children }) => children;
 const userLayout = {};
 `;
-  const source = `import type { LayoutProps, PageProps } from "akanjs/client";
+  const source = opts.includeSystemProvider ? `import type { LayoutProps, PageProps } from "akanjs/client";
 import { loadFonts } from "akanjs/client";
 import { System } from "akanjs/ui";
 import { env } from "@apps/${opts.appName}/env/env.client";
-${clientImport}${userImport}
-const userFonts = userLayout.fonts ?? [];
+${clientImport}${inheritedImport}${userImport}
+const userFonts = userLayout.fonts ?? inheritedLayout.fonts ?? [];
 const defaultFonts = userFonts.filter((font) => font.default);
 if (defaultFonts.length > 1) throw new Error("[route-convention] only one default font is allowed per root layout");
 const defaultFont = defaultFonts[0];
@@ -3998,7 +4036,9 @@ const defaultFontClassName = defaultFont ? (defaultFont.className ?? \`font-\${d
 
 export async function generateHead(props: PageProps) {
   if (userLayout.generateHead) return userLayout.generateHead(props);
-  return userLayout.head;
+  if (userLayout.head !== undefined) return userLayout.head;
+  if (inheritedLayout.generateHead) return inheritedLayout.generateHead(props);
+  return inheritedLayout.head;
 }
 
 export default function GeneratedLayout({ children, params, searchParams }: LayoutProps) {
@@ -4008,19 +4048,31 @@ export default function GeneratedLayout({ children, params, searchParams }: Layo
       appName=${JSON.stringify(opts.appName)}
       ${prefix ? `prefix=${JSON.stringify(prefix)}
       ` : ""}params={params}
-      manifest={userLayout.manifest}
+      manifest={userLayout.manifest ?? inheritedLayout.manifest}
       env={env}
-      theme={userLayout.theme}
+      theme={userLayout.theme ?? inheritedLayout.theme}
       fonts={loadFonts(userFonts)}
       className={defaultFontClassName}
-      gaTrackingId={userLayout.gaTrackingId}
-      layoutStyle={userLayout.layoutStyle}
-      reconnect={userLayout.reconnect ?? false}
+      gaTrackingId={userLayout.gaTrackingId ?? inheritedLayout.gaTrackingId}
+      layoutStyle={userLayout.layoutStyle ?? inheritedLayout.layoutStyle}
+      reconnect={userLayout.reconnect ?? inheritedLayout.reconnect ?? false}
     >
       <UserLayout params={params} searchParams={searchParams}>{children}</UserLayout>
     </System.Provider>
   );
 }
+` : `import type { LayoutProps, PageProps } from "akanjs/client";
+${inheritedImport}${userImport}
+export async function generateHead(props: PageProps) {
+  if (userLayout.generateHead) return userLayout.generateHead(props);
+  if (userLayout.head !== undefined) return userLayout.head;
+  if (inheritedLayout.generateHead) return inheritedLayout.generateHead(props);
+  return inheritedLayout.head;
+}
+
+export default function GeneratedLayout({ children, params, searchParams }: LayoutProps) {
+  return <UserLayout params={params} searchParams={searchParams}>{children}</UserLayout>;
+}
 `;
   await Bun.write(absPath, source);
   return absPath;
@@ -4029,6 +4081,8 @@ async function resolveSsrPageEntries(opts) {
   const absPageDir = path10.resolve(opts.appCwdPath, "page");
   const hasSt = await appHasStModule(opts.appCwdPath);
   const basePaths = opts.basePaths ?? [];
+  const rootSourceAbsPath = findExplicitRootLayoutAbsPath(opts.pageKeys, opts.appCwdPath);
+  const rootBoundaries = findRootBoundaries(opts.pageKeys, opts.appCwdPath, basePaths);
   const rootLayoutKeys = new Set(opts.pageKeys.filter((key) => {
     const segments = getRootBoundarySegments(key);
     return segments !== null && isRootBoundarySegments(segments, basePaths);
@@ -4037,15 +4091,17 @@ async function resolveSsrPageEntries(opts) {
     key,
     moduleAbsPath: path10.resolve(absPageDir, key)
   }));
-  const generated = await Promise.all(findRootBoundaries(opts.pageKeys, opts.appCwdPath, basePaths).map(async (boundary) => ({
+  const generated = await Promise.all(rootBoundaries.map(async (boundary) => ({
     key: implicitRootLayoutKey(boundary.segments),
     moduleAbsPath: await writeGeneratedRootLayoutFile({
       appCwdPath: opts.appCwdPath,
       appName: opts.appName,
       boundary,
-      includeStInit: hasSt && boundary.segments.length === 0
+      rootSourceAbsPath,
+      includeStInit: hasSt && boundary.segments.length === 0,
+      includeSystemProvider: !hasAncestorRootBoundary(boundary, rootBoundaries)
     }),
-    seedAbsPaths: boundary.sourceAbsPath ? [boundary.sourceAbsPath] : []
+    seedAbsPaths: [...new Set([boundary.sourceAbsPath, rootSourceAbsPath].filter((absPath) => absPath !== null))]
   })));
   const entries = [...base, ...generated];
   entries.sort((a, b) => a.key.localeCompare(b.key));
@@ -7020,6 +7076,13 @@ function formatBytes(bytes) {
 }
 // pkgs/@akanjs/devkit/frontendBuild/ssrBaseArtifactBuilder.ts
 import path30 from "path";
+import { optimize } from "@tailwindcss/node";
+function prepareCssAsset(command, basePath2, cssText) {
+  if (command !== "build")
+    return cssText;
+  return optimize(cssText, { file: `${basePath2 || "root"}.css`, minify: true }).code;
+}
+
 class SsrBaseArtifactBuilder {
   #app;
   #command;
@@ -7111,14 +7174,15 @@ class SsrBaseArtifactBuilder {
   }
   async#writeCssAsset(basePath2, cssText) {
     const cssAssetName = basePath2 || "root";
+    const preparedCssText = await prepareCssAsset(this.#command, basePath2, cssText);
     const cssHash = Bun.hash(`${basePath2}
-${cssText}`).toString(36);
+${preparedCssText}`).toString(36);
     const [cssRelPath, cssUrl] = [
       `styles/${cssAssetName}-${cssHash}.css`,
       `/_akan/styles/${cssAssetName}-${cssHash}.css`
     ];
-    await Bun.write(path30.join(this.#absArtifactDir, cssRelPath), cssText);
-    this.#app.verbose(`[base-artifact] wrote ${cssText.length} bytes of CSS for ${basePath2} -> ${cssRelPath}`);
+    await Bun.write(path30.join(this.#absArtifactDir, cssRelPath), preparedCssText);
+    this.#app.verbose(`[base-artifact] wrote ${preparedCssText.length} bytes of CSS for ${basePath2} -> ${cssRelPath}`);
     return [basePath2, { cssUrl, cssRelPath }];
   }
 }
@@ -7166,9 +7230,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 +7311,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 +7335,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 +7683,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 +7724,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 +7739,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 +7770,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 +7783,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 +7839,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 +8033,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 +8052,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 +8116,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 +8159,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 +8188,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 +8205,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 +8226,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 +8245,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 +8259,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 +8444,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 +8944,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 +9220,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(/[^/\\]+$/, ""));
 };
@@ -9352,6 +9449,75 @@ import { Box as Box2, Newline, Text as Text2, useInput as useInput2 } from "ink"
 import { useEffect as useEffect3, useState as useState3 } from "react";
 import { jsxDEV as jsxDEV2, Fragment as Fragment2 } from "react/jsx-dev-runtime";
 "use client";
+// pkgs/@akanjs/devkit/cloud/cloudApi.ts
+class HttpClient2 {
+  baseUrl;
+  constructor(baseUrl) {
+    this.baseUrl = baseUrl;
+  }
+  async get(url, { headers } = {}) {
+    const response = await fetch(`${this.baseUrl}${url}`, {
+      headers: { "Content-Type": "application/json", ...headers }
+    });
+    return response.json();
+  }
+  async post(url, data, { headers } = {}) {
+    const isFormData = data instanceof FormData;
+    const response = await fetch(`${this.baseUrl}${url}`, {
+      method: "POST",
+      body: isFormData ? data : JSON.stringify(data),
+      headers: isFormData ? headers : { "Content-Type": "application/json", ...headers }
+    });
+    return response.json();
+  }
+}
+
+class CloudApi {
+  api;
+  #accessToken = null;
+  constructor(host, { accessToken } = {}) {
+    this.api = new HttpClient2(`${host}/api`);
+    this.#accessToken = accessToken ?? null;
+  }
+  async uploadEnv(devProjectId, fileStream) {
+    const formData = new FormData;
+    formData.append("devProjectId", devProjectId);
+    formData.append("fileStream", await new Response(fileStream).blob());
+    const response = await this.api.post(`/uploadEnv/${devProjectId}`, formData);
+    return response.success;
+  }
+  async downloadEnv(devProjectId) {
+    const response = await this.api.get(`/downloadEnv/${devProjectId}`);
+    return response.success;
+  }
+  async getRemoteAuthToken(remoteId) {
+    if (this.#needRefreshToken())
+      return await this.refreshAuthToken();
+    else if (this.#accessToken)
+      return this.#accessToken;
+    const accessToken = await this.api.get(`/getRemoteAuthToken/${remoteId}`);
+    this.#accessToken = {
+      jwt: accessToken.jwt,
+      refreshToken: accessToken.refreshToken,
+      expiresAt: new Date(accessToken.expiresAt)
+    };
+    return accessToken;
+  }
+  async refreshAuthToken() {
+    const response = await this.api.post(`/refreshRemoteAuthToken`, {
+      refreshToken: this.#accessToken?.refreshToken
+    });
+    this.#accessToken = {
+      jwt: response.jwt,
+      refreshToken: response.refreshToken,
+      expiresAt: new Date(response.expiresAt)
+    };
+    return response;
+  }
+  #needRefreshToken() {
+    return !!(this.#accessToken?.expiresAt && this.#accessToken.expiresAt.getTime() < Date.now() - 1000 * 60 * 60);
+  }
+}
 // pkgs/@akanjs/cli/application/application.command.ts
 import { select as select6 } from "@inquirer/prompts";
 
@@ -9469,7 +9635,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 +9700,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 +10006,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`);
@@ -10181,6 +10351,10 @@ class PackageRunner extends runner("package") {
         pkg.generateTsconfigJson()
       ]);
     }
+    await this.#copyPackageReadmes(pkg);
+  }
+  async#copyPackageReadmes(pkg) {
+    await Promise.all(["README.md", "README.ko.md"].map((fileName) => pkg.cp(fileName, `${pkg.dist.cwdPath}/${fileName}`)));
   }
   async updateWorskpaceRootPackageJson(workspace, rootPackageJson) {
     const templatePath = "pkgs/@akanjs/cli/templates/workspaceRoot/package.json.template";
@@ -10229,17 +10403,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 +10427,29 @@ 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 +10528,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 +10550,59 @@ ${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("bun", ["update", "-g", "akanjs", "--latest", `--tag=${tag}`]);
+      await workspace.spawn("bun", ["update", "-g", "akanjs", "--latest", `--tag=${tag}`, ...registryArgs], { env });
     else
       await Promise.all([
-        workspace.spawn("bun", ["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");
@@ -10390,13 +10614,51 @@ ${chalk7.green("\u27A4")} Authentication Required`));
       rootPackageJson.dependencies["@akanjs/devkit"] = latestPublishedVersion;
     if (rootPackageJson.devDependencies?.["@akanjs/devkit"])
       rootPackageJson.devDependencies["@akanjs/devkit"] = latestPublishedVersion;
-    workspace.setPackageJson(rootPackageJson);
-    await workspace.spawn("bun", ["install"]);
+    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;
+  }
+  async downloadEnv(workspace) {
+    const repoName = workspace.repoName;
+    const config = await getHostConfig();
+    const self = config.auth ? await getSelf(config.auth.token) : null;
+    if (!self)
+      throw new Error("Not logged in");
+    const res = await fetch(`${akanCloudUrl}/api/akasys/akasys/${repoName}`, {
+      headers: { Authorization: `Bearer ${config.auth?.token}` }
+    });
+    const env = await res.json();
+    Logger15.info(`Downloading environment variables from cloud...`);
+    Logger15.info(`Environment variables: ${JSON.stringify(env.env, null, 2)}`);
+  }
+  async uploadEnv(workspace) {}
 }
 
 // pkgs/@akanjs/cli/cloud/cloud.script.ts
-class CloudScript extends script("cloud", [CloudRunner, ApplicationScript, PackageScript]) {
+class CloudScript extends script("cloud", [
+  CloudRunner,
+  ApplicationScript,
+  PackageScript
+]) {
   async login(workspace) {
     await this.cloudRunner.login();
   }
@@ -10413,7 +10675,13 @@ 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 downloadEnv(workspace) {
+    await this.cloudRunner.downloadEnv(workspace);
+  }
+  async uploadEnv(workspace) {
+    await this.cloudRunner.uploadEnv(workspace);
+  }
+  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));
@@ -10422,11 +10690,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" });
@@ -10434,6 +10702,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);
@@ -10450,15 +10721,43 @@ 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)
+    });
+  }),
+  downloadEnv: target({ desc: "Download environment variables from cloud" }).with(Workspace).exec(async function(workspace) {
+    await this.cloudScript.downloadEnv(workspace);
+  }),
+  uploadEnv: target({ desc: "Upload environment variables to cloud" }).with(Workspace).exec(async function(workspace) {
+    await this.cloudScript.uploadEnv(workspace);
   })
 })) {
 }
@@ -10479,19 +10778,19 @@ class GuidelinePrompt extends Prompter {
       return page;
     if (page.endsWith(".tsx"))
       return page;
-    return `apps/angelo/page${page}`;
+    return `apps/akan/page${page}`;
   }
   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;
   }
@@ -10786,6 +11085,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";
 
@@ -11581,11 +12021,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",
@@ -11605,20 +12045,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 [latestBiomeVersion, latestTypesBunVersion] = await Promise.all([
-      getLatestPackageVersion("@biomejs/biome"),
-      getLatestPackageVersion("@types/bun")
+      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(),
@@ -11659,9 +12108,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));
@@ -11677,9 +12126,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));
@@ -11693,13 +12142,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;
@@ -11723,12 +12172,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");
@@ -11742,11 +12197,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 } = {}) {
@@ -11801,9 +12256,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 });
@@ -11818,4 +12276,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);