create-skybridge 0.0.0-dev.d5f8d0a → 0.0.0-dev.d60c856

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 (49) hide show
  1. package/dist/index.d.ts +1 -1
  2. package/dist/index.js +187 -55
  3. package/dist/index.test.d.ts +1 -0
  4. package/dist/index.test.js +35 -0
  5. package/index.js +6 -1
  6. package/package.json +10 -6
  7. package/template/.dockerignore +4 -0
  8. package/template/AGENTS.md +1 -0
  9. package/template/Dockerfile +53 -0
  10. package/template/README.md +94 -0
  11. package/template/_gitignore +6 -0
  12. package/template/alpic.json +3 -0
  13. package/template/node_modules/.bin/alpic +21 -0
  14. package/template/node_modules/.bin/sb +21 -0
  15. package/template/node_modules/.bin/skybridge +21 -0
  16. package/template/node_modules/.bin/tsc +21 -0
  17. package/template/node_modules/.bin/tsserver +21 -0
  18. package/template/node_modules/.bin/tsx +21 -0
  19. package/template/node_modules/.bin/vite +21 -0
  20. package/template/package.json +41 -0
  21. package/template/src/helpers.ts +4 -0
  22. package/template/src/index.css +59 -0
  23. package/template/src/server.ts +77 -0
  24. package/template/src/views/components/doc-link.tsx +22 -0
  25. package/template/src/views/components/doc.tsx +21 -0
  26. package/template/src/views/components/nav.tsx +31 -0
  27. package/template/src/views/components/progress.tsx +35 -0
  28. package/template/src/views/components/steps/outro.tsx +68 -0
  29. package/template/src/views/components/steps/state.tsx +47 -0
  30. package/template/src/views/components/steps/tool-call.tsx +53 -0
  31. package/template/src/views/components/steps/tool-output.tsx +40 -0
  32. package/template/src/views/images/mascot/beret.png +0 -0
  33. package/template/src/views/images/mascot/chapka.png +0 -0
  34. package/template/src/views/images/mascot/cowboy-hat.png +0 -0
  35. package/template/src/views/images/mascot/fez.png +0 -0
  36. package/template/src/views/images/mascot/jester-hat.png +0 -0
  37. package/template/src/views/images/mascot/mitre.png +0 -0
  38. package/template/src/views/images/mascot/non-la.png +0 -0
  39. package/template/src/views/images/mascot/original.png +0 -0
  40. package/template/src/views/images/mascot/propeller-beanie.png +0 -0
  41. package/template/src/views/images/mascot/ski-mask.png +0 -0
  42. package/template/src/views/images/mascot/sombrero.png +0 -0
  43. package/template/src/views/images/mascot/top-hat.png +0 -0
  44. package/template/src/views/images/mascot/viking-helmet.png +0 -0
  45. package/template/src/views/onboarding.tsx +63 -0
  46. package/template/src/views/use-mascot.ts +60 -0
  47. package/template/src/vite-manifest.d.ts +4 -0
  48. package/template/tsconfig.json +11 -0
  49. package/template/vite.config.ts +14 -0
package/dist/index.d.ts CHANGED
@@ -1 +1 @@
1
- export {};
1
+ export declare function init(args?: string[]): Promise<void>;
package/dist/index.js CHANGED
@@ -1,48 +1,45 @@
1
1
  import { spawnSync } from "node:child_process";
2
2
  import fs from "node:fs";
3
3
  import path from "node:path";
4
+ import { fileURLToPath } from "node:url";
4
5
  import * as prompts from "@clack/prompts";
6
+ import { downloadTemplate } from "giget";
5
7
  import mri from "mri";
6
- const argv = mri(process.argv.slice(2), {
7
- boolean: ["help", "overwrite"],
8
- alias: { h: "help" },
9
- });
10
- const cwd = process.cwd();
11
- const TEMPLATE_REPO = "https://github.com/alpic-ai/apps-sdk-template";
12
8
  const defaultProjectName = "skybridge-project";
13
9
  // prettier-ignore
14
10
  const helpMessage = `\
15
11
  Usage: create-skybridge [OPTION]... [DIRECTORY]
16
12
 
17
- Create a new Skybridge project by cloning the starter template.
13
+ Create a new Skybridge project by copying the starter template.
18
14
 
19
15
  Options:
20
16
  -h, --help show this help message
17
+ --repo <uri> use a git repository instead of the built-in template
21
18
  --overwrite remove existing files in target directory
19
+ --immediate install dependencies and start development server
20
+
21
+ Repository URI formats:
22
+ github:user/repo
23
+ gitlab:user/repo/subdirectory
24
+ bitbucket:user/repo#branch
22
25
 
23
26
  Examples:
24
27
  create-skybridge my-app
25
- create-skybridge . --overwrite
28
+ create-skybridge my-app --repo github:alpic-ai/skybridge/examples/ecom-carousel
29
+ create-skybridge . --overwrite --immediate
26
30
  `;
27
- function run([command, ...args], options) {
28
- if (!command) {
29
- throw new Error("Command is required");
30
- }
31
- const { status, error } = spawnSync(command, args, options);
32
- if (status != null && status > 0) {
33
- process.exit(status);
34
- }
35
- if (error) {
36
- console.error(`\n${command} ${args.join(" ")} error!`);
37
- console.error(error);
38
- process.exit(1);
39
- }
40
- }
41
- async function init() {
31
+ export async function init(args = process.argv.slice(2)) {
32
+ const argv = mri(args, {
33
+ boolean: ["help", "overwrite", "immediate"],
34
+ string: ["repo"],
35
+ alias: { h: "help" },
36
+ });
42
37
  const argTargetDir = argv._[0]
43
- ? formatTargetDir(String(argv._[0]))
38
+ ? sanitizeTargetDir(String(argv._[0]))
44
39
  : undefined;
40
+ const argRepo = argv.repo;
45
41
  const argOverwrite = argv.overwrite;
42
+ const argImmediate = argv.immediate;
46
43
  const help = argv.help;
47
44
  if (help) {
48
45
  console.log(helpMessage);
@@ -59,14 +56,15 @@ async function init() {
59
56
  defaultValue: defaultProjectName,
60
57
  placeholder: defaultProjectName,
61
58
  validate: (value) => {
62
- return value.length === 0 || formatTargetDir(value).length > 0
59
+ return !value || sanitizeTargetDir(value).length > 0
63
60
  ? undefined
64
61
  : "Invalid project name";
65
62
  },
66
63
  });
67
- if (prompts.isCancel(projectName))
64
+ if (prompts.isCancel(projectName)) {
68
65
  return cancel();
69
- targetDir = formatTargetDir(projectName);
66
+ }
67
+ targetDir = sanitizeTargetDir(projectName);
70
68
  }
71
69
  else {
72
70
  targetDir = defaultProjectName;
@@ -93,8 +91,9 @@ async function init() {
93
91
  },
94
92
  ],
95
93
  });
96
- if (prompts.isCancel(res))
94
+ if (prompts.isCancel(res)) {
97
95
  return cancel();
96
+ }
98
97
  overwrite = res;
99
98
  }
100
99
  else {
@@ -106,51 +105,184 @@ async function init() {
106
105
  emptyDir(targetDir);
107
106
  break;
108
107
  case "no":
109
- cancel();
110
- return;
108
+ prompts.log.error("Target directory is not empty.");
109
+ process.exit(1);
111
110
  }
112
111
  }
113
- const root = path.join(cwd, targetDir);
114
- // 3. Clone the repository
115
- prompts.log.step(`Cloning template from ${TEMPLATE_REPO}...`);
112
+ const root = path.join(process.cwd(), targetDir);
113
+ // 3. Download from repo or copy template
116
114
  try {
117
- // Clone directly to target directory
118
- run(["git", "clone", "--depth", "1", TEMPLATE_REPO, 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`);
148
+ }
149
+ catch (error) {
150
+ prompts.log.error("Failed to update project name in package.json");
151
+ console.error(error);
152
+ process.exit(1);
153
+ }
154
+ const userAgent = process.env.npm_config_user_agent;
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
+ ], {
119
179
  stdio: "inherit",
180
+ cwd: targetDir,
120
181
  });
121
- // Remove .git directory to start fresh
122
- const gitDir = path.join(root, ".git");
123
- if (fs.existsSync(gitDir)) {
124
- fs.rmSync(gitDir, { recursive: true, force: true });
182
+ }
183
+ // 5. Ask about immediate installation
184
+ let immediate = argImmediate;
185
+ if (immediate === undefined) {
186
+ if (interactive) {
187
+ const immediateResult = await prompts.confirm({
188
+ message: `Install with ${pkgManager} and start now?`,
189
+ });
190
+ if (prompts.isCancel(immediateResult)) {
191
+ return cancel();
192
+ }
193
+ immediate = immediateResult;
194
+ }
195
+ else {
196
+ immediate = false;
125
197
  }
126
- prompts.log.success(`Project created in ${root}`);
127
- prompts.outro(`Done! Next steps:\n\n cd ${targetDir}\n pnpm install\n pnpm dev`);
128
198
  }
129
- catch (error) {
130
- prompts.log.error("Failed to clone repository");
199
+ const installCmd = [pkgManager, "install"];
200
+ const runCmd = [pkgManager];
201
+ switch (pkgManager) {
202
+ case "yarn":
203
+ case "pnpm":
204
+ case "bun":
205
+ break;
206
+ case "deno":
207
+ runCmd.push("task");
208
+ break;
209
+ default:
210
+ runCmd.push("run");
211
+ }
212
+ runCmd.push("dev");
213
+ if (!immediate) {
214
+ prompts.outro(`Done! Next steps:
215
+ cd ${targetDir}
216
+ ${installCmd.join(" ")}
217
+ ${runCmd.join(" ")}
218
+ `);
219
+ return;
220
+ }
221
+ prompts.log.step(`Installing dependencies with ${pkgManager}...`);
222
+ run(installCmd, {
223
+ stdio: "inherit",
224
+ cwd: root,
225
+ });
226
+ prompts.log.step("Starting dev server...");
227
+ run(runCmd, {
228
+ stdio: "inherit",
229
+ cwd: root,
230
+ });
231
+ }
232
+ function run([command, ...args], options) {
233
+ const { status, error } = spawnSync(command, args, options);
234
+ if (status != null && status > 0) {
235
+ process.exit(status);
236
+ }
237
+ if (error) {
238
+ console.error(`\n${command} ${args.join(" ")} error!`);
131
239
  console.error(error);
132
240
  process.exit(1);
133
241
  }
134
242
  }
135
- function formatTargetDir(targetDir) {
136
- return targetDir.trim().replace(/\/+$/g, "");
243
+ function sanitizeTargetDir(targetDir) {
244
+ return (targetDir
245
+ .trim()
246
+ // Only keep alphanumeric, dash, underscore, dot, @, /
247
+ .replace(/[^a-zA-Z0-9\-_.@/]/g, "")
248
+ // Prevent path traversal
249
+ .replace(/\.\./g, "")
250
+ // Collapse multiple slashes
251
+ .replace(/\/+/g, "/")
252
+ // Remove leading/trailing slashes
253
+ .replace(/^\/+|\/+$/g, ""));
137
254
  }
138
- function isEmpty(path) {
139
- const files = fs.readdirSync(path);
140
- 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);
141
263
  }
142
264
  function emptyDir(dir) {
143
265
  if (!fs.existsSync(dir)) {
144
266
  return;
145
267
  }
146
- for (const file of fs.readdirSync(dir)) {
147
- if (file === ".git") {
268
+ for (const entry of fs.readdirSync(dir, { withFileTypes: true })) {
269
+ if (isSkippedEntry(entry)) {
148
270
  continue;
149
271
  }
150
- 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];
151
287
  }
152
288
  }
153
- init().catch((e) => {
154
- console.error(e);
155
- process.exit(1);
156
- });
@@ -0,0 +1 @@
1
+ export {};
@@ -0,0 +1,35 @@
1
+ import { randomBytes } from "node:crypto";
2
+ import fs from "node:fs/promises";
3
+ import path from "node:path";
4
+ import { afterEach, beforeEach, describe, expect, it } from "vitest";
5
+ import { init } from "./index.js";
6
+ describe("create-skybridge", () => {
7
+ let tempDirName;
8
+ beforeEach(() => {
9
+ tempDirName = `test-${randomBytes(2).toString("hex")}`;
10
+ });
11
+ afterEach(async () => {
12
+ await fs.rm(path.join(process.cwd(), tempDirName), {
13
+ recursive: true,
14
+ force: true,
15
+ });
16
+ });
17
+ it("should copy the template", { timeout: 10000 }, async () => {
18
+ const name = `../../${tempDirName}//project$`;
19
+ await init([name]);
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"));
33
+ expect(fs.access(path.join(process.cwd(), tempDirName, "project", ".npmrc"))).rejects.toThrowError();
34
+ });
35
+ });
package/index.js CHANGED
@@ -1,3 +1,8 @@
1
1
  #!/usr/bin/env node
2
2
 
3
- import "./dist/index.js";
3
+ import { init } from "./dist/index.js";
4
+
5
+ init().catch((e) => {
6
+ console.error(e);
7
+ process.exit(1);
8
+ });
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "create-skybridge",
3
- "version": "0.0.0-dev.d5f8d0a",
3
+ "version": "0.0.0-dev.d60c856",
4
4
  "type": "module",
5
5
  "license": "MIT",
6
6
  "author": "Alpic",
@@ -13,19 +13,23 @@
13
13
  },
14
14
  "files": [
15
15
  "index.js",
16
- "dist"
16
+ "dist",
17
+ "template"
17
18
  ],
18
19
  "dependencies": {
19
- "@clack/prompts": "^0.11.0",
20
+ "@clack/prompts": "^1.4.0",
21
+ "giget": "^3.2.0",
20
22
  "mri": "^1.2.0"
21
23
  },
22
24
  "devDependencies": {
23
- "@types/node": "^25.0.3",
24
- "typescript": "^5.9.3"
25
+ "typescript": "^6.0.3",
26
+ "vitest": "^4.1.6"
25
27
  },
26
28
  "scripts": {
27
29
  "build": "tsc",
28
- "test:type": "tsc --noEmit",
30
+ "test": "pnpm run test:unit && pnpm run test:format",
31
+ "test:unit": "vitest run",
32
+ "format": "biome check --write --error-on-warnings",
29
33
  "test:format": "biome ci"
30
34
  }
31
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.15.0-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.15.0-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"]
@@ -0,0 +1,94 @@
1
+ # Skybridge Starter
2
+
3
+ A minimal TypeScript template for building MCP and ChatGPT Apps with the [Skybridge](https://docs.skybridge.tech/home) framework.
4
+
5
+ ## Getting Started
6
+
7
+ ### Prerequisites
8
+
9
+ - Node.js 24+
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
+
12
+ ### Local Development
13
+
14
+ #### 1. Install
15
+
16
+ ```bash
17
+ npm install
18
+ # or
19
+ yarn install
20
+ # or
21
+ pnpm install
22
+ # or
23
+ bun install
24
+ ```
25
+
26
+ #### 2. Start your local server
27
+
28
+ Run the development server from the root directory:
29
+
30
+ ```bash
31
+ npm run dev
32
+ # or
33
+ yarn dev
34
+ # or
35
+ pnpm dev
36
+ # or
37
+ bun dev
38
+ ```
39
+
40
+ This command starts:
41
+ - Your MCP server at `http://localhost:3000/mcp`.
42
+ - Skybridge DevTools UI at `http://localhost:3000/`.
43
+
44
+ #### 3. Project structure
45
+
46
+ ```
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
+ ```
57
+
58
+ ### Create your first view
59
+
60
+ #### 1. Add a new view
61
+
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**.
64
+
65
+ #### 2. Edit views with Hot Module Replacement (HMR)
66
+
67
+ Edit and save components in `src/views/` — changes will appear instantly inside your App.
68
+
69
+ #### 3. Edit server code
70
+
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
+
79
+
80
+ ## Deploy to Production
81
+
82
+ Skybridge is infrastructure vendor agnostic, and your app can be deployed on any cloud platform supporting MCP.
83
+
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.
88
+
89
+ ## Resources
90
+ - [Skybridge Documentation](https://docs.skybridge.tech/)
91
+ - [Apps SDK Documentation](https://developers.openai.com/apps-sdk)
92
+ - [MCP Apps Documentation](https://github.com/modelcontextprotocol/ext-apps/tree/main)
93
+ - [Model Context Protocol Documentation](https://modelcontextprotocol.io/)
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/
@@ -0,0 +1,3 @@
1
+ {
2
+ "$schema": "https://assets.alpic.ai/alpic.json"
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.127.1_@opentelemetry+api@1.9.0_arktype@2.1.27_rxjs@7.8.2_typescript@6.0.3/node_modules/alpic/node_modules:/home/runner/work/skybridge/skybridge/node_modules/.pnpm/alpic@1.127.1_@opentelemetry+api@1.9.0_arktype@2.1.27_rxjs@7.8.2_typescript@6.0.3/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.127.1_@opentelemetry+api@1.9.0_arktype@2.1.27_rxjs@7.8.2_typescript@6.0.3/node_modules/alpic/node_modules:/home/runner/work/skybridge/skybridge/node_modules/.pnpm/alpic@1.127.1_@opentelemetry+api@1.9.0_arktype@2.1.27_rxjs@7.8.2_typescript@6.0.3/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
@@ -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/typescript@6.0.3/node_modules/typescript/node_modules:/home/runner/work/skybridge/skybridge/node_modules/.pnpm/typescript@6.0.3/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/typescript@6.0.3/node_modules/typescript/node_modules:/home/runner/work/skybridge/skybridge/node_modules/.pnpm/typescript@6.0.3/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/../typescript/bin/tsc" "$@"
19
+ else
20
+ exec node "$basedir/../typescript/bin/tsc" "$@"
21
+ fi