@akanjs/cli 2.1.0 → 2.1.1-rc.0

package/incrementalBuilder.proc.js

@@ -24,9 +24,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";
@@ -2140,7 +2143,6 @@ class Executor {
     this.logger = new Logger4(name);
     this.logs = [];
     this.cwdPath = cwdPath;
-    //! TODO: 테스트 확인 필요
   }
   #stdout(data) {
     if (Executor.verbose)
@@ -3982,6 +3984,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;
@@ -3998,21 +4010,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];
@@ -4020,7 +4038,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) {
@@ -4030,19 +4050,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;
@@ -4051,6 +4083,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);
@@ -4059,15 +4093,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));
@@ -7042,6 +7078,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;
@@ -7133,14 +7176,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 }];
   }
 }
@@ -9407,6 +9451,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/devkit/incrementalBuilder/incrementalBuilder.proc.ts
 import { Logger as Logger12 } from "akanjs/common";
 

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";
@@ -2138,7 +2141,6 @@ class Executor {
     this.logger = new Logger4(name);
     this.logs = [];
     this.cwdPath = cwdPath;
-    //! TODO: 테스트 확인 필요
   }
   #stdout(data) {
     if (Executor.verbose)
@@ -3980,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;
@@ -3996,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];
@@ -4018,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) {
@@ -4028,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;
@@ -4049,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);
@@ -4057,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));
@@ -7040,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;
@@ -7131,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 }];
   }
 }
@@ -9405,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";
 
@@ -10238,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";
@@ -10310,7 +10427,12 @@ async function getLatestPackageVersion(packageName, tag = "latest", registryUrl)
 
 // pkgs/@akanjs/cli/cloud/cloud.runner.ts
 class CloudRunner extends runner("cloud") {
-  #akanFrameworkPackages = new Set(["akanjs", "@akanjs/devkit", "@akanjs/cli", "create-akan-workspace"]);
+  #akanFrameworkPackages = new Set([
+    "akanjs",
+    "@akanjs/devkit",
+    "@akanjs/cli",
+    "create-akan-workspace"
+  ]);
   #getRegistryArgs(registryUrl) {
     return registryUrl ? ["--registry", getNpmRegistryUrl(registryUrl)] : [];
   }
@@ -10445,7 +10567,13 @@ ${chalk7.green("\u27A4")} Authentication Required`));
     }
     await Promise.all(akanPkgs.map(async (library) => {
       Logger15.info(`Publishing ${library}@${nextVersion} to ${registry ?? "npm"}...`);
-      await workspace.spawn("npm", ["publish", "--tag", tag, ...this.#getRegistryArgs(registry), ...this.#getLocalRegistryAuthArgs(registry)], {
+      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"
@@ -10462,7 +10590,14 @@ ${chalk7.green("\u27A4")} Authentication Required`));
       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}`, ...registryArgs], { env }),
+        workspace.spawn("bun", [
+          "update",
+          "-g",
+          "akanjs",
+          "--latest",
+          `--tag=${tag}`,
+          ...registryArgs
+        ], { env }),
         this.#updateAkanPkgs(workspace, tag, registry)
       ]);
   }
@@ -10486,7 +10621,12 @@ ${chalk7.green("\u27A4")} Authentication Required`));
   }
   #normalizeAkanPackageJson(packageJson, packageName, version) {
     const normalized = { ...packageJson, version };
-    for (const field of ["dependencies", "devDependencies", "peerDependencies", "optionalDependencies"]) {
+    for (const field of [
+      "dependencies",
+      "devDependencies",
+      "peerDependencies",
+      "optionalDependencies"
+    ]) {
       const dependencies = normalized[field];
       if (!dependencies)
         continue;
@@ -10497,10 +10637,28 @@ ${chalk7.green("\u27A4")} Authentication Required`));
     }
     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();
   }
@@ -10517,6 +10675,12 @@ class CloudScript extends script("cloud", [CloudRunner, ApplicationScript, Packa
     const session = new AiSession("general", { workspace, isContinued: true });
     await session.ask(question);
   }
+  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);
@@ -10557,7 +10721,10 @@ 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 }).option("registry", String, {
+  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: [
@@ -10582,7 +10749,15 @@ class CloudCommand extends command("cloud", [CloudScript], ({ public: target })
       { label: "local", value: "local" }
     ]
   }).exec(async function(workspace, tag, registry) {
-    await this.cloudScript.update(workspace, tag, { registryUrl: resolveRegistryUrl(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);
   })
 })) {
 }
@@ -10603,7 +10778,7 @@ 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);

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@akanjs/cli",
-  "version": "2.1.0",
+  "version": "2.1.1-rc.0",
   "sourceType": "module",
   "type": "module",
   "publishConfig": {
@@ -33,8 +33,9 @@
     "@langchain/core": "^1.1.47",
     "@langchain/deepseek": "^1.0.26",
     "@langchain/openai": "^1.4.6",
+    "@tailwindcss/node": "^4.3.0",
     "@trapezedev/project": "^7.1.4",
-    "akanjs": "2.1.0",
+    "akanjs": "2.1.1-rc.0",
     "chalk": "^5.6.2",
     "commander": "^14.0.3",
     "daisyui": "^5.5.20",