create-skybridge 0.0.0-dev.337e7a0 → 0.0.0-dev.3400911

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (19) hide show
  1. package/dist/index.js +63 -36
  2. package/dist/index.test.js +11 -1
  3. package/package.json +3 -3
  4. package/template/README.md +5 -5
  5. package/template/_gitignore +2 -1
  6. package/template/alpic.json +1 -2
  7. package/template/node_modules/.bin/mcp-inspector +2 -2
  8. package/template/node_modules/.bin/sb +21 -0
  9. package/template/node_modules/.bin/skybridge +21 -0
  10. package/template/node_modules/.bin/vite +2 -2
  11. package/template/package.json +25 -26
  12. package/template/server/src/index.ts +13 -7
  13. package/template/server/src/server.ts +0 -5
  14. package/template/tsconfig.server.json +1 -1
  15. package/template/web/src/index.css +126 -5
  16. package/template/web/vite.config.ts +2 -2
  17. package/template/node_modules/.bin/shx +0 -21
  18. package/template/pnpm-workspace.yaml +0 -8
  19. package/template/server/package.json +0 -33
package/dist/index.js CHANGED
@@ -3,8 +3,8 @@ import fs from "node:fs";
3
3
  import path from "node:path";
4
4
  import { fileURLToPath } from "node:url";
5
5
  import * as prompts from "@clack/prompts";
6
+ import { downloadTemplate } from "giget";
6
7
  import mri from "mri";
7
- const minimumPnpmVersion = 10;
8
8
  const defaultProjectName = "skybridge-project";
9
9
  // prettier-ignore
10
10
  const helpMessage = `\
@@ -14,21 +14,30 @@ Create a new Skybridge project by copying the starter template.
14
14
 
15
15
  Options:
16
16
  -h, --help show this help message
17
+ --repo <uri> use a git repository instead of the built-in template
17
18
  --overwrite remove existing files in target directory
18
19
  --immediate install dependencies and start development server
19
20
 
21
+ Repository URI formats:
22
+ github:user/repo
23
+ gitlab:user/repo/subdirectory
24
+ bitbucket:user/repo#branch
25
+
20
26
  Examples:
21
27
  create-skybridge my-app
28
+ create-skybridge my-app --repo github:alpic-ai/skybridge/examples/ecom-carousel
22
29
  create-skybridge . --overwrite --immediate
23
30
  `;
24
31
  export async function init(args = process.argv.slice(2)) {
25
32
  const argv = mri(args, {
26
33
  boolean: ["help", "overwrite", "immediate"],
34
+ string: ["repo"],
27
35
  alias: { h: "help" },
28
36
  });
29
37
  const argTargetDir = argv._[0]
30
38
  ? sanitizeTargetDir(String(argv._[0]))
31
39
  : undefined;
40
+ const argRepo = argv.repo;
32
41
  const argOverwrite = argv.overwrite;
33
42
  const argImmediate = argv.immediate;
34
43
  const help = argv.help;
@@ -101,36 +110,55 @@ export async function init(args = process.argv.slice(2)) {
101
110
  }
102
111
  }
103
112
  const root = path.join(process.cwd(), targetDir);
104
- // 3. Copy the repository
105
- prompts.log.step(`Copying template...`);
113
+ // 3. Download from repo or copy template
114
+ try {
115
+ if (argRepo) {
116
+ prompts.log.step(`Downloading ${argRepo}...`);
117
+ await downloadTemplate(argRepo, { dir: root });
118
+ prompts.log.success(`Project created in ${root}`);
119
+ }
120
+ else {
121
+ prompts.log.step(`Copying template...`);
122
+ const templateDir = fileURLToPath(new URL("../template", import.meta.url));
123
+ // Copy template to target directory
124
+ fs.cpSync(templateDir, root, {
125
+ recursive: true,
126
+ filter: (src) => [".npmrc"].every((file) => !src.endsWith(file)),
127
+ });
128
+ // Rename _gitignore to .gitignore
129
+ fs.renameSync(path.join(root, "_gitignore"), path.join(root, ".gitignore"));
130
+ prompts.log.success(`Project created in ${root}`);
131
+ }
132
+ }
133
+ catch (error) {
134
+ prompts.log.error("Failed to create project from template");
135
+ console.error(error);
136
+ process.exit(1);
137
+ }
138
+ // Update project name in package.json
139
+ const pkgPath = path.join(root, "package.json");
140
+ if (!fs.existsSync(pkgPath)) {
141
+ prompts.log.error("No package.json found in project");
142
+ process.exit(1);
143
+ }
106
144
  try {
107
- const templateDir = fileURLToPath(new URL("../template", import.meta.url));
108
- // Copy template to target directory
109
- fs.cpSync(templateDir, root, {
110
- recursive: true,
111
- filter: (src) => [".npmrc"].every((file) => !src.endsWith(file)),
112
- });
113
- // Rename _gitignore to .gitignore
114
- fs.renameSync(path.join(root, "_gitignore"), path.join(root, ".gitignore"));
115
- // Update project name in package.json
116
- const name = path.basename(root);
117
- const pkgPath = path.join(root, "package.json");
118
- const pkg = fs.readFileSync(pkgPath, "utf-8");
119
- const fixed = pkg.replace(/apps-sdk-template/g, name);
120
- fs.writeFileSync(pkgPath, fixed);
121
- prompts.log.success(`Project created in ${root}`);
145
+ const pkg = JSON.parse(fs.readFileSync(pkgPath, "utf-8"));
146
+ pkg.name = path.basename(root);
147
+ fs.writeFileSync(pkgPath, `${JSON.stringify(pkg, null, 2)}\n`);
122
148
  }
123
149
  catch (error) {
124
- prompts.log.error("Failed to copy repository");
150
+ prompts.log.error("Failed to update project name in package.json");
125
151
  console.error(error);
126
152
  process.exit(1);
127
153
  }
154
+ const userAgent = process.env.npm_config_user_agent;
155
+ const pkgManager = userAgent?.split(" ")[0]?.split("/")[0] || "npm";
128
156
  // 4. Ask about immediate installation
129
157
  let immediate = argImmediate;
130
158
  if (immediate === undefined) {
131
159
  if (interactive) {
132
160
  const immediateResult = await prompts.confirm({
133
- message: `Install with pnpm and start now?`,
161
+ message: `Install with ${pkgManager} and start now?`,
134
162
  });
135
163
  if (prompts.isCancel(immediateResult)) {
136
164
  return cancel();
@@ -141,8 +169,20 @@ export async function init(args = process.argv.slice(2)) {
141
169
  immediate = false;
142
170
  }
143
171
  }
144
- const installCmd = ["pnpm", "install"];
145
- const runCmd = ["pnpm", "dev"];
172
+ const installCmd = [pkgManager, "install"];
173
+ const runCmd = [pkgManager];
174
+ switch (pkgManager) {
175
+ case "yarn":
176
+ case "pnpm":
177
+ case "bun":
178
+ break;
179
+ case "deno":
180
+ runCmd.push("task");
181
+ break;
182
+ default:
183
+ runCmd.push("run");
184
+ }
185
+ runCmd.push("dev");
146
186
  if (!immediate) {
147
187
  prompts.outro(`Done! Next steps:
148
188
  cd ${targetDir}
@@ -151,20 +191,7 @@ export async function init(args = process.argv.slice(2)) {
151
191
  `);
152
192
  return;
153
193
  }
154
- // check if pnpm is installed
155
- const result = spawnSync("pnpm", ["--version"], { encoding: "utf-8" });
156
- if (result.error || result.status !== 0) {
157
- console.error("Error: pnpm is not installed. Please install pnpm first.");
158
- process.exit(1);
159
- }
160
- // check if pnpm major is greater or equal to the one set in package.json packageManager, which should do the trick
161
- const version = result.stdout.trim();
162
- const major = Number(version.split(".")[0]);
163
- if (Number.isNaN(major) || major < minimumPnpmVersion) {
164
- console.error(`Error: pnpm version ${version} is too old. Minimum required version is ${minimumPnpmVersion}.`);
165
- process.exit(1);
166
- }
167
- prompts.log.step(`Installing dependencies with pnpm...`);
194
+ prompts.log.step(`Installing dependencies with ${pkgManager}...`);
168
195
  run(installCmd, {
169
196
  stdio: "inherit",
170
197
  cwd: root,
package/dist/index.test.js CHANGED
@@ -14,10 +14,20 @@ describe("create-skybridge", () => {
14
14
  force: true,
15
15
  });
16
16
  });
17
- it("should scaffold a new project", async () => {
17
+ it("should copy the template", async () => {
18
18
  const name = `../../${tempDirName}//project$`;
19
19
  await init([name]);
20
20
  await fs.access(path.join(process.cwd(), tempDirName, "project", ".gitignore"));
21
21
  expect(fs.access(path.join(process.cwd(), tempDirName, "project", ".npmrc"))).rejects.toThrowError();
22
22
  });
23
+ it("should download template from repo", async () => {
24
+ const name = `../../${tempDirName}//project$`;
25
+ await init([
26
+ name,
27
+ "--repo",
28
+ "github:alpic-ai/skybridge/examples/ecom-carousel",
29
+ ]);
30
+ await fs.access(path.join(process.cwd(), tempDirName, "project", ".gitignore"));
31
+ expect(fs.access(path.join(process.cwd(), tempDirName, "project", ".npmrc"))).rejects.toThrowError();
32
+ });
23
33
  });
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "create-skybridge",
3
- "version": "0.0.0-dev.337e7a0",
3
+ "version": "0.0.0-dev.3400911",
4
4
  "type": "module",
5
5
  "license": "MIT",
6
6
  "author": "Alpic",
@@ -18,12 +18,12 @@
18
18
  ],
19
19
  "dependencies": {
20
20
  "@clack/prompts": "^0.11.0",
21
+ "giget": "^2.0.0",
21
22
  "mri": "^1.2.0"
22
23
  },
23
24
  "devDependencies": {
24
- "@types/node": "^25.0.3",
25
25
  "typescript": "^5.9.3",
26
- "vitest": "^2.1.9"
26
+ "vitest": "^4.0.18"
27
27
  },
28
28
  "scripts": {
29
29
  "build": "tsc",
package/template/README.md CHANGED
@@ -1,12 +1,12 @@
1
- # ChatGPT Apps SDK Alpic Starter
1
+ # Skybridge Starter
2
2
 
3
- A minimal TypeScript template for building OpenAI Apps SDK compatible MCP servers with widget rendering in ChatGPT.
3
+ A minimal TypeScript template for building ChatGPT and MCP Apps with widget rendering.
4
4
 
5
5
  ## Getting Started
6
6
 
7
7
  ### Prerequisites
8
8
 
9
- - Node.js 22+
9
+ - Node.js 24+
10
10
  - HTTP tunnel such as [ngrok](https://ngrok.com/download)
11
11
 
12
12
  ### Local Development
@@ -40,7 +40,7 @@ bun dev
40
40
  This command starts an Express server on port 3000. This server packages:
41
41
 
42
42
  - an MCP endpoint on `/mcp` (the app backend)
43
- - a React application on Vite HMR dev server (the UI elements to be displayed in ChatGPT)
43
+ - a React application on Vite HMR dev server (the UI elements to be displayed in the host)
44
44
 
45
45
  #### 3. Connect to ChatGPT
46
46
 
@@ -59,7 +59,7 @@ ngrok http 3000
59
59
 
60
60
  #### 2. Edit widgets with Hot Module Replacement (HMR)
61
61
 
62
- Edit and save components in `web/src/widgets/` — changes appear instantly in ChatGPT
62
+ Edit and save components in `web/src/widgets/` — changes appear instantly in the host
63
63
 
64
64
  #### 3. Edit server code
65
65
 
package/template/_gitignore CHANGED
@@ -1,4 +1,5 @@
1
1
  node_modules/
2
2
  dist/
3
3
  .env*
4
- .DS_store
4
+ .DS_store
5
+ *.tsbuildinfo
package/template/alpic.json CHANGED
@@ -1,4 +1,3 @@
1
1
  {
2
- "$schema": "https://assets.alpic.ai/alpic.json",
3
- "buildOutputDir": "server/dist"
2
+ "$schema": "https://assets.alpic.ai/alpic.json"
4
3
  }
package/template/node_modules/.bin/mcp-inspector CHANGED
@@ -10,9 +10,9 @@ case `uname` in
10
10
  esac
11
11
 
12
12
  if [ -z "$NODE_PATH" ]; then
13
- export NODE_PATH="/home/runner/work/skybridge/skybridge/node_modules/.pnpm/@modelcontextprotocol+inspector@0.17.5_@types+node@22.18.12_@types+react-dom@19.2.3_@ty_960011790b33063d7255347351a0cc44/node_modules/@modelcontextprotocol/inspector/cli/build/node_modules:/home/runner/work/skybridge/skybridge/node_modules/.pnpm/@modelcontextprotocol+inspector@0.17.5_@types+node@22.18.12_@types+react-dom@19.2.3_@ty_960011790b33063d7255347351a0cc44/node_modules/@modelcontextprotocol/inspector/cli/node_modules:/home/runner/work/skybridge/skybridge/node_modules/.pnpm/@modelcontextprotocol+inspector@0.17.5_@types+node@22.18.12_@types+react-dom@19.2.3_@ty_960011790b33063d7255347351a0cc44/node_modules/@modelcontextprotocol/inspector/node_modules:/home/runner/work/skybridge/skybridge/node_modules/.pnpm/@modelcontextprotocol+inspector@0.17.5_@types+node@22.18.12_@types+react-dom@19.2.3_@ty_960011790b33063d7255347351a0cc44/node_modules/@modelcontextprotocol/node_modules:/home/runner/work/skybridge/skybridge/node_modules/.pnpm/@modelcontextprotocol+inspector@0.17.5_@types+node@22.18.12_@types+react-dom@19.2.3_@ty_960011790b33063d7255347351a0cc44/node_modules:/home/runner/work/skybridge/skybridge/node_modules/.pnpm/node_modules"
13
+ export NODE_PATH="/home/runner/work/skybridge/skybridge/node_modules/.pnpm/@modelcontextprotocol+inspector@0.19.0_@types+node@24.10.9_@types+react-dom@19.2.3_@typ_41033ef40504844615e138b3524ee95a/node_modules/@modelcontextprotocol/inspector/cli/build/node_modules:/home/runner/work/skybridge/skybridge/node_modules/.pnpm/@modelcontextprotocol+inspector@0.19.0_@types+node@24.10.9_@types+react-dom@19.2.3_@typ_41033ef40504844615e138b3524ee95a/node_modules/@modelcontextprotocol/inspector/cli/node_modules:/home/runner/work/skybridge/skybridge/node_modules/.pnpm/@modelcontextprotocol+inspector@0.19.0_@types+node@24.10.9_@types+react-dom@19.2.3_@typ_41033ef40504844615e138b3524ee95a/node_modules/@modelcontextprotocol/inspector/node_modules:/home/runner/work/skybridge/skybridge/node_modules/.pnpm/@modelcontextprotocol+inspector@0.19.0_@types+node@24.10.9_@types+react-dom@19.2.3_@typ_41033ef40504844615e138b3524ee95a/node_modules/@modelcontextprotocol/node_modules:/home/runner/work/skybridge/skybridge/node_modules/.pnpm/@modelcontextprotocol+inspector@0.19.0_@types+node@24.10.9_@types+react-dom@19.2.3_@typ_41033ef40504844615e138b3524ee95a/node_modules:/home/runner/work/skybridge/skybridge/node_modules/.pnpm/node_modules"
14
14
  else
15
- export NODE_PATH="/home/runner/work/skybridge/skybridge/node_modules/.pnpm/@modelcontextprotocol+inspector@0.17.5_@types+node@22.18.12_@types+react-dom@19.2.3_@ty_960011790b33063d7255347351a0cc44/node_modules/@modelcontextprotocol/inspector/cli/build/node_modules:/home/runner/work/skybridge/skybridge/node_modules/.pnpm/@modelcontextprotocol+inspector@0.17.5_@types+node@22.18.12_@types+react-dom@19.2.3_@ty_960011790b33063d7255347351a0cc44/node_modules/@modelcontextprotocol/inspector/cli/node_modules:/home/runner/work/skybridge/skybridge/node_modules/.pnpm/@modelcontextprotocol+inspector@0.17.5_@types+node@22.18.12_@types+react-dom@19.2.3_@ty_960011790b33063d7255347351a0cc44/node_modules/@modelcontextprotocol/inspector/node_modules:/home/runner/work/skybridge/skybridge/node_modules/.pnpm/@modelcontextprotocol+inspector@0.17.5_@types+node@22.18.12_@types+react-dom@19.2.3_@ty_960011790b33063d7255347351a0cc44/node_modules/@modelcontextprotocol/node_modules:/home/runner/work/skybridge/skybridge/node_modules/.pnpm/@modelcontextprotocol+inspector@0.17.5_@types+node@22.18.12_@types+react-dom@19.2.3_@ty_960011790b33063d7255347351a0cc44/node_modules:/home/runner/work/skybridge/skybridge/node_modules/.pnpm/node_modules:$NODE_PATH"
15
+ export NODE_PATH="/home/runner/work/skybridge/skybridge/node_modules/.pnpm/@modelcontextprotocol+inspector@0.19.0_@types+node@24.10.9_@types+react-dom@19.2.3_@typ_41033ef40504844615e138b3524ee95a/node_modules/@modelcontextprotocol/inspector/cli/build/node_modules:/home/runner/work/skybridge/skybridge/node_modules/.pnpm/@modelcontextprotocol+inspector@0.19.0_@types+node@24.10.9_@types+react-dom@19.2.3_@typ_41033ef40504844615e138b3524ee95a/node_modules/@modelcontextprotocol/inspector/cli/node_modules:/home/runner/work/skybridge/skybridge/node_modules/.pnpm/@modelcontextprotocol+inspector@0.19.0_@types+node@24.10.9_@types+react-dom@19.2.3_@typ_41033ef40504844615e138b3524ee95a/node_modules/@modelcontextprotocol/inspector/node_modules:/home/runner/work/skybridge/skybridge/node_modules/.pnpm/@modelcontextprotocol+inspector@0.19.0_@types+node@24.10.9_@types+react-dom@19.2.3_@typ_41033ef40504844615e138b3524ee95a/node_modules/@modelcontextprotocol/node_modules:/home/runner/work/skybridge/skybridge/node_modules/.pnpm/@modelcontextprotocol+inspector@0.19.0_@types+node@24.10.9_@types+react-dom@19.2.3_@typ_41033ef40504844615e138b3524ee95a/node_modules:/home/runner/work/skybridge/skybridge/node_modules/.pnpm/node_modules:$NODE_PATH"
16
16
  fi
17
17
  if [ -x "$basedir/node" ]; then
18
18
  exec "$basedir/node" "$basedir/../@modelcontextprotocol/inspector/cli/build/cli.js" "$@"
package/template/node_modules/.bin/sb ADDED
@@ -0,0 +1,21 @@
1
+ #!/bin/sh
2
+ basedir=$(dirname "$(echo "$0" | sed -e 's,\\,/,g')")
3
+
4
+ case `uname` in
5
+ *CYGWIN*|*MINGW*|*MSYS*)
6
+ if command -v cygpath > /dev/null 2>&1; then
7
+ basedir=`cygpath -w "$basedir"`
8
+ fi
9
+ ;;
10
+ esac
11
+
12
+ if [ -z "$NODE_PATH" ]; then
13
+ export NODE_PATH="/home/runner/work/skybridge/skybridge/node_modules/.pnpm/skybridge@0.26.1_@modelcontextprotocol+sdk@1.25.3_hono@4.11.3_zod@4.3.6__@types+node@24_c7270a9cc4659e222f0fb854cace474f/node_modules/skybridge/bin/node_modules:/home/runner/work/skybridge/skybridge/node_modules/.pnpm/skybridge@0.26.1_@modelcontextprotocol+sdk@1.25.3_hono@4.11.3_zod@4.3.6__@types+node@24_c7270a9cc4659e222f0fb854cace474f/node_modules/skybridge/node_modules:/home/runner/work/skybridge/skybridge/node_modules/.pnpm/skybridge@0.26.1_@modelcontextprotocol+sdk@1.25.3_hono@4.11.3_zod@4.3.6__@types+node@24_c7270a9cc4659e222f0fb854cace474f/node_modules:/home/runner/work/skybridge/skybridge/node_modules/.pnpm/node_modules"
14
+ else
15
+ export NODE_PATH="/home/runner/work/skybridge/skybridge/node_modules/.pnpm/skybridge@0.26.1_@modelcontextprotocol+sdk@1.25.3_hono@4.11.3_zod@4.3.6__@types+node@24_c7270a9cc4659e222f0fb854cace474f/node_modules/skybridge/bin/node_modules:/home/runner/work/skybridge/skybridge/node_modules/.pnpm/skybridge@0.26.1_@modelcontextprotocol+sdk@1.25.3_hono@4.11.3_zod@4.3.6__@types+node@24_c7270a9cc4659e222f0fb854cace474f/node_modules/skybridge/node_modules:/home/runner/work/skybridge/skybridge/node_modules/.pnpm/skybridge@0.26.1_@modelcontextprotocol+sdk@1.25.3_hono@4.11.3_zod@4.3.6__@types+node@24_c7270a9cc4659e222f0fb854cace474f/node_modules:/home/runner/work/skybridge/skybridge/node_modules/.pnpm/node_modules:$NODE_PATH"
16
+ fi
17
+ if [ -x "$basedir/node" ]; then
18
+ exec "$basedir/node" "$basedir/../skybridge/bin/run.js" "$@"
19
+ else
20
+ exec node "$basedir/../skybridge/bin/run.js" "$@"
21
+ fi
package/template/node_modules/.bin/skybridge ADDED
@@ -0,0 +1,21 @@
1
+ #!/bin/sh
2
+ basedir=$(dirname "$(echo "$0" | sed -e 's,\\,/,g')")
3
+
4
+ case `uname` in
5
+ *CYGWIN*|*MINGW*|*MSYS*)
6
+ if command -v cygpath > /dev/null 2>&1; then
7
+ basedir=`cygpath -w "$basedir"`
8
+ fi
9
+ ;;
10
+ esac
11
+
12
+ if [ -z "$NODE_PATH" ]; then
13
+ export NODE_PATH="/home/runner/work/skybridge/skybridge/node_modules/.pnpm/skybridge@0.26.1_@modelcontextprotocol+sdk@1.25.3_hono@4.11.3_zod@4.3.6__@types+node@24_c7270a9cc4659e222f0fb854cace474f/node_modules/skybridge/bin/node_modules:/home/runner/work/skybridge/skybridge/node_modules/.pnpm/skybridge@0.26.1_@modelcontextprotocol+sdk@1.25.3_hono@4.11.3_zod@4.3.6__@types+node@24_c7270a9cc4659e222f0fb854cace474f/node_modules/skybridge/node_modules:/home/runner/work/skybridge/skybridge/node_modules/.pnpm/skybridge@0.26.1_@modelcontextprotocol+sdk@1.25.3_hono@4.11.3_zod@4.3.6__@types+node@24_c7270a9cc4659e222f0fb854cace474f/node_modules:/home/runner/work/skybridge/skybridge/node_modules/.pnpm/node_modules"
14
+ else
15
+ export NODE_PATH="/home/runner/work/skybridge/skybridge/node_modules/.pnpm/skybridge@0.26.1_@modelcontextprotocol+sdk@1.25.3_hono@4.11.3_zod@4.3.6__@types+node@24_c7270a9cc4659e222f0fb854cace474f/node_modules/skybridge/bin/node_modules:/home/runner/work/skybridge/skybridge/node_modules/.pnpm/skybridge@0.26.1_@modelcontextprotocol+sdk@1.25.3_hono@4.11.3_zod@4.3.6__@types+node@24_c7270a9cc4659e222f0fb854cace474f/node_modules/skybridge/node_modules:/home/runner/work/skybridge/skybridge/node_modules/.pnpm/skybridge@0.26.1_@modelcontextprotocol+sdk@1.25.3_hono@4.11.3_zod@4.3.6__@types+node@24_c7270a9cc4659e222f0fb854cace474f/node_modules:/home/runner/work/skybridge/skybridge/node_modules/.pnpm/node_modules:$NODE_PATH"
16
+ fi
17
+ if [ -x "$basedir/node" ]; then
18
+ exec "$basedir/node" "$basedir/../skybridge/bin/run.js" "$@"
19
+ else
20
+ exec node "$basedir/../skybridge/bin/run.js" "$@"
21
+ fi
package/template/node_modules/.bin/vite CHANGED
@@ -10,9 +10,9 @@ case `uname` in
10
10
  esac
11
11
 
12
12
  if [ -z "$NODE_PATH" ]; then
13
- export NODE_PATH="/home/runner/work/skybridge/skybridge/node_modules/.pnpm/vite@7.2.7_@types+node@22.18.12_jiti@2.6.1_lightningcss@1.30.2_terser@5.44.1_tsx@4.21.0/node_modules/vite/bin/node_modules:/home/runner/work/skybridge/skybridge/node_modules/.pnpm/vite@7.2.7_@types+node@22.18.12_jiti@2.6.1_lightningcss@1.30.2_terser@5.44.1_tsx@4.21.0/node_modules/vite/node_modules:/home/runner/work/skybridge/skybridge/node_modules/.pnpm/vite@7.2.7_@types+node@22.18.12_jiti@2.6.1_lightningcss@1.30.2_terser@5.44.1_tsx@4.21.0/node_modules:/home/runner/work/skybridge/skybridge/node_modules/.pnpm/node_modules"
13
+ export NODE_PATH="/home/runner/work/skybridge/skybridge/node_modules/.pnpm/vite@7.3.1_@types+node@24.10.9_jiti@2.6.1_lightningcss@1.30.2_terser@5.44.1_tsx@4.21.0_yaml@2.8.2/node_modules/vite/bin/node_modules:/home/runner/work/skybridge/skybridge/node_modules/.pnpm/vite@7.3.1_@types+node@24.10.9_jiti@2.6.1_lightningcss@1.30.2_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@7.3.1_@types+node@24.10.9_jiti@2.6.1_lightningcss@1.30.2_terser@5.44.1_tsx@4.21.0_yaml@2.8.2/node_modules:/home/runner/work/skybridge/skybridge/node_modules/.pnpm/node_modules"
14
14
  else
15
- export NODE_PATH="/home/runner/work/skybridge/skybridge/node_modules/.pnpm/vite@7.2.7_@types+node@22.18.12_jiti@2.6.1_lightningcss@1.30.2_terser@5.44.1_tsx@4.21.0/node_modules/vite/bin/node_modules:/home/runner/work/skybridge/skybridge/node_modules/.pnpm/vite@7.2.7_@types+node@22.18.12_jiti@2.6.1_lightningcss@1.30.2_terser@5.44.1_tsx@4.21.0/node_modules/vite/node_modules:/home/runner/work/skybridge/skybridge/node_modules/.pnpm/vite@7.2.7_@types+node@22.18.12_jiti@2.6.1_lightningcss@1.30.2_terser@5.44.1_tsx@4.21.0/node_modules:/home/runner/work/skybridge/skybridge/node_modules/.pnpm/node_modules:$NODE_PATH"
15
+ export NODE_PATH="/home/runner/work/skybridge/skybridge/node_modules/.pnpm/vite@7.3.1_@types+node@24.10.9_jiti@2.6.1_lightningcss@1.30.2_terser@5.44.1_tsx@4.21.0_yaml@2.8.2/node_modules/vite/bin/node_modules:/home/runner/work/skybridge/skybridge/node_modules/.pnpm/vite@7.3.1_@types+node@24.10.9_jiti@2.6.1_lightningcss@1.30.2_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@7.3.1_@types+node@24.10.9_jiti@2.6.1_lightningcss@1.30.2_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"
16
16
  fi
17
17
  if [ -x "$basedir/node" ]; then
18
18
  exec "$basedir/node" "$basedir/../vite/bin/vite.js" "$@"
package/template/package.json CHANGED
@@ -5,35 +5,34 @@
5
5
  "description": "Alpic MCP Server Template",
6
6
  "type": "module",
7
7
  "scripts": {
8
- "dev": "nodemon",
9
- "build": "vite build -c web/vite.config.ts && shx rm -rf server/dist && tsc -p tsconfig.server.json && shx cp -r web/dist server/dist/assets",
10
- "start": "node server/dist/index.js",
11
- "inspector": "mcp-inspector http://localhost:3000/mcp",
12
- "server:build": "tsc -p tsconfig.server.json",
13
- "server:start": "node server/dist/index.js",
14
- "web:build": "tsc -b web && vite build -c web/vite.config.ts",
15
- "web:preview": "vite preview -c web/vite.config.ts"
8
+ "dev": "skybridge dev",
9
+ "build": "skybridge build",
10
+ "start": "skybridge start",
11
+ "inspector": "mcp-inspector http://localhost:3000/mcp"
16
12
  },
17
13
  "dependencies": {
18
- "@modelcontextprotocol/sdk": "^1.24.3",
19
- "express": "^5.1.0",
20
- "react": "^19.1.1",
21
- "react-dom": "^19.1.1",
22
- "skybridge": "^0.15.3",
23
- "vite": "^7.1.11",
24
- "zod": "^4.1.13"
14
+ "@modelcontextprotocol/sdk": "^1.25.3",
15
+ "cors": "^2.8.6",
16
+ "express": "^5.2.1",
17
+ "react": "^19.2.4",
18
+ "react-dom": "^19.2.4",
19
+ "skybridge": ">=0.26.1 <1.0.0",
20
+ "vite": "^7.3.1",
21
+ "zod": "^4.3.6"
25
22
  },
26
23
  "devDependencies": {
27
- "@modelcontextprotocol/inspector": "^0.17.5",
28
- "@types/express": "^5.0.3",
29
- "@types/node": "^22.15.30",
30
- "@types/react": "^19.1.16",
31
- "@types/react-dom": "^19.1.9",
32
- "@vitejs/plugin-react": "^5.0.4",
33
- "nodemon": "^3.1.10",
34
- "shx": "^0.3.4",
35
- "tsx": "^4.19.4",
36
- "typescript": "^5.7.2"
24
+ "@modelcontextprotocol/inspector": "^0.19.0",
25
+ "@skybridge/devtools": ">=0.26.1 <1.0.0",
26
+ "@types/cors": "^2.8.19",
27
+ "@types/express": "^5.0.6",
28
+ "@types/react": "^19.2.10",
29
+ "@types/react-dom": "^19.2.3",
30
+ "@vitejs/plugin-react": "^5.1.2",
31
+ "nodemon": "^3.1.11",
32
+ "tsx": "^4.21.0",
33
+ "typescript": "^5.9.3"
37
34
  },
38
- "workspaces": []
35
+ "engines": {
36
+ "node": ">=24.13.0"
37
+ }
39
38
  }
package/template/server/src/index.ts CHANGED
@@ -1,6 +1,8 @@
1
+ import path from "node:path";
2
+ import { fileURLToPath } from "node:url";
3
+ import cors from "cors";
1
4
  import express, { type Express } from "express";
2
-
3
- import { devtoolsStaticServer, widgetsDevServer } from "skybridge/server";
5
+ import { widgetsDevServer } from "skybridge/server";
4
6
  import type { ViteDevServer } from "vite";
5
7
  import { mcp } from "./middleware.js";
6
8
  import server from "./server.js";
@@ -14,20 +16,24 @@ app.use(mcp(server));
14
16
  const env = process.env.NODE_ENV || "development";
15
17
 
16
18
  if (env !== "production") {
19
+ const { devtoolsStaticServer } = await import("@skybridge/devtools");
17
20
  app.use(await devtoolsStaticServer());
18
21
  app.use(await widgetsDevServer());
19
22
  }
20
23
 
24
+ if (env === "production") {
25
+ const __filename = fileURLToPath(import.meta.url);
26
+ const __dirname = path.dirname(__filename);
27
+
28
+ app.use("/assets", cors());
29
+ app.use("/assets", express.static(path.join(__dirname, "assets")));
30
+ }
31
+
21
32
  app.listen(3000, (error) => {
22
33
  if (error) {
23
34
  console.error("Failed to start server:", error);
24
35
  process.exit(1);
25
36
  }
26
-
27
- console.log(`Server listening on port 3000 - ${env}`);
28
- console.log(
29
- "Make your local server accessible with 'ngrok http 3000' and connect to ChatGPT with URL https://xxxxxx.ngrok-free.app/mcp",
30
- );
31
37
  });
32
38
 
33
39
  process.on("SIGINT", async () => {
package/template/server/src/server.ts CHANGED
@@ -3,10 +3,6 @@ import { z } from "zod";
3
3
 
4
4
  const Answers = [
5
5
  "As I see it, yes",
6
- "Ask again later",
7
- "Better not tell you now",
8
- "Cannot predict now",
9
- "Concentrate and ask again",
10
6
  "Don't count on it",
11
7
  "It is certain",
12
8
  "It is decidedly so",
@@ -15,7 +11,6 @@ const Answers = [
15
11
  "My sources say no",
16
12
  "Outlook good",
17
13
  "Outlook not so good",
18
- "Reply hazy, try again",
19
14
  "Signs point to yes",
20
15
  "Very doubtful",
21
16
  "Without a doubt",
package/template/tsconfig.server.json CHANGED
@@ -2,7 +2,7 @@
2
2
  "extends": "./tsconfig.json",
3
3
  "compilerOptions": {
4
4
  "noEmit": false,
5
- "outDir": "server/dist",
5
+ "outDir": "dist",
6
6
  "sourceMap": true,
7
7
  "declaration": true
8
8
  },
package/template/web/src/index.css CHANGED
@@ -1,12 +1,20 @@
1
+ @import url("https://fonts.googleapis.com/css2?family=Playfair+Display:ital,wght@1,600&display=swap");
2
+
1
3
  .container {
2
4
  display: flex;
3
5
  justify-content: center;
4
6
  align-items: center;
5
7
  height: 100%;
8
+ padding: 1rem;
6
9
  }
7
10
 
8
11
  .ball {
9
- background-color: black;
12
+ background: radial-gradient(
13
+ circle at 30% 30%,
14
+ #454565 0%,
15
+ #1c1c30 40%,
16
+ #0a0a10 100%
17
+ );
10
18
  border-radius: 50%;
11
19
  width: 12rem;
12
20
  height: 12rem;
@@ -15,16 +23,129 @@
15
23
  align-items: center;
16
24
  justify-content: center;
17
25
  font-family: monospace;
26
+ text-align: center;
27
+ position: relative;
28
+ box-shadow:
29
+ 0 10px 30px rgba(0, 0, 0, 0.5),
30
+ 0 5px 15px rgba(0, 0, 0, 0.3),
31
+ inset 0 -20px 40px rgba(0, 0, 0, 0.6);
32
+ animation:
33
+ float 3s ease-in-out infinite,
34
+ colorShift 15s ease-in-out infinite;
35
+ transition: transform 0.3s ease;
36
+ cursor: pointer;
37
+ border: 1px solid rgba(30, 30, 50, 0.6);
38
+ }
39
+
40
+ .ball:hover {
41
+ transform: scale(1.05) translateY(-8px);
42
+ animation: colorShift 15s ease-in-out infinite;
43
+ box-shadow:
44
+ 0 20px 50px rgba(0, 0, 0, 0.6),
45
+ 0 10px 25px rgba(0, 0, 0, 0.4),
46
+ inset 0 -20px 40px rgba(0, 0, 0, 0.6);
47
+ }
48
+
49
+ @keyframes float {
50
+ 0%,
51
+ 100% {
52
+ transform: translateY(0);
53
+ }
54
+ 50% {
55
+ transform: translateY(-8px);
56
+ }
57
+ }
58
+
59
+ @keyframes colorShift {
60
+ 0%,
61
+ 100% {
62
+ background: radial-gradient(
63
+ circle at 30% 30%,
64
+ #454565 0%,
65
+ #1c1c30 40%,
66
+ #0a0a10 100%
67
+ );
68
+ }
69
+ 25% {
70
+ background: radial-gradient(
71
+ circle at 30% 30%,
72
+ #3f4a65 0%,
73
+ #181e30 40%,
74
+ #090a10 100%
75
+ );
76
+ }
77
+ 50% {
78
+ background: radial-gradient(
79
+ circle at 30% 30%,
80
+ #3a5065 0%,
81
+ #152230 40%,
82
+ #080a10 100%
83
+ );
84
+ }
85
+ 75% {
86
+ background: radial-gradient(
87
+ circle at 30% 30%,
88
+ #3f4a65 0%,
89
+ #181e30 40%,
90
+ #090a10 100%
91
+ );
92
+ }
93
+ }
94
+
95
+ .ball::before {
96
+ content: "";
97
+ position: absolute;
98
+ top: 8%;
99
+ left: 20%;
100
+ width: 30%;
101
+ height: 20%;
102
+ background: radial-gradient(
103
+ ellipse,
104
+ rgba(255, 255, 255, 0.3) 0%,
105
+ transparent 70%
106
+ );
107
+ border-radius: 50%;
108
+ pointer-events: none;
109
+ }
110
+
111
+ .ball::after {
112
+ content: "";
113
+ position: absolute;
114
+ bottom: 8%;
115
+ right: 25%;
116
+ width: 25%;
117
+ height: 10%;
118
+ background: radial-gradient(
119
+ ellipse,
120
+ rgba(255, 255, 255, 0.1) 0%,
121
+ transparent 70%
122
+ );
123
+ border-radius: 50%;
124
+ pointer-events: none;
18
125
  }
19
126
 
20
127
  .question {
21
- font-size: 0.75rem;
128
+ font-size: clamp(0.5rem, 2vw, 0.75rem);
22
129
  color: lightgrey;
130
+ max-width: 90%;
131
+ word-wrap: break-word;
132
+ overflow-wrap: break-word;
133
+ text-align: center;
134
+ line-height: 1.3;
135
+ font-style: italic;
23
136
  }
24
137
 
25
138
  .answer {
26
- font-size: 1.125rem;
27
- font-weight: bold;
139
+ font-family: "Playfair Display", serif;
140
+ font-style: italic;
141
+ font-size: 1.25rem;
142
+ font-weight: 600;
28
143
  margin-top: 0.5rem;
29
- color: aqua;
144
+ color: #7dd3fc;
145
+ text-shadow: 0 0 10px rgba(125, 211, 252, 0.5);
146
+ max-width: 90%;
147
+ word-wrap: break-word;
148
+ overflow-wrap: break-word;
149
+ text-align: center;
150
+ line-height: 1.3;
30
151
  }
package/template/web/vite.config.ts CHANGED
@@ -1,11 +1,11 @@
1
1
  import path from "node:path";
2
2
  import react from "@vitejs/plugin-react";
3
3
  import { skybridge } from "skybridge/web";
4
- import { defineConfig } from "vite";
4
+ import { defineConfig, type PluginOption } from "vite";
5
5
 
6
6
  // https://vite.dev/config/
7
7
  export default defineConfig({
8
- plugins: [skybridge(), react()],
8
+ plugins: [skybridge() as PluginOption, react()],
9
9
  root: __dirname,
10
10
  resolve: {
11
11
  alias: {
package/template/node_modules/.bin/shx DELETED
@@ -1,21 +0,0 @@
1
- #!/bin/sh
2
- basedir=$(dirname "$(echo "$0" | sed -e 's,\\,/,g')")
3
-
4
- case `uname` in
5
- *CYGWIN*|*MINGW*|*MSYS*)
6
- if command -v cygpath > /dev/null 2>&1; then
7
- basedir=`cygpath -w "$basedir"`
8
- fi
9
- ;;
10
- esac
11
-
12
- if [ -z "$NODE_PATH" ]; then
13
- export NODE_PATH="/home/runner/work/skybridge/skybridge/node_modules/.pnpm/shx@0.3.4/node_modules/shx/lib/node_modules:/home/runner/work/skybridge/skybridge/node_modules/.pnpm/shx@0.3.4/node_modules/shx/node_modules:/home/runner/work/skybridge/skybridge/node_modules/.pnpm/shx@0.3.4/node_modules:/home/runner/work/skybridge/skybridge/node_modules/.pnpm/node_modules"
14
- else
15
- export NODE_PATH="/home/runner/work/skybridge/skybridge/node_modules/.pnpm/shx@0.3.4/node_modules/shx/lib/node_modules:/home/runner/work/skybridge/skybridge/node_modules/.pnpm/shx@0.3.4/node_modules/shx/node_modules:/home/runner/work/skybridge/skybridge/node_modules/.pnpm/shx@0.3.4/node_modules:/home/runner/work/skybridge/skybridge/node_modules/.pnpm/node_modules:$NODE_PATH"
16
- fi
17
- if [ -x "$basedir/node" ]; then
18
- exec "$basedir/node" "$basedir/../shx/lib/cli.js" "$@"
19
- else
20
- exec node "$basedir/../shx/lib/cli.js" "$@"
21
- fi
package/template/pnpm-workspace.yaml DELETED
@@ -1,8 +0,0 @@
1
- packages:
2
- - "web"
3
- - "server"
4
- sharedWorkspaceLockfile: false
5
-
6
- catalog:
7
- skybridge: ^0.13.1
8
- "@skybridge/devtools": ^0.13.1
package/template/server/package.json DELETED
@@ -1,33 +0,0 @@
1
- {
2
- "name": "@apps-sdk-template/server",
3
- "version": "0.0.1",
4
- "private": true,
5
- "main": "dist/index.js",
6
- "description": "Alpic MCP Server Template",
7
- "files": [
8
- "dist"
9
- ],
10
- "type": "module",
11
- "scripts": {
12
- "dev": "nodemon",
13
- "build": "tsc",
14
- "start": "node dist/index.js",
15
- "inspector": "mcp-inspector http://localhost:3000/mcp"
16
- },
17
- "dependencies": {
18
- "@modelcontextprotocol/sdk": "^1.24.3",
19
- "express": "^5.1.0",
20
- "skybridge": "catalog:",
21
- "@skybridge/devtools": "catalog:",
22
- "vite": "^7.1.11",
23
- "zod": "^4.1.13"
24
- },
25
- "devDependencies": {
26
- "@modelcontextprotocol/inspector": "^0.17.5",
27
- "@types/express": "^5.0.3",
28
- "@types/node": "^22.15.30",
29
- "nodemon": "^3.1.10",
30
- "tsx": "^4.19.2",
31
- "typescript": "^5.7.2"
32
- }
33
- }