layero 0.5.4 → 0.6.0

package/README.md

@@ -59,8 +59,17 @@ Run `layero <cmd> --help` for full options.
 
 ## `layero deploy` flags
 
-- `--type <preset>` — framework override: `vite`, `next`, `astro`, `cra`,
-  `sveltekit`, `nuxt`, `gatsby`, `docusaurus`, `static`. **Optional** — auto-detected from `package.json` and config files when omitted.
+- `--type <preset>` — framework override: `vite`, `vitepress`, `next`,
+  `astro`, `cra`, `sveltekit`, `nuxt`, `gatsby`, `docusaurus`, `eleventy`
+  (alias `11ty`), `hugo`, `static`. **Optional** — auto-detected from
+  `package.json` and config files when omitted.
+- `--prebuilt [dir]` — ship an already-built artifact instead of building
+  remotely. Without an argument, picks the first existing of
+  `dist/`, `build/`, `public/`, `out/`, `_site/`, `.output/public/`,
+  `docs/.vitepress/dist/`, `.vitepress/dist/`. With `--prebuilt ./my-out`
+  uses that explicit path. Use this for CI flows that build in the
+  pipeline, Webflow / Framer exports, or whenever you don't want the
+  platform to run install/build for you.
 - `--name <name>` — project name (only on first deploy).
 - `--project <id_or_slug>` — deploy into an existing project, ignoring
   `./.layero/project.json` (useful for CI).
@@ -82,10 +91,33 @@ Run `layero <cmd> --help` for full options.
 | `gatsby` dep | gatsby | `npm run build` | `public` |
 | `astro` dep / `astro.config.*` | astro | `npm run build` | `dist` |
 | `@docusaurus/core` dep / `docusaurus.config.*` | docusaurus | `npm run build` | `build` |
+| `vitepress` dep / `.vitepress/config.*` / `docs/.vitepress/config.*` | vitepress | `npm run docs:build` (or `npx vitepress build`) | `.vitepress/dist` or `docs/.vitepress/dist` |
 | `vite` dep / `vite.config.*` | vite | `npm run build` | `dist` |
 | `react-scripts` dep | cra | `npm run build` | `build` |
+| `@11ty/eleventy` dep / `.eleventy.js` / `eleventy.config.*` | eleventy | `npm run build` (or `npx @11ty/eleventy`) | `_site` |
+| `hugo.{toml,yaml,json}` or `config.*` with Hugo markers (`baseURL`, `[markup]`, …) | hugo | `hugo --gc --minify` (no install needed) | `public` |
 | any `.html` at root, no `package.json` | static | `true` (no-op) | `.` |
 
+## Bring-your-own-build (`--prebuilt`)
+
+If you already build your site yourself — in CI, via a desktop tool like
+Webflow/Framer, or because you want a guaranteed deterministic artifact —
+skip the platform's install/build entirely:
+
+```bash
+# Auto-pick the output directory:
+layero deploy --prebuilt
+
+# Or point at a specific one:
+layero deploy --prebuilt ./dist
+layero deploy --prebuilt ./build/static
+```
+
+What changes: only the files inside the directory you point at are
+uploaded (no source-tree filters like `.gitignore` apply). The platform
+ships them verbatim — no detect, no install, no build. Smaller archive,
+faster deploys, no surprises from the platform's package-manager defaults.
+
 Override anything by editing `.layero/project.json` after the first `layero init`.
 
 ## Agent / JSON mode

package/dist/agent.js

@@ -109,6 +109,9 @@ function renderHuman(event) {
         case "detected":
             process.stdout.write(`→ Detected ${event.framework} (build: ${event.build_cmd}, output: ${event.output_dir})\n`);
             break;
+        case "prebuilt":
+            process.stdout.write(`→ Prebuilt mode: shipping ${event.dir}\n`);
+            break;
         case "packing":
             process.stdout.write(`→ Packed ${event.files} files (${(event.bytes / (1024 * 1024)).toFixed(2)} MB)\n`);
             break;

package/dist/bin/layero.js

@@ -104,11 +104,12 @@ async function main() {
     program
         .command("deploy")
         .description("Pack the current directory and deploy it. Framework, build command and output directory are auto-detected.")
-        .option("-t, --type <preset>", "framework override (vite | next | astro | cra | sveltekit | nuxt | gatsby | docusaurus | static)")
+        .option("-t, --type <preset>", "framework override (vite | vitepress | next | astro | cra | sveltekit | nuxt | gatsby | docusaurus | eleventy | hugo | static)")
         .option("--name <name>", "project name (only used on first deploy)")
         .option("--project <id_or_slug>", "deploy into an existing project, ignoring local config")
         .option("-y, --yes", "non-interactive: accept defaults and skip --prod confirmation")
         .option("--config", "(legacy alias of the default behaviour — auto-detect + .layero/project.json values)")
+        .option("--prebuilt [dir]", "ship an already-built artifact directory (default auto-pick: dist/build/public/out/_site/...)")
         .option("--prod", "deploy to production (replaces apex_hostname's active deploy). Without this flag, deploys go to the project's CLI preview pseudo-branch.")
         .option("--branch <name>", "deploy to a specific branch's environment. Wins over --prod.")
         .option("--org <slug>", "Layero organization slug for first-time project creation. Defaults to personal; required when you're a member of multiple orgs and want a non-personal home.")

package/dist/commands/deploy.js

@@ -5,7 +5,7 @@ import chalk from "chalk";
 import { ApiClient, ApiError, uploadArchive } from "../api.js";
 import { loadConfig } from "../config.js";
 import { loadProjectConfig, persistProjectLinking, projectConfigPath, } from "../project-config.js";
-import { packCwd } from "../pack.js";
+import { packCwd, packDirectory } from "../pack.js";
 import { streamDeployLogs } from "../logs.js";
 import { detectProject } from "../detect.js";
 import { LayeroError, detectMode, emit } from "../agent.js";
@@ -22,6 +22,10 @@ const VALID_TYPES = new Set([
     "static",
     "generic",
     "docusaurus",
+    "hugo",
+    "eleventy",
+    "11ty",
+    "vitepress",
 ]);
 function dashboardOrigin(apiUrl) {
     const override = process.env.LAYERO_DASHBOARD_URL;
@@ -144,13 +148,16 @@ async function resolveOrCreateProject(api, cwd, opts, existing) {
     });
     return { project, createdNow: true };
 }
-async function packAndUpload(api, cwd, project) {
-    const pack = await packCwd(cwd, project.slug);
+async function packAndUpload(api, cwd, project, prebuiltDir) {
+    const pack = prebuiltDir
+        ? await packDirectory(path.resolve(cwd, prebuiltDir), project.slug)
+        : await packCwd(cwd, project.slug);
     emit({
         event: "packing",
         files: pack.fileCount,
         bytes: pack.size,
         sha256: pack.sha256,
+        ...(prebuiltDir ? { prebuilt_dir: prebuiltDir } : {}),
     });
     const init = await api.initUpload(project.id);
     emit({ event: "uploading" });
@@ -162,6 +169,35 @@ async function packAndUpload(api, cwd, project) {
         archivePath: pack.archivePath,
     };
 }
+const PREBUILT_AUTO_DIRS = [
+    "dist",
+    "build",
+    "public",
+    "out",
+    "_site",
+    ".output/public",
+    "docs/.vitepress/dist",
+    ".vitepress/dist",
+];
+async function resolvePrebuiltDir(cwd, raw) {
+    if (raw === undefined || raw === false)
+        return null;
+    if (typeof raw === "string" && raw.length > 0) {
+        return raw;
+    }
+    // No explicit dir — pick the first existing common output directory.
+    for (const candidate of PREBUILT_AUTO_DIRS) {
+        try {
+            const stat = await fs.stat(path.join(cwd, candidate));
+            if (stat.isDirectory())
+                return candidate;
+        }
+        catch {
+            // try next
+        }
+    }
+    throw new LayeroError("prebuilt_no_dir", "could not auto-detect a built artifact directory", `pass it explicitly: --prebuilt ./dist  (tried: ${PREBUILT_AUTO_DIRS.join(", ")})`);
+}
 // Resolve the framework / build / output config to send to completeSetup.
 // Precedence: explicit CLI args > .layero/project.json > auto-detect.
 async function resolveSetupConfig(cwd, opts, existing) {
@@ -213,9 +249,24 @@ export async function deployCmd(opts) {
             return;
         }
     }
+    // Prebuilt deploys: caller has already built the artifact and points at
+    // its directory. Setup-config detection is skipped (we report a synthetic
+    // static setup so completeSetup gets *some* values and the dashboard
+    // shows the project is configured).
+    const prebuiltDir = await resolvePrebuiltDir(cwd, opts.prebuilt);
     // Resolve setup config (auto-detect + overrides). Done eagerly so the
     // user sees what we detected before any network I/O.
-    const setup = await resolveSetupConfig(cwd, opts, existing);
+    const setup = prebuiltDir
+        ? {
+            framework_hint: "static",
+            build_cmd: "true",
+            output_dir: ".",
+            source: "prebuilt",
+        }
+        : await resolveSetupConfig(cwd, opts, existing);
+    if (prebuiltDir) {
+        emit({ event: "prebuilt", dir: prebuiltDir });
+    }
     const persistedCfg = await persistProjectLinking(cwd, {
         project_id: project.id,
         slug: project.slug,
@@ -252,15 +303,16 @@ export async function deployCmd(opts) {
     }
     let upload = null;
     try {
-        upload = await packAndUpload(api, cwd, project);
+        upload = await packAndUpload(api, cwd, project, prebuiltDir);
         const targeting = deployTargeting(opts);
         const deploy = await api.triggerDeploy(project.id, {
             source_archive_key: upload.archive_key,
             commit_sha: upload.commit_sha,
-            commit_message: "CLI deploy",
+            commit_message: prebuiltDir ? `CLI prebuilt deploy (${prebuiltDir})` : "CLI deploy",
             framework_hint: setup.framework_hint,
             target: targeting.target,
             branch: targeting.branch,
+            prebuilt: prebuiltDir !== null,
         });
         emit({ event: "deploy_started", deploy_id: deploy.id });
         const final = await streamDeployLogs(api, deploy.id);

package/dist/detect.js

@@ -115,6 +115,23 @@ export async function detectProject(cwd) {
                 confident: true,
             };
         }
+        // VitePress before generic Vite: VitePress repos often pull `vite`
+        // transitively, and the SPA Vite path would set output_dir=dist —
+        // wrong for VitePress, which writes to `.vitepress/dist/` (or
+        // `docs/.vitepress/dist/` when the config lives under docs/).
+        if (hasDep(pkg, "vitepress") || (await hasVitepressConfig(cwd))) {
+            const docsLayout = await hasVitepressConfig(cwd, "docs/.vitepress");
+            const outputDir = docsLayout ? "docs/.vitepress/dist" : ".vitepress/dist";
+            const cmd = pkg.scripts?.["docs:build"]
+                ? "npm run docs:build"
+                : buildCmd(pkg, "npx vitepress build");
+            return {
+                framework_hint: "vitepress",
+                build_cmd: cmd,
+                output_dir: outputDir,
+                confident: true,
+            };
+        }
         if (hasDep(pkg, "vite") || (await fileExists(cwd, "vite.config.ts", "vite.config.js", "vite.config.mjs"))) {
             return {
                 framework_hint: "vite",
@@ -131,6 +148,35 @@ export async function detectProject(cwd) {
                 confident: true,
             };
         }
+        // Eleventy late in the package.json branch — `@11ty/eleventy` is
+        // unique enough not to collide with other frameworks, but Vite /
+        // CRA / etc. should win if both are present (a project that pulls
+        // both is probably using Vite as the runtime and 11ty just for one
+        // build step).
+        if (hasDep(pkg, "@11ty/eleventy") ||
+            hasDep(pkg, "eleventy") ||
+            (await fileExists(cwd, ".eleventy.js", "eleventy.config.js", "eleventy.config.mjs", "eleventy.config.cjs"))) {
+            return {
+                framework_hint: "eleventy",
+                build_cmd: buildCmd(pkg, "npx @11ty/eleventy"),
+                output_dir: "_site",
+                confident: true,
+            };
+        }
+    }
+    // Non-Node SSGs (Hugo today). Recognise repos without package.json
+    // before we fall back to "static" with a no-op build command — Hugo
+    // needs `hugo --gc --minify` and writes to `public/`, the static
+    // fallback would just upload the raw .md sources.
+    if ((await fileExists(cwd, "hugo.toml", "hugo.yaml", "hugo.json")) ||
+        ((await fileExists(cwd, "config.toml", "config.yaml", "config.json")) &&
+            (await hasHugoConfigMarker(cwd)))) {
+        return {
+            framework_hint: "hugo",
+            build_cmd: "hugo --gc --minify",
+            output_dir: "public",
+            confident: true,
+        };
     }
     // No (or unrecognised) package.json. If there's HTML on disk we treat
     // the current directory as a static site. Otherwise we still fall back
@@ -144,3 +190,41 @@ export async function detectProject(cwd) {
         confident: _staticHtml,
     };
 }
+const HUGO_CONFIG_TOKENS = [
+    "baseURL",
+    "baseurl",
+    "languageCode",
+    "languagecode",
+    "[params]",
+    "[markup]",
+    "[menu",
+    "[taxonomies]",
+    "hugoVersion",
+    "minVersion",
+    "theme",
+];
+async function hasVitepressConfig(cwd, prefix = ".vitepress") {
+    for (const name of ["config.ts", "config.js", "config.mts", "config.mjs"]) {
+        try {
+            await fs.access(path.join(cwd, prefix, name));
+            return true;
+        }
+        catch {
+            // try next
+        }
+    }
+    return false;
+}
+async function hasHugoConfigMarker(cwd) {
+    for (const fn of ["config.toml", "config.yaml", "config.json"]) {
+        try {
+            const head = await fs.readFile(path.join(cwd, fn), "utf-8");
+            if (HUGO_CONFIG_TOKENS.some((t) => head.includes(t)))
+                return true;
+        }
+        catch {
+            // try next
+        }
+    }
+    return false;
+}

package/dist/pack.js

@@ -80,6 +80,58 @@ async function sha256OfFile(p) {
     }
     return hash.digest("hex");
 }
+/** Pack only the contents of an already-built artifact directory.
+ *
+ * Used by `layero deploy --prebuilt`. We deliberately bypass DEFAULT_IGNORE
+ * (no `dist`/`build`/`.next` filtering — those names might appear *inside*
+ * a built artifact and they're now meaningful files, not source-tree
+ * leftovers). We still apply a minimal safety filter so accidental clutter
+ * doesn't blow up the archive: `.git/`, `node_modules/`, `.DS_Store`,
+ * `.env*`. The caller resolves the directory; the archive's internal layout
+ * is content-only (no source-tree prefix).
+ */
+export async function packDirectory(targetDir, projectName) {
+    const stat = await fs.stat(targetDir);
+    if (!stat.isDirectory()) {
+        throw new Error(`prebuilt path is not a directory: ${targetDir}`);
+    }
+    const minimalIgnore = ignore();
+    minimalIgnore.add([
+        "node_modules",
+        ".git",
+        ".svn",
+        ".hg",
+        ".env",
+        ".env.*",
+        "*.log",
+        ".DS_Store",
+        "Thumbs.db",
+        ".layero",
+    ]);
+    const files = await walk(targetDir, minimalIgnore);
+    if (files.length === 0) {
+        throw new Error(`no files to upload in ${targetDir} — check that the build produced output`);
+    }
+    const stamp = Date.now();
+    const safeName = projectName.replace(/[^a-zA-Z0-9._-]/g, "_");
+    const archivePath = path.join(tmpdir(), `layero-${safeName}-prebuilt-${stamp}.tgz`);
+    const rootName = `layero-${safeName}-prebuilt-${stamp}`;
+    await tarCreate({
+        file: archivePath,
+        gzip: { level: 6 },
+        cwd: targetDir,
+        portable: true,
+        prefix: rootName,
+    }, files);
+    const fst = await fs.stat(archivePath);
+    if (fst.size > MAX_BYTES) {
+        await fs.unlink(archivePath).catch(() => undefined);
+        throw new Error(`archive is ${(fst.size / (1024 * 1024)).toFixed(1)}MB — over the 200MB limit. ` +
+            "Trim the build output or skip large files (`.layeroignore`).");
+    }
+    const sha256 = await sha256OfFile(archivePath);
+    return { archivePath, sha256, size: fst.size, fileCount: files.length };
+}
 export async function packCwd(cwd, projectName) {
     const ig = await buildIgnore(cwd);
     const files = await walk(cwd, ig);

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "layero",
-  "version": "0.5.4",
+  "version": "0.6.0",
   "description": "Layero CLI — publish a local site with one command. No git, no GitHub, agent-friendly (Cursor, Claude Code).",
   "license": "MIT",
   "type": "module",