create-skybridge 0.0.0-dev.b0a1d24 → 0.0.0-dev.b0f5d5c

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 (70) hide show
  1. package/dist/index.js +101 -64
  2. package/dist/index.test.js +13 -1
  3. package/package.json +9 -9
  4. package/template/.dockerignore +4 -0
  5. package/template/AGENTS.md +1 -0
  6. package/template/Dockerfile +53 -0
  7. package/template/README.md +39 -22
  8. package/template/_gitignore +6 -0
  9. package/template/alpic.json +1 -2
  10. package/template/node_modules/.bin/alpic +21 -0
  11. package/template/node_modules/.bin/sb +21 -0
  12. package/template/node_modules/.bin/skybridge +21 -0
  13. package/template/node_modules/.bin/tsc +2 -2
  14. package/template/node_modules/.bin/tsserver +2 -2
  15. package/template/node_modules/.bin/tsx +2 -2
  16. package/template/node_modules/.bin/vite +2 -2
  17. package/template/package.json +24 -25
  18. package/template/src/helpers.ts +4 -0
  19. package/template/src/index.css +59 -0
  20. package/template/src/server.ts +77 -0
  21. package/template/src/views/components/doc-link.tsx +22 -0
  22. package/template/src/views/components/doc.tsx +21 -0
  23. package/template/src/views/components/nav.tsx +31 -0
  24. package/template/src/views/components/progress.tsx +35 -0
  25. package/template/src/views/components/steps/outro.tsx +68 -0
  26. package/template/src/views/components/steps/state.tsx +47 -0
  27. package/template/src/views/components/steps/tool-call.tsx +53 -0
  28. package/template/src/views/components/steps/tool-output.tsx +40 -0
  29. package/template/src/views/images/mascot/beret.png +0 -0
  30. package/template/src/views/images/mascot/chapka.png +0 -0
  31. package/template/src/views/images/mascot/cowboy-hat.png +0 -0
  32. package/template/src/views/images/mascot/fez.png +0 -0
  33. package/template/src/views/images/mascot/jester-hat.png +0 -0
  34. package/template/src/views/images/mascot/mitre.png +0 -0
  35. package/template/src/views/images/mascot/non-la.png +0 -0
  36. package/template/src/views/images/mascot/original.png +0 -0
  37. package/template/src/views/images/mascot/propeller-beanie.png +0 -0
  38. package/template/src/views/images/mascot/ski-mask.png +0 -0
  39. package/template/src/views/images/mascot/sombrero.png +0 -0
  40. package/template/src/views/images/mascot/top-hat.png +0 -0
  41. package/template/src/views/images/mascot/viking-helmet.png +0 -0
  42. package/template/src/views/onboarding.tsx +63 -0
  43. package/template/src/views/use-mascot.ts +60 -0
  44. package/template/src/vite-manifest.d.ts +4 -0
  45. package/template/tsconfig.json +7 -19
  46. package/template/{web/vite.config.ts → vite.config.ts} +3 -4
  47. package/template/node_modules/.bin/mcp-inspector +0 -21
  48. package/template/node_modules/.bin/nodemon +0 -21
  49. package/template/node_modules/.bin/shx +0 -21
  50. package/template/nodemon.json +0 -5
  51. package/template/server/src/index.ts +0 -39
  52. package/template/server/src/middleware.ts +0 -54
  53. package/template/server/src/server.ts +0 -61
  54. package/template/tsconfig.server.json +0 -11
  55. package/template/web/src/helpers.ts +0 -4
  56. package/template/web/src/index.css +0 -31
  57. package/template/web/src/widgets/magic-8-ball.tsx +0 -24
  58. package/template-ecom/README.md +0 -86
  59. package/template-ecom/alpic.json +0 -4
  60. package/template-ecom/nodemon.json +0 -5
  61. package/template-ecom/package.json +0 -40
  62. package/template-ecom/server/src/index.ts +0 -39
  63. package/template-ecom/server/src/middleware.ts +0 -54
  64. package/template-ecom/server/src/server.ts +0 -73
  65. package/template-ecom/tsconfig.json +0 -23
  66. package/template-ecom/tsconfig.server.json +0 -11
  67. package/template-ecom/web/src/helpers.ts +0 -4
  68. package/template-ecom/web/src/index.css +0 -178
  69. package/template-ecom/web/src/widgets/ecom-carousel.tsx +0 -109
  70. 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);
@@ -55,7 +56,7 @@ export async function init(args = process.argv.slice(2)) {
55
56
  defaultValue: defaultProjectName,
56
57
  placeholder: defaultProjectName,
57
58
  validate: (value) => {
58
- return value.length === 0 || sanitizeTargetDir(value).length > 0
59
+ return !value || sanitizeTargetDir(value).length > 0
59
60
  ? undefined
60
61
  : "Invalid project name";
61
62
  },
@@ -69,31 +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
- let templatePath = "../template";
74
- if (!argTemplate && interactive) {
75
- let message = "Please choose a template:";
76
- const hasInvalidTemplate = argTemplate && !templates.some((t) => t.value === argTemplate);
77
- if (hasInvalidTemplate) {
78
- message = `${argTemplate} is not a valid template. Please choose one of the following:`;
79
- }
80
- const template = await prompts.select({
81
- message,
82
- options: templates.map((t) => ({
83
- value: t.value,
84
- label: `${t.value}: ${t.label}`,
85
- })),
86
- });
87
- if (prompts.isCancel(template)) {
88
- return cancel();
89
- }
90
- switch (template) {
91
- case "ecom":
92
- templatePath = "../template-ecom";
93
- break;
94
- }
95
- }
96
- // 3. Handle directory if exist and not empty
73
+ // 2. Handle directory if exist and not empty
97
74
  if (fs.existsSync(targetDir) && !isEmpty(targetDir)) {
98
75
  let overwrite = argOverwrite ? "yes" : undefined;
99
76
  if (!overwrite) {
@@ -128,40 +105,81 @@ export async function init(args = process.argv.slice(2)) {
128
105
  emptyDir(targetDir);
129
106
  break;
130
107
  case "no":
131
- cancel();
132
- return;
108
+ prompts.log.error("Target directory is not empty.");
109
+ process.exit(1);
133
110
  }
134
111
  }
135
112
  const root = path.join(process.cwd(), targetDir);
136
- // 4. Copy the template
137
- prompts.log.step(`Copying template...`);
113
+ // 3. Download from repo or copy template
138
114
  try {
139
- const templateDir = fileURLToPath(new URL(templatePath, import.meta.url));
140
- // Copy template to target directory
141
- fs.cpSync(templateDir, root, {
142
- recursive: true,
143
- filter: (src) => [".npmrc"].every((file) => !src.endsWith(file)),
144
- });
145
- // Write .gitignore
146
- fs.writeFileSync(path.join(root, ".gitignore"), `node_modules/
147
- dist/
148
- .env*
149
- .DS_store`);
150
- // Update project name in package.json
151
- const name = path.basename(root);
152
- const pkgPath = path.join(root, "package.json");
153
- const pkg = fs.readFileSync(pkgPath, "utf-8");
154
- const fixed = pkg.replace(/apps-sdk-template/g, name);
155
- fs.writeFileSync(pkgPath, fixed);
156
- 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
+ }
157
132
  }
158
133
  catch (error) {
159
- prompts.log.error("Failed to copy repository");
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`);
148
+ }
149
+ catch (error) {
150
+ prompts.log.error("Failed to update project name in package.json");
160
151
  console.error(error);
161
152
  process.exit(1);
162
153
  }
163
154
  const userAgent = process.env.npm_config_user_agent;
164
155
  const pkgManager = userAgent?.split(" ")[0]?.split("/")[0] || "npm";
156
+ // 4. Ask about skills installation (installed by default)
157
+ let skill = true;
158
+ if (interactive) {
159
+ const skillsResult = await prompts.confirm({
160
+ message: "Install the coding agents skills? (recommended)",
161
+ initialValue: true,
162
+ });
163
+ if (prompts.isCancel(skillsResult)) {
164
+ return cancel();
165
+ }
166
+ skill = skillsResult;
167
+ }
168
+ if (skill) {
169
+ run([
170
+ ...getPkgExecCmd(pkgManager, "skills"),
171
+ "add",
172
+ "alpic-ai/skybridge",
173
+ "-s",
174
+ "chatgpt-app-builder",
175
+ ...(interactive
176
+ ? []
177
+ : ["--yes", "-a", "universal", "-a", "claude-code"]),
178
+ ], {
179
+ stdio: "inherit",
180
+ cwd: targetDir,
181
+ });
182
+ }
165
183
  // 5. Ask about immediate installation
166
184
  let immediate = argImmediate;
167
185
  if (immediate === undefined) {
@@ -234,18 +252,37 @@ function sanitizeTargetDir(targetDir) {
234
252
  // Remove leading/trailing slashes
235
253
  .replace(/^\/+|\/+$/g, ""));
236
254
  }
237
- function isEmpty(path) {
238
- const files = fs.readdirSync(path);
239
- return files.length === 0 || (files.length === 1 && files[0] === ".git");
255
+ // Skip user's SPEC.md and IDE/agent preferences (.idea, .claude, etc.)
256
+ function isSkippedEntry(entry) {
257
+ return ((entry.name.startsWith(".") && entry.isDirectory()) ||
258
+ entry.name === "SPEC.md");
259
+ }
260
+ function isEmpty(dirPath) {
261
+ const entries = fs.readdirSync(dirPath, { withFileTypes: true });
262
+ return entries.every(isSkippedEntry);
240
263
  }
241
264
  function emptyDir(dir) {
242
265
  if (!fs.existsSync(dir)) {
243
266
  return;
244
267
  }
245
- for (const file of fs.readdirSync(dir)) {
246
- if (file === ".git") {
268
+ for (const entry of fs.readdirSync(dir, { withFileTypes: true })) {
269
+ if (isSkippedEntry(entry)) {
247
270
  continue;
248
271
  }
249
- fs.rmSync(path.resolve(dir, file), { recursive: true, force: true });
272
+ fs.rmSync(path.join(dir, entry.name), { recursive: true, force: true });
273
+ }
274
+ }
275
+ function getPkgExecCmd(pkgManager, cmd) {
276
+ switch (pkgManager) {
277
+ case "yarn":
278
+ return ["yarn", "dlx", cmd];
279
+ case "pnpm":
280
+ return ["pnpm", "dlx", cmd];
281
+ case "bun":
282
+ return ["bunx", cmd];
283
+ case "deno":
284
+ return ["deno", "run", "-A", `npm:${cmd}`];
285
+ default:
286
+ return ["npx", "--yes", cmd];
250
287
  }
251
288
  }
@@ -14,10 +14,22 @@ 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", { timeout: 10000 }, 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
+ await fs.access(path.join(process.cwd(), tempDirName, "project", ".dockerignore"));
22
+ await fs.access(path.join(process.cwd(), tempDirName, "project", "Dockerfile"));
23
+ expect(fs.access(path.join(process.cwd(), tempDirName, "project", ".npmrc"))).rejects.toThrowError();
24
+ });
25
+ it("should download template from repo", { timeout: 10000 }, async () => {
26
+ const name = `../../${tempDirName}//project$`;
27
+ await init([
28
+ name,
29
+ "--repo",
30
+ "github:alpic-ai/skybridge/examples/ecom-carousel",
31
+ ]);
32
+ await fs.access(path.join(process.cwd(), tempDirName, "project", ".gitignore"));
21
33
  expect(fs.access(path.join(process.cwd(), tempDirName, "project", ".npmrc"))).rejects.toThrowError();
22
34
  });
23
35
  });
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "create-skybridge",
3
- "version": "0.0.0-dev.b0a1d24",
3
+ "version": "0.0.0-dev.b0f5d5c",
4
4
  "type": "module",
5
5
  "license": "MIT",
6
6
  "author": "Alpic",
@@ -14,22 +14,22 @@
14
14
  "files": [
15
15
  "index.js",
16
16
  "dist",
17
- "template",
18
- "template-ecom"
17
+ "template"
19
18
  ],
20
19
  "dependencies": {
21
- "@clack/prompts": "^0.11.0",
20
+ "@clack/prompts": "^1.1.0",
21
+ "giget": "^3.2.0",
22
22
  "mri": "^1.2.0"
23
23
  },
24
24
  "devDependencies": {
25
- "typescript": "^5.9.3",
26
- "vitest": "^4.0.16"
25
+ "typescript": "^6.0.2",
26
+ "vitest": "^4.1.4"
27
27
  },
28
28
  "scripts": {
29
- "build": "tsc && node copyExamples.js",
30
- "test": "pnpm run test:unit && pnpm run test:type && pnpm run test:format",
29
+ "build": "tsc",
30
+ "test": "pnpm run test:unit && pnpm run test:format",
31
31
  "test:unit": "vitest run",
32
- "test:type": "tsc --noEmit",
32
+ "format": "biome check --write --error-on-warnings",
33
33
  "test:format": "biome ci"
34
34
  }
35
35
  }
@@ -0,0 +1,4 @@
1
+ node_modules
2
+ .git
3
+ dist
4
+ .env*
@@ -0,0 +1 @@
1
+ This is a ChatGPT/MCP app built with Skybridge. ALWAYS use the `chatgpt-app-builder` skill when planning or updating the codebase.
@@ -0,0 +1,53 @@
1
+ # syntax=docker/dockerfile:1
2
+
3
+ # Dockerfile for a Skybridge MCP server.
4
+ #
5
+ # Detects npm, yarn, or pnpm from the lockfile in your project.
6
+ # (For bun or deno, adapt the install/build/prune commands below.)
7
+
8
+ # Build stage: install deps, compile the app, then prune dev deps.
9
+ FROM node:24-slim AS build
10
+ WORKDIR /app
11
+
12
+ COPY package.json yarn.lock* package-lock.json* pnpm-lock.yaml* .npmrc* ./
13
+ RUN --mount=type=cache,target=/root/.npm \
14
+ --mount=type=cache,target=/usr/local/share/.cache/yarn \
15
+ --mount=type=cache,target=/root/.local/share/pnpm/store \
16
+ if [ -f package-lock.json ]; then \
17
+ npm ci; \
18
+ elif [ -f yarn.lock ]; then \
19
+ corepack enable yarn && yarn install --frozen-lockfile; \
20
+ elif [ -f pnpm-lock.yaml ]; then \
21
+ corepack enable pnpm && pnpm install --frozen-lockfile; \
22
+ else \
23
+ echo "No lockfile found." && exit 1; \
24
+ fi
25
+
26
+ ENV NODE_ENV=production
27
+
28
+ COPY . .
29
+ RUN if [ -f package-lock.json ]; then \
30
+ npm run build && npm prune --omit=dev; \
31
+ elif [ -f yarn.lock ]; then \
32
+ corepack enable yarn && yarn build && yarn install --frozen-lockfile --production=true; \
33
+ elif [ -f pnpm-lock.yaml ]; then \
34
+ corepack enable pnpm && pnpm build && pnpm prune --prod; \
35
+ fi
36
+
37
+ # Runtime stage: copy built artifacts and prod deps, run as non-root.
38
+ FROM node:24-slim AS runtime
39
+ WORKDIR /app
40
+ ENV NODE_ENV=production
41
+
42
+ USER node
43
+
44
+ COPY --from=build --chown=node:node /app/node_modules ./node_modules
45
+ COPY --from=build --chown=node:node /app/dist ./dist
46
+ COPY --from=build --chown=node:node /app/package.json ./package.json
47
+
48
+ EXPOSE 3000
49
+
50
+ # Run the built server directly rather than via `npm start` / `skybridge start`.
51
+ # Each wrapper adds a process layer that can swallow SIGTERM, which makes
52
+ # graceful shutdowns time out on platforms like Cloud Run, Fly, and k8s.
53
+ CMD ["node", "dist/server.js"]
@@ -1,13 +1,13 @@
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 MCP and ChatGPT Apps with the [Skybridge](https://docs.skybridge.tech/home) framework.
4
4
 
5
5
  ## Getting Started
6
6
 
7
7
  ### Prerequisites
8
8
 
9
9
  - Node.js 24+
10
- - HTTP tunnel such as [ngrok](https://ngrok.com/download)
10
+ - HTTP tunnel such as [Alpic tunnel](https://docs.alpic.ai/cli/tunnel) if you want to test with remote MCP hosts like ChatGPT or Claude.ai.
11
11
 
12
12
  ### Local Development
13
13
 
@@ -37,41 +37,58 @@ pnpm dev
37
37
  bun dev
38
38
  ```
39
39
 
40
- This command starts an Express server on port 3000. This server packages:
40
+ This command starts:
41
+ - Your MCP server at `http://localhost:3000/mcp`.
42
+ - Skybridge DevTools UI at `http://localhost:3000/`.
41
43
 
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)
44
+ #### 3. Project structure
44
45
 
45
- #### 3. Connect to ChatGPT
46
-
47
- - ChatGPT requires connectors to be publicly accessible. To expose your server on the Internet, run:
48
- ```bash
49
- ngrok http 3000
50
46
  ```
51
- - In ChatGPT, navigate to **Settings → Connectors → Create** and add the forwarding URL provided by ngrok suffixed with `/mcp` (e.g. `https://3785c5ddc4b6.ngrok-free.app/mcp`)
47
+ ├── src/
48
+ │ ├── server.ts # Server entry point
49
+ │ ├── views/ # React components (one per view)
50
+ │ ├── components/ # Shared UI components
51
+ │ ├── helpers.ts # Shared utilities
52
+ │ └── index.css # Global styles
53
+ ├── vite.config.ts
54
+ ├── alpic.json # Deployment config
55
+ └── package.json
56
+ ```
52
57
 
53
- ### Create your first widget
58
+ ### Create your first view
54
59
 
55
- #### 1. Add a new widget
60
+ #### 1. Add a new view
56
61
 
57
- - Register a widget in `server/server.ts` with a unique name (e.g., `my-widget`)
58
- - Create a matching React component at `web/src/widgets/my-widget.tsx`. The file name must match the widget name exactly
62
+ - Register a tool in `src/server.ts` with a unique name (e.g., `my-view`) using [`registerTool`](https://docs.skybridge.tech/api-reference/register-tool) and a `view` config.
63
+ - Create a matching React component at `src/views/my-view.tsx`. **The file name must match the view name exactly**.
59
64
 
60
- #### 2. Edit widgets with Hot Module Replacement (HMR)
65
+ #### 2. Edit views with Hot Module Replacement (HMR)
61
66
 
62
- Edit and save components in `web/src/widgets/` — changes appear instantly in ChatGPT
67
+ Edit and save components in `src/views/` — changes will appear instantly inside your App.
63
68
 
64
69
  #### 3. Edit server code
65
70
 
66
- Modify files in `server/` and reload your ChatGPT connector in **Settings Connectors [Your connector] → Reload**
71
+ Modify files in `src/` and refresh the connection with your testing MCP Client to see the changes.
72
+
73
+ ### Testing your App
74
+
75
+ You can test your App locally by using our DevTools UI on `localhost:3000` while running the `pnpm dev` command.
76
+
77
+ To test your app with other MCP Clients like ChatGPT, Claude or VSCode, see [Testing Your App](https://docs.skybridge.tech/quickstart/test-your-app).
78
+
67
79
 
68
80
  ## Deploy to Production
69
81
 
70
- - Use [Alpic](https://alpic.ai/) to deploy your OpenAI App to production
71
- - In ChatGPT, navigate to **Settings → Connectors → Create** and add your MCP server URL (e.g., `https://your-app-name.alpic.live`)
82
+ Skybridge is infrastructure vendor agnostic, and your app can be deployed on any cloud platform supporting MCP.
72
83
 
73
- ## Resources
84
+ The simplest way to deploy your App in minutes is [Alpic](https://alpic.ai/).
85
+ 1. Create an account on [Alpic platform](https://app.alpic.ai/).
86
+ 2. Connect your GitHub repository to automatically deploy at each commit.
87
+ 3. Use your remote App URL to connect it to MCP Clients, or use the Alpic Playground to easily test your App.
74
88
 
89
+ ## Resources
90
+ - [Skybridge Documentation](https://docs.skybridge.tech/)
75
91
  - [Apps SDK Documentation](https://developers.openai.com/apps-sdk)
92
+ - [MCP Apps Documentation](https://github.com/modelcontextprotocol/ext-apps/tree/main)
76
93
  - [Model Context Protocol Documentation](https://modelcontextprotocol.io/)
77
94
  - [Alpic Documentation](https://docs.alpic.ai/)
@@ -0,0 +1,6 @@
1
+ node_modules/
2
+ dist/
3
+ .env*
4
+ .DS_store
5
+ *.tsbuildinfo
6
+ .skybridge/
@@ -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
  }
@@ -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/alpic@1.104.1_@opentelemetry+api@1.9.0_arktype@2.1.27_rxjs@7.8.2_typescript@6.0.2/node_modules/alpic/node_modules:/home/runner/work/skybridge/skybridge/node_modules/.pnpm/alpic@1.104.1_@opentelemetry+api@1.9.0_arktype@2.1.27_rxjs@7.8.2_typescript@6.0.2/node_modules:/home/runner/work/skybridge/skybridge/node_modules/.pnpm/node_modules"
14
+ else
15
+ export NODE_PATH="/home/runner/work/skybridge/skybridge/node_modules/.pnpm/alpic@1.104.1_@opentelemetry+api@1.9.0_arktype@2.1.27_rxjs@7.8.2_typescript@6.0.2/node_modules/alpic/node_modules:/home/runner/work/skybridge/skybridge/node_modules/.pnpm/alpic@1.104.1_@opentelemetry+api@1.9.0_arktype@2.1.27_rxjs@7.8.2_typescript@6.0.2/node_modules:/home/runner/work/skybridge/skybridge/node_modules/.pnpm/node_modules:$NODE_PATH"
16
+ fi
17
+ if [ -x "$basedir/node" ]; then
18
+ exec "$basedir/node" "$basedir/../alpic/bin/run.js" "$@"
19
+ else
20
+ exec node "$basedir/../alpic/bin/run.js" "$@"
21
+ fi
@@ -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/node_modules"
14
+ else
15
+ export NODE_PATH="/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
@@ -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/node_modules"
14
+ else
15
+ export NODE_PATH="/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
@@ -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/typescript@5.9.3/node_modules/typescript/bin/node_modules:/home/runner/work/skybridge/skybridge/node_modules/.pnpm/typescript@5.9.3/node_modules/typescript/node_modules:/home/runner/work/skybridge/skybridge/node_modules/.pnpm/typescript@5.9.3/node_modules:/home/runner/work/skybridge/skybridge/node_modules/.pnpm/node_modules"
13
+ export NODE_PATH="/home/runner/work/skybridge/skybridge/node_modules/.pnpm/typescript@6.0.2/node_modules/typescript/node_modules:/home/runner/work/skybridge/skybridge/node_modules/.pnpm/typescript@6.0.2/node_modules:/home/runner/work/skybridge/skybridge/node_modules/.pnpm/node_modules"
14
14
  else
15
- export NODE_PATH="/home/runner/work/skybridge/skybridge/node_modules/.pnpm/typescript@5.9.3/node_modules/typescript/bin/node_modules:/home/runner/work/skybridge/skybridge/node_modules/.pnpm/typescript@5.9.3/node_modules/typescript/node_modules:/home/runner/work/skybridge/skybridge/node_modules/.pnpm/typescript@5.9.3/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/typescript@6.0.2/node_modules/typescript/node_modules:/home/runner/work/skybridge/skybridge/node_modules/.pnpm/typescript@6.0.2/node_modules:/home/runner/work/skybridge/skybridge/node_modules/.pnpm/node_modules:$NODE_PATH"
16
16
  fi
17
17
  if [ -x "$basedir/node" ]; then
18
18
  exec "$basedir/node" "$basedir/../typescript/bin/tsc" "$@"
@@ -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/typescript@5.9.3/node_modules/typescript/bin/node_modules:/home/runner/work/skybridge/skybridge/node_modules/.pnpm/typescript@5.9.3/node_modules/typescript/node_modules:/home/runner/work/skybridge/skybridge/node_modules/.pnpm/typescript@5.9.3/node_modules:/home/runner/work/skybridge/skybridge/node_modules/.pnpm/node_modules"
13
+ export NODE_PATH="/home/runner/work/skybridge/skybridge/node_modules/.pnpm/typescript@6.0.2/node_modules/typescript/node_modules:/home/runner/work/skybridge/skybridge/node_modules/.pnpm/typescript@6.0.2/node_modules:/home/runner/work/skybridge/skybridge/node_modules/.pnpm/node_modules"
14
14
  else
15
- export NODE_PATH="/home/runner/work/skybridge/skybridge/node_modules/.pnpm/typescript@5.9.3/node_modules/typescript/bin/node_modules:/home/runner/work/skybridge/skybridge/node_modules/.pnpm/typescript@5.9.3/node_modules/typescript/node_modules:/home/runner/work/skybridge/skybridge/node_modules/.pnpm/typescript@5.9.3/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/typescript@6.0.2/node_modules/typescript/node_modules:/home/runner/work/skybridge/skybridge/node_modules/.pnpm/typescript@6.0.2/node_modules:/home/runner/work/skybridge/skybridge/node_modules/.pnpm/node_modules:$NODE_PATH"
16
16
  fi
17
17
  if [ -x "$basedir/node" ]; then
18
18
  exec "$basedir/node" "$basedir/../typescript/bin/tsserver" "$@"
@@ -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/tsx@4.21.0/node_modules/tsx/dist/node_modules:/home/runner/work/skybridge/skybridge/node_modules/.pnpm/tsx@4.21.0/node_modules/tsx/node_modules:/home/runner/work/skybridge/skybridge/node_modules/.pnpm/tsx@4.21.0/node_modules:/home/runner/work/skybridge/skybridge/node_modules/.pnpm/node_modules"
13
+ export NODE_PATH="/home/runner/work/skybridge/skybridge/node_modules/.pnpm/tsx@4.21.0/node_modules/tsx/node_modules:/home/runner/work/skybridge/skybridge/node_modules/.pnpm/tsx@4.21.0/node_modules:/home/runner/work/skybridge/skybridge/node_modules/.pnpm/node_modules"
14
14
  else
15
- export NODE_PATH="/home/runner/work/skybridge/skybridge/node_modules/.pnpm/tsx@4.21.0/node_modules/tsx/dist/node_modules:/home/runner/work/skybridge/skybridge/node_modules/.pnpm/tsx@4.21.0/node_modules/tsx/node_modules:/home/runner/work/skybridge/skybridge/node_modules/.pnpm/tsx@4.21.0/node_modules:/home/runner/work/skybridge/skybridge/node_modules/.pnpm/node_modules:$NODE_PATH"
15
+ export NODE_PATH="/home/runner/work/skybridge/skybridge/node_modules/.pnpm/tsx@4.21.0/node_modules/tsx/node_modules:/home/runner/work/skybridge/skybridge/node_modules/.pnpm/tsx@4.21.0/node_modules:/home/runner/work/skybridge/skybridge/node_modules/.pnpm/node_modules:$NODE_PATH"
16
16
  fi
17
17
  if [ -x "$basedir/node" ]; then
18
18
  exec "$basedir/node" "$basedir/../tsx/dist/cli.mjs" "$@"
@@ -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@8.0.3_@types+node@24.12.0_esbuild@0.27.2_jiti@2.6.1_terser@5.44.1_tsx@4.21.0_yaml@2.8.2/node_modules/vite/node_modules:/home/runner/work/skybridge/skybridge/node_modules/.pnpm/vite@8.0.3_@types+node@24.12.0_esbuild@0.27.2_jiti@2.6.1_terser@5.44.1_tsx@4.21.0_yaml@2.8.2/node_modules:/home/runner/work/skybridge/skybridge/node_modules/.pnpm/node_modules"
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@8.0.3_@types+node@24.12.0_esbuild@0.27.2_jiti@2.6.1_terser@5.44.1_tsx@4.21.0_yaml@2.8.2/node_modules/vite/node_modules:/home/runner/work/skybridge/skybridge/node_modules/.pnpm/vite@8.0.3_@types+node@24.12.0_esbuild@0.27.2_jiti@2.6.1_terser@5.44.1_tsx@4.21.0_yaml@2.8.2/node_modules:/home/runner/work/skybridge/skybridge/node_modules/.pnpm/node_modules:$NODE_PATH"
16
16
  fi
17
17
  if [ -x "$basedir/node" ]; then
18
18
  exec "$basedir/node" "$basedir/../vite/bin/vite.js" "$@"