create-skybridge 0.0.0-dev.e38035c → 0.0.0-dev.e3ae7d5

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 (29) hide show
  1. package/dist/index.js +47 -63
  2. package/dist/index.test.js +11 -1
  3. package/package.json +5 -5
  4. package/template/README.md +4 -4
  5. package/template/_gitignore +5 -0
  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 +12 -16
  12. package/template/server/src/index.ts +13 -10
  13. package/template/tsconfig.server.json +1 -1
  14. package/template/web/src/index.css +125 -5
  15. package/template/web/vite.config.ts +2 -2
  16. package/template/node_modules/.bin/shx +0 -21
  17. package/template-ecom/README.md +0 -89
  18. package/template-ecom/alpic.json +0 -4
  19. package/template-ecom/nodemon.json +0 -5
  20. package/template-ecom/package.json +0 -40
  21. package/template-ecom/server/src/index.ts +0 -39
  22. package/template-ecom/server/src/middleware.ts +0 -54
  23. package/template-ecom/server/src/server.ts +0 -73
  24. package/template-ecom/tsconfig.json +0 -23
  25. package/template-ecom/tsconfig.server.json +0 -11
  26. package/template-ecom/web/src/helpers.ts +0 -4
  27. package/template-ecom/web/src/index.css +0 -194
  28. package/template-ecom/web/src/widgets/ecom-carousel.tsx +0 -181
  29. package/template-ecom/web/vite.config.ts +0 -15
package/dist/index.js CHANGED
@@ -3,12 +3,9 @@ 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
8
  const defaultProjectName = "skybridge-project";
8
- const templates = [
9
- { value: "default", label: "a minimal implementation" },
10
- { value: "ecom", label: "a functional ecommerce carousel" },
11
- ];
12
9
  // prettier-ignore
13
10
  const helpMessage = `\
14
11
  Usage: create-skybridge [OPTION]... [DIRECTORY]
@@ -17,28 +14,32 @@ Create a new Skybridge project by copying the starter template.
17
14
 
18
15
  Options:
19
16
  -h, --help show this help message
17
+ --repo <uri> use a git repository instead of the built-in template
20
18
  --overwrite remove existing files in target directory
21
19
  --immediate install dependencies and start development server
22
- --template <template> use a specific template
23
20
 
24
- Available templates:
25
- ${templates.map((t) => ` ${t.value.padEnd(23)} ${t.label}`).join("\n")}
21
+ Repository URI formats:
22
+ github:user/repo
23
+ gitlab:user/repo/subdirectory
24
+ bitbucket:user/repo#branch
26
25
 
27
26
  Examples:
28
27
  create-skybridge my-app
28
+ create-skybridge my-app --repo github:alpic-ai/skybridge/examples/ecom-carousel
29
29
  create-skybridge . --overwrite --immediate
30
30
  `;
31
31
  export async function init(args = process.argv.slice(2)) {
32
32
  const argv = mri(args, {
33
33
  boolean: ["help", "overwrite", "immediate"],
34
- alias: { h: "help", t: "template" },
34
+ string: ["repo"],
35
+ alias: { h: "help" },
35
36
  });
36
37
  const argTargetDir = argv._[0]
37
38
  ? sanitizeTargetDir(String(argv._[0]))
38
39
  : undefined;
40
+ const argRepo = argv.repo;
39
41
  const argOverwrite = argv.overwrite;
40
42
  const argImmediate = argv.immediate;
41
- const argTemplate = argv.template;
42
43
  const help = argv.help;
43
44
  if (help) {
44
45
  console.log(helpMessage);
@@ -69,38 +70,7 @@ export async function init(args = process.argv.slice(2)) {
69
70
  targetDir = defaultProjectName;
70
71
  }
71
72
  }
72
- // 2. Select a template
73
- const hasInvalidTemplate = argTemplate && !templates.some((t) => t.value === argTemplate);
74
- let template = argTemplate;
75
- if (interactive) {
76
- if (!argTemplate || hasInvalidTemplate) {
77
- let message = "Please choose a template:";
78
- if (hasInvalidTemplate) {
79
- message = `${argTemplate} is not a valid template. Please choose one of the following:`;
80
- }
81
- template = await prompts.select({
82
- message,
83
- options: templates.map((t) => ({
84
- value: t.value,
85
- label: `${t.value}: ${t.label}`,
86
- })),
87
- });
88
- if (prompts.isCancel(template)) {
89
- return cancel();
90
- }
91
- }
92
- }
93
- else if (hasInvalidTemplate) {
94
- prompts.log.error(`Template is not a valid template. Please choose one of the following: ${templates.map((t) => t.value).join(", ")}`);
95
- process.exit(1);
96
- }
97
- let templatePath = "../template";
98
- switch (template) {
99
- case "ecom":
100
- templatePath = "../template-ecom";
101
- break;
102
- }
103
- // 3. Handle directory if exist and not empty
73
+ // 2. Handle directory if exist and not empty
104
74
  if (fs.existsSync(targetDir) && !isEmpty(targetDir)) {
105
75
  let overwrite = argOverwrite ? "yes" : undefined;
106
76
  if (!overwrite) {
@@ -140,36 +110,50 @@ export async function init(args = process.argv.slice(2)) {
140
110
  }
141
111
  }
142
112
  const root = path.join(process.cwd(), targetDir);
143
- // 4. Copy the template
144
- 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
+ }
145
144
  try {
146
- const templateDir = fileURLToPath(new URL(templatePath, import.meta.url));
147
- // Copy template to target directory
148
- fs.cpSync(templateDir, root, {
149
- recursive: true,
150
- filter: (src) => [".npmrc"].every((file) => !src.endsWith(file)),
151
- });
152
- // Write .gitignore
153
- fs.writeFileSync(path.join(root, ".gitignore"), `node_modules/
154
- dist/
155
- .env*
156
- .DS_store`);
157
- // Update project name in package.json
158
- const name = path.basename(root);
159
- const pkgPath = path.join(root, "package.json");
160
- const pkg = fs.readFileSync(pkgPath, "utf-8");
161
- const fixed = pkg.replace(/apps-sdk-template/g, name);
162
- fs.writeFileSync(pkgPath, fixed);
163
- 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`);
164
148
  }
165
149
  catch (error) {
166
- prompts.log.error("Failed to copy repository");
150
+ prompts.log.error("Failed to update project name in package.json");
167
151
  console.error(error);
168
152
  process.exit(1);
169
153
  }
170
154
  const userAgent = process.env.npm_config_user_agent;
171
155
  const pkgManager = userAgent?.split(" ")[0]?.split("/")[0] || "npm";
172
- // 5. Ask about immediate installation
156
+ // 4. Ask about immediate installation
173
157
  let immediate = argImmediate;
174
158
  if (immediate === undefined) {
175
159
  if (interactive) {
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.e38035c",
3
+ "version": "0.0.0-dev.e3ae7d5",
4
4
  "type": "module",
5
5
  "license": "MIT",
6
6
  "author": "Alpic",
@@ -14,19 +14,19 @@
14
14
  "files": [
15
15
  "index.js",
16
16
  "dist",
17
- "template",
18
- "template-ecom"
17
+ "template"
19
18
  ],
20
19
  "dependencies": {
21
20
  "@clack/prompts": "^0.11.0",
21
+ "giget": "^2.0.0",
22
22
  "mri": "^1.2.0"
23
23
  },
24
24
  "devDependencies": {
25
25
  "typescript": "^5.9.3",
26
- "vitest": "^4.0.16"
26
+ "vitest": "^4.0.17"
27
27
  },
28
28
  "scripts": {
29
- "build": "tsc && node copyExamples.js",
29
+ "build": "tsc",
30
30
  "test": "pnpm run test:unit && pnpm run test:type && pnpm run test:format",
31
31
  "test:unit": "vitest run",
32
32
  "test:type": "tsc --noEmit",
package/template/README.md CHANGED
@@ -1,6 +1,6 @@
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
 
@@ -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 ADDED
@@ -0,0 +1,5 @@
1
+ node_modules/
2
+ dist/
3
+ .env*
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.18.0_@types+node@25.0.3_@types+react-dom@19.2.3_@type_cfe96c348f18ba1e580ab58ea63930bf/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_cfe96c348f18ba1e580ab58ea63930bf/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_cfe96c348f18ba1e580ab58ea63930bf/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_cfe96c348f18ba1e580ab58ea63930bf/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_cfe96c348f18ba1e580ab58ea63930bf/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.18.0_@types+node@25.0.3_@types+react-dom@19.2.3_@type_cfe96c348f18ba1e580ab58ea63930bf/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_cfe96c348f18ba1e580ab58ea63930bf/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_cfe96c348f18ba1e580ab58ea63930bf/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_cfe96c348f18ba1e580ab58ea63930bf/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_cfe96c348f18ba1e580ab58ea63930bf/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/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/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.3.0_@types+node@25.0.3_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.3.0_@types+node@25.0.3_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.3.0_@types+node@25.0.3_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.3.0_@types+node@25.0.3_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.3.0_@types+node@25.0.3_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.3.0_@types+node@25.0.3_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,38 +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.25.1",
14
+ "@modelcontextprotocol/sdk": "^1.25.2",
15
+ "cors": "^2.8.5",
19
16
  "express": "^5.2.1",
20
17
  "react": "^19.2.3",
21
18
  "react-dom": "^19.2.3",
22
- "skybridge": ">=0.16.8 <1.0.0",
23
- "vite": "^7.3.0",
19
+ "skybridge": ">=0.26.1 <1.0.0",
20
+ "vite": "^7.3.1",
24
21
  "zod": "^4.3.5"
25
22
  },
26
23
  "devDependencies": {
27
24
  "@modelcontextprotocol/inspector": "^0.18.0",
28
- "@skybridge/devtools": ">=0.16.2 <1.0.0",
25
+ "@skybridge/devtools": ">=0.26.1 <1.0.0",
26
+ "@types/cors": "^2.8.19",
29
27
  "@types/express": "^5.0.6",
30
- "@types/react": "^19.2.7",
28
+ "@types/react": "^19.2.8",
31
29
  "@types/react-dom": "^19.2.3",
32
30
  "@vitejs/plugin-react": "^5.1.2",
33
31
  "nodemon": "^3.1.11",
34
- "shx": "^0.4.0",
35
32
  "tsx": "^4.21.0",
36
33
  "typescript": "^5.9.3"
37
34
  },
38
- "workspaces": [],
39
35
  "engines": {
40
- "node": ">=24.0.0"
36
+ "node": ">=24.13.0"
41
37
  }
42
38
  }
package/template/server/src/index.ts CHANGED
@@ -1,5 +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
- import { devtoolsStaticServer, widgetsDevServer } from "skybridge/server";
5
+ import { widgetsDevServer } from "skybridge/server";
3
6
  import type { ViteDevServer } from "vite";
4
7
  import { mcp } from "./middleware.js";
5
8
  import server from "./server.js";
@@ -13,24 +16,24 @@ app.use(mcp(server));
13
16
  const env = process.env.NODE_ENV || "development";
14
17
 
15
18
  if (env !== "production") {
19
+ const { devtoolsStaticServer } = await import("@skybridge/devtools");
16
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
-
31
- if (env !== "production") {
32
- console.log("Devtools available at http://localhost:3000");
33
- }
34
37
  });
35
38
 
36
39
  process.on("SIGINT", async () => {
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;
@@ -16,16 +24,128 @@
16
24
  justify-content: center;
17
25
  font-family: monospace;
18
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;
19
125
  }
20
126
 
21
127
  .question {
22
- font-size: 0.75rem;
128
+ font-size: clamp(0.5rem, 2vw, 0.75rem);
23
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;
24
136
  }
25
137
 
26
138
  .answer {
27
- font-size: 1.125rem;
28
- font-weight: bold;
139
+ font-family: "Playfair Display", serif;
140
+ font-style: italic;
141
+ font-size: 1.25rem;
142
+ font-weight: 600;
29
143
  margin-top: 0.5rem;
30
- 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;
31
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.4.0/node_modules/shx/lib/node_modules:/home/runner/work/skybridge/skybridge/node_modules/.pnpm/shx@0.4.0/node_modules/shx/node_modules:/home/runner/work/skybridge/skybridge/node_modules/.pnpm/shx@0.4.0/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.4.0/node_modules/shx/lib/node_modules:/home/runner/work/skybridge/skybridge/node_modules/.pnpm/shx@0.4.0/node_modules/shx/node_modules:/home/runner/work/skybridge/skybridge/node_modules/.pnpm/shx@0.4.0/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