create-skybridge 0.0.0-dev.a05e8da → 0.0.0-dev.a08278b

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";
@@ -8,6 +9,7 @@ const OUTPUT_TAIL_LINES = 10;
 const DEFAULT_PROJECT_NAME = "skybridge-project";
 const PACKAGE_MANAGERS = ["bun", "deno", "npm", "pnpm", "yarn"];
 const TEMPLATES = ["demo", "blank", "ecom"];
+const REPO = "alpic-ai/skybridge";
 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,14 +20,15 @@ Arguments:
   path           Where the project will be created. Prompted when omitted.
 
 Options:
-  --blank        scaffold a minimal project without demo tools and views
-  --ecom         scaffold the ecommerce template (search products, render carousel)
-  --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 examples/<name> from the latest Skybridge release
+  --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
@@ -70,7 +73,7 @@ export async function init(args = process.argv.slice(2)) {
             "start",
             "yes",
         ],
-        string: ["pm"],
+        string: ["pm", "example"],
         alias: { h: "help" },
     });
     if (argv.help) {
@@ -82,6 +85,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(", ")}.`);
@@ -104,6 +114,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);
@@ -136,7 +158,7 @@ export async function init(args = process.argv.slice(2)) {
         }
         template = "ecom";
     }
-    if (!template) {
+    if (!template && !example) {
         if (yes) {
             template = "demo";
         }
@@ -170,23 +192,31 @@ export async function init(args = process.argv.slice(2)) {
     }
     // 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");
@@ -294,7 +324,7 @@ export async function init(args = process.argv.slice(2)) {
     }
     // 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');
+        fs.writeFileSync(path.join(root, "pnpm-workspace.yaml"), 'packages:\n  - "."\nonlyBuiltDependencies:\n  - esbuild\nallowBuilds:\n  esbuild: true\n  "@swc/core": false\n  msw: false\n');
     }
     // 9. Always install dependencies
     Spinner.start(`Installing dependencies with ${pm}`);
@@ -340,6 +370,62 @@ ${scriptCommand(pm, "deploy")}`);
    Chat: https://discord.alpic.ai
    Docs: https://docs.skybridge.tech`);
 }
+async function fetchJson(url) {
+    const res = await fetch(url, {
+        headers: { accept: "application/vnd.github+json" },
+    });
+    if (!res.ok) {
+        throw new Error(`GitHub returned ${res.status} for ${url}.`);
+    }
+    return res.json();
+}
+async function downloadExample(name) {
+    const api = `https://api.github.com/repos/${REPO}`;
+    const { tag_name: tag } = await fetchJson(`${api}/releases/latest`);
+    const entries = await fetchJson(`${api}/contents/examples?ref=${tag}`);
+    const available = entries
+        .filter((entry) => entry.type === "dir")
+        .map((entry) => entry.name);
+    if (!available.includes(name)) {
+        throw new Error(`Unknown example "${name}". Available examples:\n  ${available.join("\n  ")}`);
+    }
+    const res = await fetch(`https://codeload.github.com/${REPO}/tar.gz/${tag}`);
+    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.");
+        }
+        return { source: path.join(tmp, extracted, "examples", 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.a05e8da",
+  "version": "0.0.0-dev.a08278b",
   "type": "module",
   "license": "MIT",
   "author": "Alpic",

package/templates/blank/AGENTS.md

@@ -1 +1 @@
-This is a ChatGPT/MCP app built with Skybridge. ALWAYS use the `chatgpt-app-builder` skill when planning or updating the codebase.
+This is a ChatGPT/MCP App built with Skybridge. ALWAYS use the `chatgpt-app-builder` skill when planning or updating the codebase.

package/templates/blank/README.md

@@ -1,6 +1,6 @@
 # Skybridge Boilerplate
 
-A minimal TypeScript boilerplate for building MCP and ChatGPT Apps with the [Skybridge](https://docs.skybridge.tech) framework.
+A minimal TypeScript boilerplate for building MCP Apps and ChatGPT plugins with the [Skybridge](https://docs.skybridge.tech) framework.
 
 ## Getting Started
 
@@ -87,7 +87,7 @@ The simplest way to deploy your app is by running the `deploy` command, which wi
 
 ## Resources
 - [Skybridge Documentation](https://docs.skybridge.tech/)
-- [Apps SDK Documentation](https://developers.openai.com/apps-sdk)
+- [ChatGPT Plugins Documentation](https://developers.openai.com/plugins)
 - [MCP Apps Documentation](https://github.com/modelcontextprotocol/ext-apps/tree/main)
 - [Model Context Protocol Documentation](https://modelcontextprotocol.io/)
 - [Alpic Documentation](https://docs.alpic.ai/)

package/templates/blank/package.json

@@ -12,18 +12,19 @@
     "deploy": "alpic deploy"
   },
   "dependencies": {
-    "skybridge": "^0.0.0-dev.a05e8da",
-    "vite": "^8.1.5"
+    "skybridge": "^0.0.0-dev.a08278b",
+    "vite": "^8.1.5",
+    "zod": "^4.4.3"
   },
   "devDependencies": {
-    "@skybridge/devtools": "^0.0.0-dev.a05e8da",
-    "@skybridge/vite-plugin": "^0.0.0-dev.a05e8da",
+    "@skybridge/devtools": "^0.0.0-dev.a08278b",
+    "@skybridge/vite-plugin": "^0.0.0-dev.a08278b",
     "@types/node": "^24.13.3",
     "alpic": "^1.155.0",
     "tsx": "^4.23.1",
     "typescript": "^6.0.3"
   },
   "engines": {
-    "node": ">=24.18.0"
+    "node": ">=24.0.0"
   }
 }

package/templates/demo/AGENTS.md

@@ -1 +1 @@
-This is a ChatGPT/MCP app built with Skybridge. ALWAYS use the `chatgpt-app-builder` skill when planning or updating the codebase.
+This is a ChatGPT/MCP App built with Skybridge. ALWAYS use the `chatgpt-app-builder` skill when planning or updating the codebase.

package/templates/demo/README.md

@@ -1,6 +1,6 @@
 # Skybridge Template
 
-A starter TypeScript template for building MCP and ChatGPT Apps with the [Skybridge](https://docs.skybridge.tech) framework.
+A starter TypeScript template for building MCP Apps and ChatGPT plugins with the [Skybridge](https://docs.skybridge.tech) framework.
 
 ## Getting Started
 
@@ -91,7 +91,7 @@ The simplest way to deploy your app is by running the `deploy` command, which wi
 
 ## Resources
 - [Skybridge Documentation](https://docs.skybridge.tech/)
-- [Apps SDK Documentation](https://developers.openai.com/apps-sdk)
+- [ChatGPT Plugins Documentation](https://developers.openai.com/plugins)
 - [MCP Apps Documentation](https://github.com/modelcontextprotocol/ext-apps/tree/main)
 - [Model Context Protocol Documentation](https://modelcontextprotocol.io/)
 - [Alpic Documentation](https://docs.alpic.ai/)

package/templates/demo/package.json

@@ -18,23 +18,23 @@
     "lucide-react": "^1.25.0",
     "react": "^19.2.7",
     "react-dom": "^19.2.7",
-    "skybridge": "^0.0.0-dev.a05e8da",
+    "skybridge": "^0.0.0-dev.a08278b",
     "sonner": "^2.0.7",
     "tw-animate-css": "^1.4.0",
     "vite": "^8.1.5",
     "zod": "^4.4.3"
   },
   "devDependencies": {
-    "@ai-sdk/anthropic": "^2.0.90",
-    "@skybridge/devtools": "^0.0.0-dev.a05e8da",
-    "@skybridge/test": "beta",
-    "@skybridge/vite-plugin": "^0.0.0-dev.a05e8da",
+    "@ai-sdk/anthropic": "^4.0.0",
+    "@skybridge/devtools": "^0.0.0-dev.a08278b",
+    "@skybridge/test": "^0.0.0-dev.a08278b",
+    "@skybridge/vite-plugin": "^0.0.0-dev.a08278b",
     "@tailwindcss/vite": "^4.3.3",
     "@types/node": "^24.13.3",
     "@types/react": "^19.2.17",
     "@types/react-dom": "^19.2.3",
     "@vitejs/plugin-react": "^6.0.3",
-    "ai": "^5.0.0",
+    "ai": "^7.0.0",
     "alpic": "^1.155.0",
     "tailwindcss": "^4.3.3",
     "tsx": "^4.23.1",
@@ -42,6 +42,6 @@
     "vitest": "^4.1.10"
   },
   "engines": {
-    "node": ">=24.18.0"
+    "node": ">=24.0.0"
   }
 }

package/templates/ecom/README.md

@@ -1,6 +1,6 @@
 # Skybridge Boilerplate
 
-A minimal TypeScript boilerplate for building MCP and ChatGPT Apps with the [Skybridge](https://docs.skybridge.tech) framework.
+A minimal TypeScript boilerplate for building MCP Apps and ChatGPT plugins with the [Skybridge](https://docs.skybridge.tech) framework.
 
 ## Getting Started
 
@@ -87,7 +87,7 @@ The simplest way to deploy your app is by running the `deploy` command, which wi
 
 ## Resources
 - [Skybridge Documentation](https://docs.skybridge.tech/)
-- [Apps SDK Documentation](https://developers.openai.com/apps-sdk)
+- [ChatGPT Plugins Documentation](https://developers.openai.com/plugins)
 - [MCP Apps Documentation](https://github.com/modelcontextprotocol/ext-apps/tree/main)
 - [Model Context Protocol Documentation](https://modelcontextprotocol.io/)
 - [Alpic Documentation](https://docs.alpic.ai/)

package/templates/ecom/node_modules/.bin/ladle

@@ -10,9 +10,9 @@ case `uname` in
 esac
 
 if [ -z "$NODE_PATH" ]; then
-  export NODE_PATH="/home/runner/work/skybridge/skybridge/node_modules/.pnpm/@ladle+react@5.1.1_@types+node@24.13.3_@types+react@19.2.17_jiti@2.7.0_lightningcss@1.3_8c0d7eb4f29a667fc68ef4c081ca0a73/node_modules/@ladle/react/node_modules:/home/runner/work/skybridge/skybridge/node_modules/.pnpm/@ladle+react@5.1.1_@types+node@24.13.3_@types+react@19.2.17_jiti@2.7.0_lightningcss@1.3_8c0d7eb4f29a667fc68ef4c081ca0a73/node_modules:/home/runner/work/skybridge/skybridge/node_modules/.pnpm/node_modules"
+  export NODE_PATH="/home/runner/work/skybridge/skybridge/node_modules/.pnpm/@ladle+react@5.1.1_@swc+helpers@0.5.23_@types+node@24.13.3_@types+react@19.2.17_jiti@2._9105ecfa2ac4b29fe87a036530c3844f/node_modules/@ladle/react/node_modules:/home/runner/work/skybridge/skybridge/node_modules/.pnpm/@ladle+react@5.1.1_@swc+helpers@0.5.23_@types+node@24.13.3_@types+react@19.2.17_jiti@2._9105ecfa2ac4b29fe87a036530c3844f/node_modules:/home/runner/work/skybridge/skybridge/node_modules/.pnpm/node_modules"
 else
-  export NODE_PATH="/home/runner/work/skybridge/skybridge/node_modules/.pnpm/@ladle+react@5.1.1_@types+node@24.13.3_@types+react@19.2.17_jiti@2.7.0_lightningcss@1.3_8c0d7eb4f29a667fc68ef4c081ca0a73/node_modules/@ladle/react/node_modules:/home/runner/work/skybridge/skybridge/node_modules/.pnpm/@ladle+react@5.1.1_@types+node@24.13.3_@types+react@19.2.17_jiti@2.7.0_lightningcss@1.3_8c0d7eb4f29a667fc68ef4c081ca0a73/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/@ladle+react@5.1.1_@swc+helpers@0.5.23_@types+node@24.13.3_@types+react@19.2.17_jiti@2._9105ecfa2ac4b29fe87a036530c3844f/node_modules/@ladle/react/node_modules:/home/runner/work/skybridge/skybridge/node_modules/.pnpm/@ladle+react@5.1.1_@swc+helpers@0.5.23_@types+node@24.13.3_@types+react@19.2.17_jiti@2._9105ecfa2ac4b29fe87a036530c3844f/node_modules:/home/runner/work/skybridge/skybridge/node_modules/.pnpm/node_modules:$NODE_PATH"
 fi
 if [ -x "$basedir/node" ]; then
   exec "$basedir/node"  "$basedir/../@ladle/react/lib/cli/cli.js" "$@"

package/templates/ecom/package.json

@@ -16,14 +16,14 @@
   "dependencies": {
     "react": "^19.2.4",
     "react-dom": "^19.2.4",
-    "skybridge": "^0.0.0-dev.a05e8da",
+    "skybridge": "^0.0.0-dev.a08278b",
     "vite": "^8.1.3",
     "zod": "^4.4.3"
   },
   "devDependencies": {
     "@ladle/react": "^5.1.1",
-    "@skybridge/devtools": "^0.0.0-dev.a05e8da",
-    "@skybridge/vite-plugin": "^0.0.0-dev.a05e8da",
+    "@skybridge/devtools": "^0.0.0-dev.a08278b",
+    "@skybridge/vite-plugin": "^0.0.0-dev.a08278b",
     "@types/node": "^24.13.2",
     "@types/react": "^19.2.14",
     "@types/react-dom": "^19.2.3",
@@ -37,6 +37,6 @@
     "typescript": "^6.0.3"
   },
   "engines": {
-    "node": ">=24.18.0"
+    "node": ">=24.0.0"
   }
 }