create-skybridge 0.0.0-dev.4c4e617 → 0.0.0-dev.4d2439c

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 (22) hide show
  1. package/LICENSE +21 -0
  2. package/dist/index.js +80 -37
  3. package/dist/index.test.js +11 -1
  4. package/package.json +11 -12
  5. package/template/README.md +5 -5
  6. package/template/_gitignore +2 -1
  7. package/template/alpic.json +1 -2
  8. package/template/node_modules/.bin/mcp-inspector +2 -2
  9. package/template/node_modules/.bin/nodemon +0 -0
  10. package/template/node_modules/.bin/sb +21 -0
  11. package/template/node_modules/.bin/skybridge +21 -0
  12. package/template/node_modules/.bin/tsc +0 -0
  13. package/template/node_modules/.bin/tsserver +0 -0
  14. package/template/node_modules/.bin/tsx +0 -0
  15. package/template/node_modules/.bin/vite +2 -2
  16. package/template/package.json +25 -26
  17. package/template/server/src/index.ts +13 -6
  18. package/template/server/src/server.ts +0 -5
  19. package/template/tsconfig.server.json +1 -1
  20. package/template/web/src/index.css +130 -6
  21. package/template/web/vite.config.ts +2 -2
  22. package/template/node_modules/.bin/shx +0 -21
package/LICENSE ADDED
@@ -0,0 +1,21 @@
1
+ MIT License
2
+
3
+ Copyright (c) 2025 Alpic
4
+
5
+ Permission is hereby granted, free of charge, to any person obtaining a copy
6
+ of this software and associated documentation files (the "Software"), to deal
7
+ in the Software without restriction, including without limitation the rights
8
+ to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
9
+ copies of the Software, and to permit persons to whom the Software is
10
+ furnished to do so, subject to the following conditions:
11
+
12
+ The above copyright notice and this permission notice shall be included in all
13
+ copies or substantial portions of the Software.
14
+
15
+ THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
16
+ IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
17
+ FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
18
+ AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
19
+ LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
20
+ OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
21
+ SOFTWARE.
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,71 @@ 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
106
114
  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", "pnpm-workspace.yaml"].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}`);
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
+ }
144
+ try {
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
  }
128
- // 4. Ask about immediate installation
154
+ const userAgent = process.env.npm_config_user_agent;
155
+ const pkgManager = userAgent?.split(" ")[0]?.split("/")[0] || "npm";
156
+ // 4. Ask about skills installation
157
+ if (interactive) {
158
+ const skillsResult = await prompts.confirm({
159
+ message: "Install the coding agents skills? (recommended)",
160
+ initialValue: true,
161
+ });
162
+ if (prompts.isCancel(skillsResult)) {
163
+ return cancel();
164
+ }
165
+ if (skillsResult) {
166
+ run(["npx", "--yes", "skills", "add", "alpic-ai/skybridge", "-s", "chatgpt-app-builder"], {
167
+ stdio: "inherit",
168
+ cwd: targetDir,
169
+ });
170
+ }
171
+ }
172
+ // 5. Ask about immediate installation
129
173
  let immediate = argImmediate;
130
174
  if (immediate === undefined) {
131
175
  if (interactive) {
132
176
  const immediateResult = await prompts.confirm({
133
- message: `Install with pnpm and start now?`,
177
+ message: `Install with ${pkgManager} and start now?`,
134
178
  });
135
179
  if (prompts.isCancel(immediateResult)) {
136
180
  return cancel();
@@ -141,8 +185,20 @@ export async function init(args = process.argv.slice(2)) {
141
185
  immediate = false;
142
186
  }
143
187
  }
144
- const installCmd = ["pnpm", "install"];
145
- const runCmd = ["pnpm", "dev"];
188
+ const installCmd = [pkgManager, "install"];
189
+ const runCmd = [pkgManager];
190
+ switch (pkgManager) {
191
+ case "yarn":
192
+ case "pnpm":
193
+ case "bun":
194
+ break;
195
+ case "deno":
196
+ runCmd.push("task");
197
+ break;
198
+ default:
199
+ runCmd.push("run");
200
+ }
201
+ runCmd.push("dev");
146
202
  if (!immediate) {
147
203
  prompts.outro(`Done! Next steps:
148
204
  cd ${targetDir}
@@ -151,20 +207,7 @@ export async function init(args = process.argv.slice(2)) {
151
207
  `);
152
208
  return;
153
209
  }
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...`);
210
+ prompts.log.step(`Installing dependencies with ${pkgManager}...`);
168
211
  run(installCmd, {
169
212
  stdio: "inherit",
170
213
  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.4c4e617",
3
+ "version": "0.0.0-dev.4d2439c",
4
4
  "type": "module",
5
5
  "license": "MIT",
6
6
  "author": "Alpic",
@@ -16,21 +16,20 @@
16
16
  "dist",
17
17
  "template"
18
18
  ],
19
- "scripts": {
20
- "build": "tsc",
21
- "test": "pnpm run test:unit && pnpm run test:type && pnpm run test:format",
22
- "test:unit": "vitest run",
23
- "test:type": "tsc --noEmit",
24
- "test:format": "biome ci",
25
- "prepublishOnly": "pnpm run build"
26
- },
27
19
  "dependencies": {
28
20
  "@clack/prompts": "^0.11.0",
21
+ "giget": "^2.0.0",
29
22
  "mri": "^1.2.0"
30
23
  },
31
24
  "devDependencies": {
32
- "@types/node": "^25.0.3",
33
25
  "typescript": "^5.9.3",
34
- "vitest": "^2.1.9"
26
+ "vitest": "^4.0.17"
27
+ },
28
+ "scripts": {
29
+ "build": "tsc",
30
+ "test": "pnpm run test:unit && pnpm run test:type && pnpm run test:format",
31
+ "test:unit": "vitest run",
32
+ "test:type": "tsc --noEmit",
33
+ "test:format": "biome ci"
35
34
  }
36
- }
35
+ }
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.18.0_@types+node@25.0.3_@types+react-dom@19.2.3_@type_4be4554909ca0a790f3ece65616617d1/node_modules/@modelcontextprotocol/inspector/cli/build/node_modules:/home/runner/work/skybridge/skybridge/node_modules/.pnpm/@modelcontextprotocol+inspector@0.18.0_@types+node@25.0.3_@types+react-dom@19.2.3_@type_4be4554909ca0a790f3ece65616617d1/node_modules/@modelcontextprotocol/inspector/cli/node_modules:/home/runner/work/skybridge/skybridge/node_modules/.pnpm/@modelcontextprotocol+inspector@0.18.0_@types+node@25.0.3_@types+react-dom@19.2.3_@type_4be4554909ca0a790f3ece65616617d1/node_modules/@modelcontextprotocol/inspector/node_modules:/home/runner/work/skybridge/skybridge/node_modules/.pnpm/@modelcontextprotocol+inspector@0.18.0_@types+node@25.0.3_@types+react-dom@19.2.3_@type_4be4554909ca0a790f3ece65616617d1/node_modules/@modelcontextprotocol/node_modules:/home/runner/work/skybridge/skybridge/node_modules/.pnpm/@modelcontextprotocol+inspector@0.18.0_@types+node@25.0.3_@types+react-dom@19.2.3_@type_4be4554909ca0a790f3ece65616617d1/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.18.0_@types+node@25.0.3_@types+react-dom@19.2.3_@type_4be4554909ca0a790f3ece65616617d1/node_modules/@modelcontextprotocol/inspector/cli/build/node_modules:/home/runner/work/skybridge/skybridge/node_modules/.pnpm/@modelcontextprotocol+inspector@0.18.0_@types+node@25.0.3_@types+react-dom@19.2.3_@type_4be4554909ca0a790f3ece65616617d1/node_modules/@modelcontextprotocol/inspector/cli/node_modules:/home/runner/work/skybridge/skybridge/node_modules/.pnpm/@modelcontextprotocol+inspector@0.18.0_@types+node@25.0.3_@types+react-dom@19.2.3_@type_4be4554909ca0a790f3ece65616617d1/node_modules/@modelcontextprotocol/inspector/node_modules:/home/runner/work/skybridge/skybridge/node_modules/.pnpm/@modelcontextprotocol+inspector@0.18.0_@types+node@25.0.3_@types+react-dom@19.2.3_@type_4be4554909ca0a790f3ece65616617d1/node_modules/@modelcontextprotocol/node_modules:/home/runner/work/skybridge/skybridge/node_modules/.pnpm/@modelcontextprotocol+inspector@0.18.0_@types+node@25.0.3_@types+react-dom@19.2.3_@type_4be4554909ca0a790f3ece65616617d1/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/nodemon CHANGED
File without changes
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.2_hono@4.11.3_zod@4.3.5__@types+node@25_735eb51dc660b44c8f8bd4f7ce48a0d2/node_modules/skybridge/bin/node_modules:/home/runner/work/skybridge/skybridge/node_modules/.pnpm/skybridge@0.26.1_@modelcontextprotocol+sdk@1.25.2_hono@4.11.3_zod@4.3.5__@types+node@25_735eb51dc660b44c8f8bd4f7ce48a0d2/node_modules/skybridge/node_modules:/home/runner/work/skybridge/skybridge/node_modules/.pnpm/skybridge@0.26.1_@modelcontextprotocol+sdk@1.25.2_hono@4.11.3_zod@4.3.5__@types+node@25_735eb51dc660b44c8f8bd4f7ce48a0d2/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.2_hono@4.11.3_zod@4.3.5__@types+node@25_735eb51dc660b44c8f8bd4f7ce48a0d2/node_modules/skybridge/bin/node_modules:/home/runner/work/skybridge/skybridge/node_modules/.pnpm/skybridge@0.26.1_@modelcontextprotocol+sdk@1.25.2_hono@4.11.3_zod@4.3.5__@types+node@25_735eb51dc660b44c8f8bd4f7ce48a0d2/node_modules/skybridge/node_modules:/home/runner/work/skybridge/skybridge/node_modules/.pnpm/skybridge@0.26.1_@modelcontextprotocol+sdk@1.25.2_hono@4.11.3_zod@4.3.5__@types+node@25_735eb51dc660b44c8f8bd4f7ce48a0d2/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.2_hono@4.11.3_zod@4.3.5__@types+node@25_735eb51dc660b44c8f8bd4f7ce48a0d2/node_modules/skybridge/bin/node_modules:/home/runner/work/skybridge/skybridge/node_modules/.pnpm/skybridge@0.26.1_@modelcontextprotocol+sdk@1.25.2_hono@4.11.3_zod@4.3.5__@types+node@25_735eb51dc660b44c8f8bd4f7ce48a0d2/node_modules/skybridge/node_modules:/home/runner/work/skybridge/skybridge/node_modules/.pnpm/skybridge@0.26.1_@modelcontextprotocol+sdk@1.25.2_hono@4.11.3_zod@4.3.5__@types+node@25_735eb51dc660b44c8f8bd4f7ce48a0d2/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.2_hono@4.11.3_zod@4.3.5__@types+node@25_735eb51dc660b44c8f8bd4f7ce48a0d2/node_modules/skybridge/bin/node_modules:/home/runner/work/skybridge/skybridge/node_modules/.pnpm/skybridge@0.26.1_@modelcontextprotocol+sdk@1.25.2_hono@4.11.3_zod@4.3.5__@types+node@25_735eb51dc660b44c8f8bd4f7ce48a0d2/node_modules/skybridge/node_modules:/home/runner/work/skybridge/skybridge/node_modules/.pnpm/skybridge@0.26.1_@modelcontextprotocol+sdk@1.25.2_hono@4.11.3_zod@4.3.5__@types+node@25_735eb51dc660b44c8f8bd4f7ce48a0d2/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/tsc CHANGED
File without changes
package/template/node_modules/.bin/tsserver CHANGED
File without changes
package/template/node_modules/.bin/tsx CHANGED
File without changes
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@25.0.3_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@25.0.3_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@25.0.3_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@25.0.3_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@25.0.3_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@25.0.3_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.2",
15
+ "cors": "^2.8.5",
16
+ "express": "^5.2.1",
17
+ "react": "^19.2.3",
18
+ "react-dom": "^19.2.3",
19
+ "skybridge": ">=0.26.1 <1.0.0",
20
+ "vite": "^7.3.1",
21
+ "zod": "^4.3.5"
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.18.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.8",
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,5 +1,7 @@
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
5
  import { widgetsDevServer } from "skybridge/server";
4
6
  import type { ViteDevServer } from "vite";
5
7
  import { mcp } from "./middleware.js";
@@ -14,19 +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");
20
+ app.use(await devtoolsStaticServer());
17
21
  app.use(await widgetsDevServer());
18
22
  }
19
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
+
20
32
  app.listen(3000, (error) => {
21
33
  if (error) {
22
34
  console.error("Failed to start server:", error);
23
35
  process.exit(1);
24
36
  }
25
-
26
- console.log(`Server listening on port 3000 - ${env}`);
27
- console.log(
28
- "Make your local server accessible with 'ngrok http 3000' and connect to ChatGPT with URL https://xxxxxx.ngrok-free.app/mcp",
29
- );
30
37
  });
31
38
 
32
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,23 @@
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
- height: 100%;
7
+ min-height: 100%;
8
+ max-height: 100%;
9
+ overflow: hidden;
10
+ padding: 1rem;
11
+ box-sizing: border-box;
6
12
  }
7
13
 
8
14
  .ball {
9
- background-color: black;
15
+ background: radial-gradient(
16
+ circle at 30% 30%,
17
+ #454565 0%,
18
+ #1c1c30 40%,
19
+ #0a0a10 100%
20
+ );
10
21
  border-radius: 50%;
11
22
  width: 12rem;
12
23
  height: 12rem;
@@ -15,16 +26,129 @@
15
26
  align-items: center;
16
27
  justify-content: center;
17
28
  font-family: monospace;
29
+ text-align: center;
30
+ position: relative;
31
+ box-shadow:
32
+ 0 10px 30px rgba(0, 0, 0, 0.5),
33
+ 0 5px 15px rgba(0, 0, 0, 0.3),
34
+ inset 0 -20px 40px rgba(0, 0, 0, 0.6);
35
+ animation:
36
+ float 3s ease-in-out infinite,
37
+ colorShift 15s ease-in-out infinite;
38
+ transition: transform 0.3s ease;
39
+ cursor: pointer;
40
+ border: 1px solid rgba(30, 30, 50, 0.6);
41
+ }
42
+
43
+ .ball:hover {
44
+ transform: scale(1.05) translateY(-8px);
45
+ animation: colorShift 15s ease-in-out infinite;
46
+ box-shadow:
47
+ 0 20px 50px rgba(0, 0, 0, 0.6),
48
+ 0 10px 25px rgba(0, 0, 0, 0.4),
49
+ inset 0 -20px 40px rgba(0, 0, 0, 0.6);
50
+ }
51
+
52
+ @keyframes float {
53
+ 0%,
54
+ 100% {
55
+ transform: translateY(0);
56
+ }
57
+ 50% {
58
+ transform: translateY(-8px);
59
+ }
60
+ }
61
+
62
+ @keyframes colorShift {
63
+ 0%,
64
+ 100% {
65
+ background: radial-gradient(
66
+ circle at 30% 30%,
67
+ #454565 0%,
68
+ #1c1c30 40%,
69
+ #0a0a10 100%
70
+ );
71
+ }
72
+ 25% {
73
+ background: radial-gradient(
74
+ circle at 30% 30%,
75
+ #3f4a65 0%,
76
+ #181e30 40%,
77
+ #090a10 100%
78
+ );
79
+ }
80
+ 50% {
81
+ background: radial-gradient(
82
+ circle at 30% 30%,
83
+ #3a5065 0%,
84
+ #152230 40%,
85
+ #080a10 100%
86
+ );
87
+ }
88
+ 75% {
89
+ background: radial-gradient(
90
+ circle at 30% 30%,
91
+ #3f4a65 0%,
92
+ #181e30 40%,
93
+ #090a10 100%
94
+ );
95
+ }
96
+ }
97
+
98
+ .ball::before {
99
+ content: "";
100
+ position: absolute;
101
+ top: 8%;
102
+ left: 20%;
103
+ width: 30%;
104
+ height: 20%;
105
+ background: radial-gradient(
106
+ ellipse,
107
+ rgba(255, 255, 255, 0.3) 0%,
108
+ transparent 70%
109
+ );
110
+ border-radius: 50%;
111
+ pointer-events: none;
112
+ }
113
+
114
+ .ball::after {
115
+ content: "";
116
+ position: absolute;
117
+ bottom: 8%;
118
+ right: 25%;
119
+ width: 25%;
120
+ height: 10%;
121
+ background: radial-gradient(
122
+ ellipse,
123
+ rgba(255, 255, 255, 0.1) 0%,
124
+ transparent 70%
125
+ );
126
+ border-radius: 50%;
127
+ pointer-events: none;
18
128
  }
19
129
 
20
130
  .question {
21
- font-size: 0.75rem;
131
+ font-size: clamp(0.5rem, 2vw, 0.75rem);
22
132
  color: lightgrey;
133
+ max-width: 90%;
134
+ word-wrap: break-word;
135
+ overflow-wrap: break-word;
136
+ text-align: center;
137
+ line-height: 1.3;
138
+ font-style: italic;
23
139
  }
24
140
 
25
141
  .answer {
26
- font-size: 1.125rem;
27
- font-weight: bold;
142
+ font-family: "Playfair Display", serif;
143
+ font-style: italic;
144
+ font-size: 1.25rem;
145
+ font-weight: 600;
28
146
  margin-top: 0.5rem;
29
- color: aqua;
147
+ color: #7dd3fc;
148
+ text-shadow: 0 0 10px rgba(125, 211, 252, 0.5);
149
+ max-width: 90%;
150
+ word-wrap: break-word;
151
+ overflow-wrap: break-word;
152
+ text-align: center;
153
+ line-height: 1.3;
30
154
  }
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