create-skybridge 0.0.0-dev.b9f65be → 0.0.0-dev.b9f85b3

package/dist/index.js

@@ -1,4 +1,5 @@
 import fs from "node:fs";
+import os from "node:os";
 import path from "node:path";
 import { fileURLToPath } from "node:url";
 import * as prompts from "@clack/prompts";
@@ -7,7 +8,9 @@ import mri from "mri";
 const OUTPUT_TAIL_LINES = 10;
 const DEFAULT_PROJECT_NAME = "skybridge-project";
 const PACKAGE_MANAGERS = ["bun", "deno", "npm", "pnpm", "yarn"];
-const TEMPLATES = ["demo", "blank"];
+const TEMPLATES = ["demo", "blank", "ecom"];
+const REPO = "alpic-ai/skybridge";
+const REPO_REF = "main";
 const pkg = JSON.parse(fs.readFileSync(fileURLToPath(new URL("../package.json", import.meta.url)), "utf-8"));
 const version = pkg.version;
 const HELP_MESSAGE = `Usage: skybridge create [path] [options]
@@ -18,13 +21,15 @@ Arguments:
   path           Where the project will be created. Prompted when omitted.
 
 Options:
-  --blank        scaffold a minimal project without demo tools and views
-  --overwrite    remove existing files if target directory is not empty
-  --pm <choice>  package manager to use (choices: ${PACKAGE_MANAGERS.join(", ")}. default to npm when none is provided or infered)
-  --skip-skills  skip installing coding agent skills
-  --start        start dev server
-  --yes          skip prompts and use default values for unprovided options
-  --help         display this help message
+  --blank           scaffold a minimal project without demo tools and views
+  --ecom            scaffold the ecommerce template (search products, render carousel)
+  --example <name>  scaffold a copy of github.com/${REPO}/tree/${REPO_REF}/examples/<name>
+  --overwrite       remove existing files if target directory is not empty
+  --pm <choice>     package manager to use (choices: ${PACKAGE_MANAGERS.join(", ")}. default to npm when none is provided or infered)
+  --skip-skills     skip installing coding agent skills
+  --start           start dev server
+  --yes             skip prompts and use default values for unprovided options
+  --help            display this help message
 
 Non-interactive usage:
   Mandatory: path argument and --yes option
@@ -60,8 +65,16 @@ const Spinner = {
 };
 export async function init(args = process.argv.slice(2)) {
     const argv = mri(args, {
-        boolean: ["help", "blank", "overwrite", "skip-skills", "start", "yes"],
-        string: ["pm"],
+        boolean: [
+            "help",
+            "blank",
+            "ecom",
+            "overwrite",
+            "skip-skills",
+            "start",
+            "yes",
+        ],
+        string: ["pm", "example"],
         alias: { h: "help" },
     });
     if (argv.help) {
@@ -73,6 +86,13 @@ export async function init(args = process.argv.slice(2)) {
     if (yes && !targetDir) {
         abort("The target directory is required in non-interactive mode.", "Example: skybridge create my-app --yes");
     }
+    if (argv.example !== undefined && !/^[\w.-]+$/.test(argv.example)) {
+        abort("--example requires a name, e.g. --example auth-descope.");
+    }
+    if (argv.example && (argv.blank || argv.ecom)) {
+        abort("Cannot combine --example with --blank or --ecom.");
+    }
+    const example = argv.example;
     let pm = parsePackageManager(argv.pm || "");
     if (argv.pm && !pm) {
         abort(`Invalid --pm value "${argv.pm}". Expected one of: ${PACKAGE_MANAGERS.join(", ")}.`);
@@ -95,6 +115,18 @@ export async function init(args = process.argv.slice(2)) {
         targetDir = sanitizeTargetDir(choice);
     }
     // 2. Existing-directory handling
+    let downloaded;
+    if (example) {
+        Spinner.start(`Downloading ${example} example`);
+        try {
+            downloaded = await downloadExample(example);
+            Spinner.stop(`Downloaded ${example} example`);
+        }
+        catch (error) {
+            Spinner.error(`Failed to download ${example} example`);
+            abort(error instanceof Error ? error.message : String(error));
+        }
+    }
     if (fs.existsSync(targetDir) && !isEmpty(targetDir)) {
         if (argv.overwrite) {
             emptyDir(targetDir);
@@ -121,50 +153,71 @@ export async function init(args = process.argv.slice(2)) {
     if (argv.blank) {
         template = "blank";
     }
-    else if (yes) {
-        template = "demo";
+    if (argv.ecom) {
+        if (template) {
+            abort("Cannot specify both --blank and --ecom.");
+        }
+        template = "ecom";
     }
-    else {
-        const choice = await prompts.select({
-            message: "Choose a template:",
-            options: [
-                {
-                    value: "demo",
-                    label: "demo",
-                    hint: "starter code with tools and UI",
-                },
-                {
-                    value: "blank",
-                    label: "blank",
-                    hint: "minimal boilerplate without tools",
-                },
-            ],
-            initialValue: "demo",
-        });
-        if (prompts.isCancel(choice)) {
-            return cancel();
+    if (!template && !example) {
+        if (yes) {
+            template = "demo";
+        }
+        else {
+            const choice = await prompts.select({
+                message: "Choose a template:",
+                options: [
+                    {
+                        value: "demo",
+                        label: "demo",
+                        hint: "starter code with tools and UI",
+                    },
+                    {
+                        value: "blank",
+                        label: "blank",
+                        hint: "minimal boilerplate without tools",
+                    },
+                    {
+                        value: "ecom",
+                        label: "ecom",
+                        hint: "ecommerce template with product search tool and carousel view",
+                    },
+                ],
+                initialValue: "demo",
+            });
+            if (prompts.isCancel(choice)) {
+                return cancel();
+            }
+            template = choice;
         }
-        template = choice;
     }
     // 4. Copy template
     const root = path.resolve(targetDir);
-    Spinner.start(`Copying ${template} template`);
+    const templatesDir = fileURLToPath(new URL("../templates", import.meta.url));
+    const source = downloaded?.source ?? path.join(templatesDir, template ?? "demo");
+    Spinner.start(`Copying ${example ?? template} template`);
     try {
-        const templateDir = fileURLToPath(new URL(`../templates/${template}`, import.meta.url));
-        fs.cpSync(templateDir, root, {
+        fs.cpSync(source, root, {
             recursive: true,
             filter: (src) => [".npmrc"].every((file) => !src.endsWith(file)),
         });
+        const gitignore = path.join(root, ".gitignore");
         const gitignoreSource = path.join(root, "_gitignore");
         if (fs.existsSync(gitignoreSource)) {
-            fs.renameSync(gitignoreSource, path.join(root, ".gitignore"));
+            fs.renameSync(gitignoreSource, gitignore);
+        }
+        else if (!fs.existsSync(gitignore)) {
+            fs.copyFileSync(path.join(templatesDir, "demo", "_gitignore"), gitignore);
         }
-        Spinner.stop(`Copied ${template} template`);
+        Spinner.stop(`Copied ${example ?? template} template`);
     }
     catch (error) {
         Spinner.error("Failed to copy template");
         abort(String(error));
     }
+    finally {
+        downloaded?.cleanup();
+    }
     // 5. Set package.json name to the project dir basename
     try {
         const pkgPath = path.join(root, "package.json");
@@ -270,7 +323,11 @@ export async function init(args = process.argv.slice(2)) {
         }
         pm = choice;
     }
-    // 8. Always install dependencies
+    // 8. pnpm ≥10 fails installs unless esbuild's build script is allow-listed
+    if (pm === "pnpm") {
+        fs.writeFileSync(path.join(root, "pnpm-workspace.yaml"), 'packages:\n  - "."\nonlyBuiltDependencies:\n  - esbuild\nallowBuilds:\n  esbuild: true\n');
+    }
+    // 9. Always install dependencies
     Spinner.start(`Installing dependencies with ${pm}`);
     const { status, output } = await spawnAsync(pm, ["install"]);
     if (status === 0) {
@@ -281,7 +338,7 @@ export async function init(args = process.argv.slice(2)) {
 \x1b[2m${output}\x1b[0m`);
         abort(`Try manually: cd ${targetDir} && ${pm} install`);
     }
-    // 9. Start dev server?
+    // 10. Start dev server?
     let start = false;
     if (argv.start) {
         start = true;
@@ -314,6 +371,53 @@ ${scriptCommand(pm, "deploy")}`);
    Chat: https://discord.alpic.ai
    Docs: https://docs.skybridge.tech`);
 }
+async function downloadExample(name) {
+    const res = await fetch(`https://codeload.github.com/${REPO}/tar.gz/${REPO_REF}`);
+    if (!res.ok) {
+        throw new Error(`GitHub returned ${res.status} while fetching ${REPO}.`);
+    }
+    const archive = Buffer.from(await res.arrayBuffer());
+    const tmp = fs.mkdtempSync(path.join(os.tmpdir(), "skybridge-example-"));
+    const cleanup = () => fs.rmSync(tmp, { recursive: true, force: true });
+    try {
+        const tar = spawn("tar", ["-xz", "-C", tmp], {
+            stdio: ["pipe", "ignore", "pipe"],
+        });
+        let stderr = "";
+        tar.stderr?.on("data", (chunk) => {
+            stderr += chunk.toString();
+        });
+        const exit = new Promise((resolve, reject) => {
+            tar.on("error", (error) => reject(error.code === "ENOENT"
+                ? new Error("`tar` is required to extract the example.")
+                : error));
+            tar.on("close", (status) => status === 0
+                ? resolve()
+                : reject(new Error(`tar exited with ${status}: ${stderr.trim()}`)));
+        });
+        tar.stdin?.on("error", () => { });
+        tar.stdin?.end(archive);
+        await exit;
+        const [extracted] = fs.readdirSync(tmp);
+        if (!extracted) {
+            throw new Error("Downloaded archive is empty.");
+        }
+        const examplesDir = path.join(tmp, extracted, "examples");
+        const available = fs
+            .readdirSync(examplesDir, { withFileTypes: true })
+            .filter((entry) => entry.isDirectory() &&
+            fs.existsSync(path.join(examplesDir, entry.name, "package.json")))
+            .map((entry) => entry.name);
+        if (!available.includes(name)) {
+            throw new Error(`Unknown example "${name}". Available examples:\n  ${available.join("\n  ")}`);
+        }
+        return { source: path.join(examplesDir, name), cleanup };
+    }
+    catch (error) {
+        cleanup();
+        throw error;
+    }
+}
 function cancel() {
     prompts.cancel("Operation cancelled");
     process.exit(0);

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "create-skybridge",
-  "version": "0.0.0-dev.b9f65be",
+  "version": "0.0.0-dev.b9f85b3",
   "type": "module",
   "license": "MIT",
   "author": "Alpic",
@@ -17,14 +17,14 @@
     "templates"
   ],
   "dependencies": {
-    "@clack/prompts": "^1.1.0",
+    "@clack/prompts": "^1.7.0",
     "cross-spawn": "^7.0.6",
     "mri": "^1.2.0"
   },
   "devDependencies": {
     "@types/cross-spawn": "^6.0.6",
-    "typescript": "^6.0.2",
-    "vitest": "^4.1.4"
+    "typescript": "^6.0.3",
+    "vitest": "^4.1.10"
   },
   "scripts": {
     "build": "tsc",

package/templates/blank/Dockerfile

@@ -6,7 +6,7 @@
 # (For bun or deno, adapt the install/build/prune commands below.)
 
 # Build stage: install deps, compile the app, then prune dev deps.
-FROM node:24-slim AS build
+FROM node:24.18.0-slim AS build
 WORKDIR /app
 
 COPY package.json yarn.lock* package-lock.json* pnpm-lock.yaml* .npmrc* ./
@@ -35,7 +35,7 @@ RUN if [ -f package-lock.json ]; then \
     fi
 
 # Runtime stage: copy built artifacts and prod deps, run as non-root.
-FROM node:24-slim AS runtime
+FROM node:24.18.0-slim AS runtime
 WORKDIR /app
 ENV NODE_ENV=production
 
@@ -50,4 +50,4 @@ EXPOSE 3000
 # Run the built server directly rather than via `npm start` / `skybridge start`.
 # Each wrapper adds a process layer that can swallow SIGTERM, which makes
 # graceful shutdowns time out on platforms like Cloud Run, Fly, and k8s.
-CMD ["node", "dist/server.js"]
+CMD ["node", "dist/__entry.js"]

package/templates/blank/README.md

@@ -48,7 +48,8 @@ This command starts:
 
 ```
 ├── src/
-│   ├── server.ts         # Server entry point
+│   ├── index.ts          # Entry point (starts the app)
+│   ├── server.ts         # App definition (tools, views)
 │   └── helpers.ts        # Shared utilities
 ├── vite.config.ts
 ├── alpic.json            # Deployment config

package/templates/blank/node_modules/.bin/alpic

@@ -10,9 +10,9 @@ case `uname` in
 esac
 
 if [ -z "$NODE_PATH" ]; then
-  export NODE_PATH="/home/runner/work/skybridge/skybridge/node_modules/.pnpm/alpic@1.104.1_@opentelemetry+api@1.9.0_arktype@2.1.27_rxjs@7.8.2_typescript@6.0.2/node_modules/alpic/node_modules:/home/runner/work/skybridge/skybridge/node_modules/.pnpm/alpic@1.104.1_@opentelemetry+api@1.9.0_arktype@2.1.27_rxjs@7.8.2_typescript@6.0.2/node_modules:/home/runner/work/skybridge/skybridge/node_modules/.pnpm/node_modules"
+  export NODE_PATH="/home/runner/work/skybridge/skybridge/node_modules/.pnpm/alpic@1.157.0_@opentelemetry+api@1.9.1_@opentelemetry+core@2.9.0_@opentelemetry+api@1.9_8f13b9696a5fc8688953a3b2ccd28385/node_modules/alpic/node_modules:/home/runner/work/skybridge/skybridge/node_modules/.pnpm/alpic@1.157.0_@opentelemetry+api@1.9.1_@opentelemetry+core@2.9.0_@opentelemetry+api@1.9_8f13b9696a5fc8688953a3b2ccd28385/node_modules:/home/runner/work/skybridge/skybridge/node_modules/.pnpm/node_modules"
 else
-  export NODE_PATH="/home/runner/work/skybridge/skybridge/node_modules/.pnpm/alpic@1.104.1_@opentelemetry+api@1.9.0_arktype@2.1.27_rxjs@7.8.2_typescript@6.0.2/node_modules/alpic/node_modules:/home/runner/work/skybridge/skybridge/node_modules/.pnpm/alpic@1.104.1_@opentelemetry+api@1.9.0_arktype@2.1.27_rxjs@7.8.2_typescript@6.0.2/node_modules:/home/runner/work/skybridge/skybridge/node_modules/.pnpm/node_modules:$NODE_PATH"
+  export NODE_PATH="/home/runner/work/skybridge/skybridge/node_modules/.pnpm/alpic@1.157.0_@opentelemetry+api@1.9.1_@opentelemetry+core@2.9.0_@opentelemetry+api@1.9_8f13b9696a5fc8688953a3b2ccd28385/node_modules/alpic/node_modules:/home/runner/work/skybridge/skybridge/node_modules/.pnpm/alpic@1.157.0_@opentelemetry+api@1.9.1_@opentelemetry+core@2.9.0_@opentelemetry+api@1.9_8f13b9696a5fc8688953a3b2ccd28385/node_modules:/home/runner/work/skybridge/skybridge/node_modules/.pnpm/node_modules:$NODE_PATH"
 fi
 if [ -x "$basedir/node" ]; then
   exec "$basedir/node"  "$basedir/../alpic/bin/run.js" "$@"

package/templates/blank/node_modules/.bin/tsc

@@ -10,9 +10,9 @@ case `uname` in
 esac
 
 if [ -z "$NODE_PATH" ]; then
-  export NODE_PATH="/home/runner/work/skybridge/skybridge/node_modules/.pnpm/typescript@6.0.2/node_modules/typescript/node_modules:/home/runner/work/skybridge/skybridge/node_modules/.pnpm/typescript@6.0.2/node_modules:/home/runner/work/skybridge/skybridge/node_modules/.pnpm/node_modules"
+  export NODE_PATH="/home/runner/work/skybridge/skybridge/node_modules/.pnpm/typescript@6.0.3/node_modules/typescript/node_modules:/home/runner/work/skybridge/skybridge/node_modules/.pnpm/typescript@6.0.3/node_modules:/home/runner/work/skybridge/skybridge/node_modules/.pnpm/node_modules"
 else
-  export NODE_PATH="/home/runner/work/skybridge/skybridge/node_modules/.pnpm/typescript@6.0.2/node_modules/typescript/node_modules:/home/runner/work/skybridge/skybridge/node_modules/.pnpm/typescript@6.0.2/node_modules:/home/runner/work/skybridge/skybridge/node_modules/.pnpm/node_modules:$NODE_PATH"
+  export NODE_PATH="/home/runner/work/skybridge/skybridge/node_modules/.pnpm/typescript@6.0.3/node_modules/typescript/node_modules:/home/runner/work/skybridge/skybridge/node_modules/.pnpm/typescript@6.0.3/node_modules:/home/runner/work/skybridge/skybridge/node_modules/.pnpm/node_modules:$NODE_PATH"
 fi
 if [ -x "$basedir/node" ]; then
   exec "$basedir/node"  "$basedir/../typescript/bin/tsc" "$@"

package/templates/blank/node_modules/.bin/tsserver

@@ -10,9 +10,9 @@ case `uname` in
 esac
 
 if [ -z "$NODE_PATH" ]; then
-  export NODE_PATH="/home/runner/work/skybridge/skybridge/node_modules/.pnpm/typescript@6.0.2/node_modules/typescript/node_modules:/home/runner/work/skybridge/skybridge/node_modules/.pnpm/typescript@6.0.2/node_modules:/home/runner/work/skybridge/skybridge/node_modules/.pnpm/node_modules"
+  export NODE_PATH="/home/runner/work/skybridge/skybridge/node_modules/.pnpm/typescript@6.0.3/node_modules/typescript/node_modules:/home/runner/work/skybridge/skybridge/node_modules/.pnpm/typescript@6.0.3/node_modules:/home/runner/work/skybridge/skybridge/node_modules/.pnpm/node_modules"
 else
-  export NODE_PATH="/home/runner/work/skybridge/skybridge/node_modules/.pnpm/typescript@6.0.2/node_modules/typescript/node_modules:/home/runner/work/skybridge/skybridge/node_modules/.pnpm/typescript@6.0.2/node_modules:/home/runner/work/skybridge/skybridge/node_modules/.pnpm/node_modules:$NODE_PATH"
+  export NODE_PATH="/home/runner/work/skybridge/skybridge/node_modules/.pnpm/typescript@6.0.3/node_modules/typescript/node_modules:/home/runner/work/skybridge/skybridge/node_modules/.pnpm/typescript@6.0.3/node_modules:/home/runner/work/skybridge/skybridge/node_modules/.pnpm/node_modules:$NODE_PATH"
 fi
 if [ -x "$basedir/node" ]; then
   exec "$basedir/node"  "$basedir/../typescript/bin/tsserver" "$@"

package/templates/blank/node_modules/.bin/tsx

@@ -0,0 +1,21 @@
+#!/bin/sh
+basedir=$(dirname "$(echo "$0" | sed -e 's,\\,/,g')")
+
+case `uname` in
+    *CYGWIN*|*MINGW*|*MSYS*)
+        if command -v cygpath > /dev/null 2>&1; then
+            basedir=`cygpath -w "$basedir"`
+        fi
+    ;;
+esac
+
+if [ -z "$NODE_PATH" ]; then
+  export NODE_PATH="/home/runner/work/skybridge/skybridge/node_modules/.pnpm/tsx@4.23.1/node_modules/tsx/node_modules:/home/runner/work/skybridge/skybridge/node_modules/.pnpm/tsx@4.23.1/node_modules:/home/runner/work/skybridge/skybridge/node_modules/.pnpm/node_modules"
+else
+  export NODE_PATH="/home/runner/work/skybridge/skybridge/node_modules/.pnpm/tsx@4.23.1/node_modules/tsx/node_modules:/home/runner/work/skybridge/skybridge/node_modules/.pnpm/tsx@4.23.1/node_modules:/home/runner/work/skybridge/skybridge/node_modules/.pnpm/node_modules:$NODE_PATH"
+fi
+if [ -x "$basedir/node" ]; then
+  exec "$basedir/node"  "$basedir/../tsx/dist/cli.mjs" "$@"
+else
+  exec node  "$basedir/../tsx/dist/cli.mjs" "$@"
+fi

package/templates/blank/node_modules/.bin/vite

@@ -10,9 +10,9 @@ case `uname` in
 esac
 
 if [ -z "$NODE_PATH" ]; then
-  export NODE_PATH="/home/runner/work/skybridge/skybridge/node_modules/.pnpm/vite@8.0.3_@types+node@24.12.0_esbuild@0.27.2_jiti@2.6.1_terser@5.44.1_tsx@4.21.0_yaml@2.8.2/node_modules/vite/node_modules:/home/runner/work/skybridge/skybridge/node_modules/.pnpm/vite@8.0.3_@types+node@24.12.0_esbuild@0.27.2_jiti@2.6.1_terser@5.44.1_tsx@4.21.0_yaml@2.8.2/node_modules:/home/runner/work/skybridge/skybridge/node_modules/.pnpm/node_modules"
+  export NODE_PATH="/home/runner/work/skybridge/skybridge/node_modules/.pnpm/vite@8.1.5_@types+node@24.13.3_esbuild@0.28.1_jiti@2.7.0_terser@5.44.1_tsx@4.23.1_yaml@2.9.0/node_modules/vite/node_modules:/home/runner/work/skybridge/skybridge/node_modules/.pnpm/vite@8.1.5_@types+node@24.13.3_esbuild@0.28.1_jiti@2.7.0_terser@5.44.1_tsx@4.23.1_yaml@2.9.0/node_modules:/home/runner/work/skybridge/skybridge/node_modules/.pnpm/node_modules"
 else
-  export NODE_PATH="/home/runner/work/skybridge/skybridge/node_modules/.pnpm/vite@8.0.3_@types+node@24.12.0_esbuild@0.27.2_jiti@2.6.1_terser@5.44.1_tsx@4.21.0_yaml@2.8.2/node_modules/vite/node_modules:/home/runner/work/skybridge/skybridge/node_modules/.pnpm/vite@8.0.3_@types+node@24.12.0_esbuild@0.27.2_jiti@2.6.1_terser@5.44.1_tsx@4.21.0_yaml@2.8.2/node_modules:/home/runner/work/skybridge/skybridge/node_modules/.pnpm/node_modules:$NODE_PATH"
+  export NODE_PATH="/home/runner/work/skybridge/skybridge/node_modules/.pnpm/vite@8.1.5_@types+node@24.13.3_esbuild@0.28.1_jiti@2.7.0_terser@5.44.1_tsx@4.23.1_yaml@2.9.0/node_modules/vite/node_modules:/home/runner/work/skybridge/skybridge/node_modules/.pnpm/vite@8.1.5_@types+node@24.13.3_esbuild@0.28.1_jiti@2.7.0_terser@5.44.1_tsx@4.23.1_yaml@2.9.0/node_modules:/home/runner/work/skybridge/skybridge/node_modules/.pnpm/node_modules:$NODE_PATH"
 fi
 if [ -x "$basedir/node" ]; then
   exec "$basedir/node"  "$basedir/../vite/bin/vite.js" "$@"

package/templates/blank/package.json

@@ -12,17 +12,18 @@
     "deploy": "alpic deploy"
   },
   "dependencies": {
-    "@modelcontextprotocol/sdk": "^1.29.0",
-    "skybridge": "^0.0.0-dev.b9f65be",
-    "vite": "^8.0.3"
+    "skybridge": "^0.0.0-dev.b9f85b3",
+    "vite": "^8.1.5"
   },
   "devDependencies": {
-    "@skybridge/devtools": "^1.0.0",
-    "@types/node": "^24.12.0",
-    "alpic": "^1.104.1",
-    "typescript": "^6.0.2"
+    "@skybridge/devtools": "^0.0.0-dev.b9f85b3",
+    "@skybridge/vite-plugin": "^0.0.0-dev.b9f85b3",
+    "@types/node": "^24.13.3",
+    "alpic": "^1.155.0",
+    "tsx": "^4.23.1",
+    "typescript": "^6.0.3"
   },
   "engines": {
-    "node": ">=24.14.1"
+    "node": ">=24.18.0"
   }
 }

package/templates/blank/src/index.ts

@@ -0,0 +1,3 @@
+import { app } from "./server.js";
+
+export default await app.run();

package/templates/blank/src/server.ts

@@ -1,21 +1,17 @@
-import { McpServer } from "skybridge/server";
+import { Skybridge, type SkybridgeServer } from "skybridge/server";
 
-const server = new McpServer(
+// Register tools with `server.registerTool(...)`.
+// Docs: https://docs.skybridge.tech/api-reference/register-tool
+
+export const serverFactory = (server: SkybridgeServer) => server;
+
+export const app = new Skybridge(
   {
     name: "skybridge-blank",
     version: "0.0.1",
+    capabilities: {},
   },
-  { capabilities: {} },
+  serverFactory,
 );
 
-// Register tools with `server.registerTool(...)`.
-// Docs: https://docs.skybridge.tech/api-reference/register-tool
-
-if (process.env.NODE_ENV === "production") {
-  const { default: manifest } = await import("./vite-manifest.js");
-  server.setViteManifest(manifest);
-}
-
-export default await server.run();
-
-export type AppType = typeof server;
+export type AppType = typeof app;

package/templates/blank/vite.config.ts

@@ -1,6 +1,12 @@
-import { skybridge } from "skybridge/vite";
+import { skybridge } from "@skybridge/vite-plugin";
 import { defineConfig } from "vite";
 
 export default defineConfig({
   plugins: [skybridge()],
+  server: {
+    forwardConsole: {
+      unhandledErrors: true,
+      logLevels: ["error"],
+    },
+  },
 });

package/templates/demo/Dockerfile

@@ -6,7 +6,7 @@
 # (For bun or deno, adapt the install/build/prune commands below.)
 
 # Build stage: install deps, compile the app, then prune dev deps.
-FROM node:24-slim AS build
+FROM node:24.18.0-slim AS build
 WORKDIR /app
 
 COPY package.json yarn.lock* package-lock.json* pnpm-lock.yaml* .npmrc* ./
@@ -35,7 +35,7 @@ RUN if [ -f package-lock.json ]; then \
     fi
 
 # Runtime stage: copy built artifacts and prod deps, run as non-root.
-FROM node:24-slim AS runtime
+FROM node:24.18.0-slim AS runtime
 WORKDIR /app
 ENV NODE_ENV=production
 
@@ -50,4 +50,4 @@ EXPOSE 3000
 # Run the built server directly rather than via `npm start` / `skybridge start`.
 # Each wrapper adds a process layer that can swallow SIGTERM, which makes
 # graceful shutdowns time out on platforms like Cloud Run, Fly, and k8s.
-CMD ["node", "dist/server.js"]
+CMD ["node", "dist/__entry.js"]

package/templates/demo/README.md

@@ -48,7 +48,8 @@ This command starts:
 
 ```
 ├── src/
-│   ├── server.ts         # Server entry point
+│   ├── index.ts          # Entry point (starts the app)
+│   ├── server.ts         # App definition (tools, views)
 │   ├── views/            # React components (one per view)
 │   ├── components/       # Shared UI components
 │   ├── helpers.ts        # Shared utilities

package/templates/demo/evals/start.eval.ts

@@ -0,0 +1,11 @@
+import { anthropic } from "@ai-sdk/anthropic";
+import { start } from "@skybridge/test";
+import { expect, it } from "vitest";
+import { app } from "../src/server.js";
+
+it("reaches the onboarding tool from a natural prompt", async () => {
+  const chat = await start({ app, model: anthropic("claude-sonnet-4-5") });
+  await chat.send("Get me started with Skybridge, my name is Ada");
+
+  expect.chat(chat).toHaveCalledToolOnce("start");
+});

package/templates/demo/node_modules/.bin/alpic

@@ -10,9 +10,9 @@ case `uname` in
 esac
 
 if [ -z "$NODE_PATH" ]; then
-  export NODE_PATH="/home/runner/work/skybridge/skybridge/node_modules/.pnpm/alpic@1.104.1_@opentelemetry+api@1.9.0_arktype@2.1.27_rxjs@7.8.2_typescript@6.0.2/node_modules/alpic/node_modules:/home/runner/work/skybridge/skybridge/node_modules/.pnpm/alpic@1.104.1_@opentelemetry+api@1.9.0_arktype@2.1.27_rxjs@7.8.2_typescript@6.0.2/node_modules:/home/runner/work/skybridge/skybridge/node_modules/.pnpm/node_modules"
+  export NODE_PATH="/home/runner/work/skybridge/skybridge/node_modules/.pnpm/alpic@1.157.0_@opentelemetry+api@1.9.1_@opentelemetry+core@2.9.0_@opentelemetry+api@1.9_8f13b9696a5fc8688953a3b2ccd28385/node_modules/alpic/node_modules:/home/runner/work/skybridge/skybridge/node_modules/.pnpm/alpic@1.157.0_@opentelemetry+api@1.9.1_@opentelemetry+core@2.9.0_@opentelemetry+api@1.9_8f13b9696a5fc8688953a3b2ccd28385/node_modules:/home/runner/work/skybridge/skybridge/node_modules/.pnpm/node_modules"
 else
-  export NODE_PATH="/home/runner/work/skybridge/skybridge/node_modules/.pnpm/alpic@1.104.1_@opentelemetry+api@1.9.0_arktype@2.1.27_rxjs@7.8.2_typescript@6.0.2/node_modules/alpic/node_modules:/home/runner/work/skybridge/skybridge/node_modules/.pnpm/alpic@1.104.1_@opentelemetry+api@1.9.0_arktype@2.1.27_rxjs@7.8.2_typescript@6.0.2/node_modules:/home/runner/work/skybridge/skybridge/node_modules/.pnpm/node_modules:$NODE_PATH"
+  export NODE_PATH="/home/runner/work/skybridge/skybridge/node_modules/.pnpm/alpic@1.157.0_@opentelemetry+api@1.9.1_@opentelemetry+core@2.9.0_@opentelemetry+api@1.9_8f13b9696a5fc8688953a3b2ccd28385/node_modules/alpic/node_modules:/home/runner/work/skybridge/skybridge/node_modules/.pnpm/alpic@1.157.0_@opentelemetry+api@1.9.1_@opentelemetry+core@2.9.0_@opentelemetry+api@1.9_8f13b9696a5fc8688953a3b2ccd28385/node_modules:/home/runner/work/skybridge/skybridge/node_modules/.pnpm/node_modules:$NODE_PATH"
 fi
 if [ -x "$basedir/node" ]; then
   exec "$basedir/node"  "$basedir/../alpic/bin/run.js" "$@"

package/templates/demo/node_modules/.bin/tsc

@@ -10,9 +10,9 @@ case `uname` in
 esac
 
 if [ -z "$NODE_PATH" ]; then
-  export NODE_PATH="/home/runner/work/skybridge/skybridge/node_modules/.pnpm/typescript@6.0.2/node_modules/typescript/node_modules:/home/runner/work/skybridge/skybridge/node_modules/.pnpm/typescript@6.0.2/node_modules:/home/runner/work/skybridge/skybridge/node_modules/.pnpm/node_modules"
+  export NODE_PATH="/home/runner/work/skybridge/skybridge/node_modules/.pnpm/typescript@6.0.3/node_modules/typescript/node_modules:/home/runner/work/skybridge/skybridge/node_modules/.pnpm/typescript@6.0.3/node_modules:/home/runner/work/skybridge/skybridge/node_modules/.pnpm/node_modules"
 else
-  export NODE_PATH="/home/runner/work/skybridge/skybridge/node_modules/.pnpm/typescript@6.0.2/node_modules/typescript/node_modules:/home/runner/work/skybridge/skybridge/node_modules/.pnpm/typescript@6.0.2/node_modules:/home/runner/work/skybridge/skybridge/node_modules/.pnpm/node_modules:$NODE_PATH"
+  export NODE_PATH="/home/runner/work/skybridge/skybridge/node_modules/.pnpm/typescript@6.0.3/node_modules/typescript/node_modules:/home/runner/work/skybridge/skybridge/node_modules/.pnpm/typescript@6.0.3/node_modules:/home/runner/work/skybridge/skybridge/node_modules/.pnpm/node_modules:$NODE_PATH"
 fi
 if [ -x "$basedir/node" ]; then
   exec "$basedir/node"  "$basedir/../typescript/bin/tsc" "$@"

package/templates/demo/node_modules/.bin/tsserver

@@ -10,9 +10,9 @@ case `uname` in
 esac
 
 if [ -z "$NODE_PATH" ]; then
-  export NODE_PATH="/home/runner/work/skybridge/skybridge/node_modules/.pnpm/typescript@6.0.2/node_modules/typescript/node_modules:/home/runner/work/skybridge/skybridge/node_modules/.pnpm/typescript@6.0.2/node_modules:/home/runner/work/skybridge/skybridge/node_modules/.pnpm/node_modules"
+  export NODE_PATH="/home/runner/work/skybridge/skybridge/node_modules/.pnpm/typescript@6.0.3/node_modules/typescript/node_modules:/home/runner/work/skybridge/skybridge/node_modules/.pnpm/typescript@6.0.3/node_modules:/home/runner/work/skybridge/skybridge/node_modules/.pnpm/node_modules"
 else
-  export NODE_PATH="/home/runner/work/skybridge/skybridge/node_modules/.pnpm/typescript@6.0.2/node_modules/typescript/node_modules:/home/runner/work/skybridge/skybridge/node_modules/.pnpm/typescript@6.0.2/node_modules:/home/runner/work/skybridge/skybridge/node_modules/.pnpm/node_modules:$NODE_PATH"
+  export NODE_PATH="/home/runner/work/skybridge/skybridge/node_modules/.pnpm/typescript@6.0.3/node_modules/typescript/node_modules:/home/runner/work/skybridge/skybridge/node_modules/.pnpm/typescript@6.0.3/node_modules:/home/runner/work/skybridge/skybridge/node_modules/.pnpm/node_modules:$NODE_PATH"
 fi
 if [ -x "$basedir/node" ]; then
   exec "$basedir/node"  "$basedir/../typescript/bin/tsserver" "$@"

package/templates/demo/node_modules/.bin/tsx

@@ -10,9 +10,9 @@ case `uname` in
 esac
 
 if [ -z "$NODE_PATH" ]; then
-  export NODE_PATH="/home/runner/work/skybridge/skybridge/node_modules/.pnpm/tsx@4.21.0/node_modules/tsx/node_modules:/home/runner/work/skybridge/skybridge/node_modules/.pnpm/tsx@4.21.0/node_modules:/home/runner/work/skybridge/skybridge/node_modules/.pnpm/node_modules"
+  export NODE_PATH="/home/runner/work/skybridge/skybridge/node_modules/.pnpm/tsx@4.23.1/node_modules/tsx/node_modules:/home/runner/work/skybridge/skybridge/node_modules/.pnpm/tsx@4.23.1/node_modules:/home/runner/work/skybridge/skybridge/node_modules/.pnpm/node_modules"
 else
-  export NODE_PATH="/home/runner/work/skybridge/skybridge/node_modules/.pnpm/tsx@4.21.0/node_modules/tsx/node_modules:/home/runner/work/skybridge/skybridge/node_modules/.pnpm/tsx@4.21.0/node_modules:/home/runner/work/skybridge/skybridge/node_modules/.pnpm/node_modules:$NODE_PATH"
+  export NODE_PATH="/home/runner/work/skybridge/skybridge/node_modules/.pnpm/tsx@4.23.1/node_modules/tsx/node_modules:/home/runner/work/skybridge/skybridge/node_modules/.pnpm/tsx@4.23.1/node_modules:/home/runner/work/skybridge/skybridge/node_modules/.pnpm/node_modules:$NODE_PATH"
 fi
 if [ -x "$basedir/node" ]; then
   exec "$basedir/node"  "$basedir/../tsx/dist/cli.mjs" "$@"

package/templates/demo/node_modules/.bin/vite

@@ -10,9 +10,9 @@ case `uname` in
 esac
 
 if [ -z "$NODE_PATH" ]; then
-  export NODE_PATH="/home/runner/work/skybridge/skybridge/node_modules/.pnpm/vite@8.0.3_@types+node@24.12.0_esbuild@0.27.2_jiti@2.6.1_terser@5.44.1_tsx@4.21.0_yaml@2.8.2/node_modules/vite/node_modules:/home/runner/work/skybridge/skybridge/node_modules/.pnpm/vite@8.0.3_@types+node@24.12.0_esbuild@0.27.2_jiti@2.6.1_terser@5.44.1_tsx@4.21.0_yaml@2.8.2/node_modules:/home/runner/work/skybridge/skybridge/node_modules/.pnpm/node_modules"
+  export NODE_PATH="/home/runner/work/skybridge/skybridge/node_modules/.pnpm/vite@8.1.5_@types+node@24.13.3_esbuild@0.28.1_jiti@2.7.0_terser@5.44.1_tsx@4.23.1_yaml@2.9.0/node_modules/vite/node_modules:/home/runner/work/skybridge/skybridge/node_modules/.pnpm/vite@8.1.5_@types+node@24.13.3_esbuild@0.28.1_jiti@2.7.0_terser@5.44.1_tsx@4.23.1_yaml@2.9.0/node_modules:/home/runner/work/skybridge/skybridge/node_modules/.pnpm/node_modules"
 else
-  export NODE_PATH="/home/runner/work/skybridge/skybridge/node_modules/.pnpm/vite@8.0.3_@types+node@24.12.0_esbuild@0.27.2_jiti@2.6.1_terser@5.44.1_tsx@4.21.0_yaml@2.8.2/node_modules/vite/node_modules:/home/runner/work/skybridge/skybridge/node_modules/.pnpm/vite@8.0.3_@types+node@24.12.0_esbuild@0.27.2_jiti@2.6.1_terser@5.44.1_tsx@4.21.0_yaml@2.8.2/node_modules:/home/runner/work/skybridge/skybridge/node_modules/.pnpm/node_modules:$NODE_PATH"
+  export NODE_PATH="/home/runner/work/skybridge/skybridge/node_modules/.pnpm/vite@8.1.5_@types+node@24.13.3_esbuild@0.28.1_jiti@2.7.0_terser@5.44.1_tsx@4.23.1_yaml@2.9.0/node_modules/vite/node_modules:/home/runner/work/skybridge/skybridge/node_modules/.pnpm/vite@8.1.5_@types+node@24.13.3_esbuild@0.28.1_jiti@2.7.0_terser@5.44.1_tsx@4.23.1_yaml@2.9.0/node_modules:/home/runner/work/skybridge/skybridge/node_modules/.pnpm/node_modules:$NODE_PATH"
 fi
 if [ -x "$basedir/node" ]; then
   exec "$basedir/node"  "$basedir/../vite/bin/vite.js" "$@"