create-skybridge 0.0.0-dev.e743e37 → 0.0.0-dev.e76a366

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 (50) hide show
  1. package/dist/index.js +19 -14
  2. package/dist/index.test.js +4 -2
  3. package/package.json +7 -7
  4. package/template/.dockerignore +4 -0
  5. package/template/AGENTS.md +1 -1
  6. package/template/Dockerfile +53 -0
  7. package/template/README.md +15 -20
  8. package/template/_gitignore +2 -1
  9. package/template/node_modules/.bin/alpic +2 -2
  10. package/template/node_modules/.bin/sb +2 -2
  11. package/template/node_modules/.bin/skybridge +2 -2
  12. package/template/node_modules/.bin/tsc +2 -2
  13. package/template/node_modules/.bin/tsserver +2 -2
  14. package/template/node_modules/.bin/tsx +2 -2
  15. package/template/node_modules/.bin/vite +2 -2
  16. package/template/package.json +17 -9
  17. package/template/src/helpers.ts +4 -0
  18. package/template/src/index.css +59 -0
  19. package/template/src/server.ts +77 -0
  20. package/template/src/views/components/doc-link.tsx +22 -0
  21. package/template/src/views/components/doc.tsx +21 -0
  22. package/template/src/views/components/nav.tsx +31 -0
  23. package/template/src/views/components/progress.tsx +35 -0
  24. package/template/src/views/components/steps/outro.tsx +68 -0
  25. package/template/src/views/components/steps/state.tsx +47 -0
  26. package/template/src/views/components/steps/tool-call.tsx +53 -0
  27. package/template/src/views/components/steps/tool-output.tsx +40 -0
  28. package/template/src/views/images/mascot/beret.png +0 -0
  29. package/template/src/views/images/mascot/chapka.png +0 -0
  30. package/template/src/views/images/mascot/cowboy-hat.png +0 -0
  31. package/template/src/views/images/mascot/fez.png +0 -0
  32. package/template/src/views/images/mascot/jester-hat.png +0 -0
  33. package/template/src/views/images/mascot/mitre.png +0 -0
  34. package/template/src/views/images/mascot/non-la.png +0 -0
  35. package/template/src/views/images/mascot/original.png +0 -0
  36. package/template/src/views/images/mascot/propeller-beanie.png +0 -0
  37. package/template/src/views/images/mascot/ski-mask.png +0 -0
  38. package/template/src/views/images/mascot/sombrero.png +0 -0
  39. package/template/src/views/images/mascot/top-hat.png +0 -0
  40. package/template/src/views/images/mascot/viking-helmet.png +0 -0
  41. package/template/src/views/onboarding.tsx +63 -0
  42. package/template/src/views/use-mascot.ts +60 -0
  43. package/template/src/vite-manifest.d.ts +4 -0
  44. package/template/tsconfig.json +4 -2
  45. package/template/vite.config.ts +14 -0
  46. package/template/server/src/index.ts +0 -62
  47. package/template/web/src/helpers.ts +0 -4
  48. package/template/web/src/index.css +0 -154
  49. package/template/web/src/widgets/magic-8-ball.tsx +0 -27
  50. package/template/web/vite.config.ts +0 -15
package/dist/index.js CHANGED
@@ -153,7 +153,8 @@ export async function init(args = process.argv.slice(2)) {
153
153
  }
154
154
  const userAgent = process.env.npm_config_user_agent;
155
155
  const pkgManager = userAgent?.split(" ")[0]?.split("/")[0] || "npm";
156
- // 4. Ask about skills installation
156
+ // 4. Ask about skills installation (installed by default)
157
+ let skill = true;
157
158
  if (interactive) {
158
159
  const skillsResult = await prompts.confirm({
159
160
  message: "Install the coding agents skills? (recommended)",
@@ -162,18 +163,22 @@ export async function init(args = process.argv.slice(2)) {
162
163
  if (prompts.isCancel(skillsResult)) {
163
164
  return cancel();
164
165
  }
165
- if (skillsResult) {
166
- run([
167
- ...getPkgExecCmd(pkgManager, "skills"),
168
- "add",
169
- "alpic-ai/skybridge",
170
- "-s",
171
- "chatgpt-app-builder",
172
- ], {
173
- stdio: "inherit",
174
- cwd: targetDir,
175
- });
176
- }
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
+ });
177
182
  }
178
183
  // 5. Ask about immediate installation
179
184
  let immediate = argImmediate;
@@ -278,6 +283,6 @@ function getPkgExecCmd(pkgManager, cmd) {
278
283
  case "deno":
279
284
  return ["deno", "run", "-A", `npm:${cmd}`];
280
285
  default:
281
- return ["npx", cmd];
286
+ return ["npx", "--yes", cmd];
282
287
  }
283
288
  }
@@ -14,13 +14,15 @@ describe("create-skybridge", () => {
14
14
  force: true,
15
15
  });
16
16
  });
17
- it("should copy the template", 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"));
21
23
  expect(fs.access(path.join(process.cwd(), tempDirName, "project", ".npmrc"))).rejects.toThrowError();
22
24
  });
23
- it("should download template from repo", async () => {
25
+ it("should download template from repo", { timeout: 10000 }, async () => {
24
26
  const name = `../../${tempDirName}//project$`;
25
27
  await init([
26
28
  name,
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "create-skybridge",
3
- "version": "0.0.0-dev.e743e37",
3
+ "version": "0.0.0-dev.e76a366",
4
4
  "type": "module",
5
5
  "license": "MIT",
6
6
  "author": "Alpic",
@@ -17,19 +17,19 @@
17
17
  "template"
18
18
  ],
19
19
  "dependencies": {
20
- "@clack/prompts": "^1.0.0",
21
- "giget": "^3.1.2",
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.18"
25
+ "typescript": "^6.0.2",
26
+ "vitest": "^4.1.4"
27
27
  },
28
28
  "scripts": {
29
29
  "build": "tsc",
30
- "test": "pnpm run test:unit && pnpm run test:type && pnpm run test:format",
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*
@@ -1 +1 @@
1
- Before writing code, first explore the project structure, then invoke the chatgpt-app-builder skill for documentation.
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"]
@@ -7,7 +7,7 @@ A minimal TypeScript template for building MCP and ChatGPT Apps with the [Skybri
7
7
  ### Prerequisites
8
8
 
9
9
  - Node.js 24+
10
- - HTTP tunnel such as [ngrok](https://ngrok.com/download) if you want to test with remote MCP hosts like ChatGPT or Claude.ai.
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
 
@@ -44,36 +44,31 @@ This command starts:
44
44
  #### 3. Project structure
45
45
 
46
46
  ```
47
- ├── server/
48
- └── src/
49
- ├── index.ts # Entry point
50
- ├── middleware.ts # MCP middleware
51
- └── server.ts # Widget registry & routes
52
- ├── web/
53
- ├── src/
54
- │ │ ├── widgets/ # React components (one per widget)
55
- │ │ ├── helpers.ts # Shared utilities
56
- │ │ └── index.css # Global styles
57
- │ └── vite.config.ts
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
58
54
  ├── alpic.json # Deployment config
59
- ├── nodemon.json # Dev server config
60
55
  └── package.json
61
56
  ```
62
57
 
63
- ### Create your first widget
58
+ ### Create your first view
64
59
 
65
- #### 1. Add a new widget
60
+ #### 1. Add a new view
66
61
 
67
- - Register a widget in `server/src/server.ts` with a unique name (e.g., `my-widget`) using [`registerWidget`](https://docs.skybridge.tech/api-reference/register-widget)
68
- - 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**.
69
64
 
70
- #### 2. Edit widgets with Hot Module Replacement (HMR)
65
+ #### 2. Edit views with Hot Module Replacement (HMR)
71
66
 
72
- Edit and save components in `web/src/widgets/` — changes will appear instantly inside your App.
67
+ Edit and save components in `src/views/` — changes will appear instantly inside your App.
73
68
 
74
69
  #### 3. Edit server code
75
70
 
76
- Modify files in `server/` and refresh the connection with your testing MCP Client to see the changes.
71
+ Modify files in `src/` and refresh the connection with your testing MCP Client to see the changes.
77
72
 
78
73
  ### Testing your App
79
74
 
@@ -2,4 +2,5 @@ node_modules/
2
2
  dist/
3
3
  .env*
4
4
  .DS_store
5
- *.tsbuildinfo
5
+ *.tsbuildinfo
6
+ .skybridge/
@@ -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/alpic@1.89.0_@opentelemetry+api@1.9.0/node_modules/alpic/bin/node_modules:/home/runner/work/skybridge/skybridge/node_modules/.pnpm/alpic@1.89.0_@opentelemetry+api@1.9.0/node_modules/alpic/node_modules:/home/runner/work/skybridge/skybridge/node_modules/.pnpm/alpic@1.89.0_@opentelemetry+api@1.9.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/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
14
  else
15
- export NODE_PATH="/home/runner/work/skybridge/skybridge/node_modules/.pnpm/alpic@1.89.0_@opentelemetry+api@1.9.0/node_modules/alpic/bin/node_modules:/home/runner/work/skybridge/skybridge/node_modules/.pnpm/alpic@1.89.0_@opentelemetry+api@1.9.0/node_modules/alpic/node_modules:/home/runner/work/skybridge/skybridge/node_modules/.pnpm/alpic@1.89.0_@opentelemetry+api@1.9.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/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
16
  fi
17
17
  if [ -x "$basedir/node" ]; then
18
18
  exec "$basedir/node" "$basedir/../alpic/bin/run.js" "$@"
@@ -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/skybridge@0.31.4_@modelcontextprotocol+sdk@1.26.0_zod@4.3.6__@skybridge+devtools@0.31.4_e6e9775b0d1679917fb4d52fdd54194a/node_modules/skybridge/bin/node_modules:/home/runner/work/skybridge/skybridge/node_modules/.pnpm/skybridge@0.31.4_@modelcontextprotocol+sdk@1.26.0_zod@4.3.6__@skybridge+devtools@0.31.4_e6e9775b0d1679917fb4d52fdd54194a/node_modules/skybridge/node_modules:/home/runner/work/skybridge/skybridge/node_modules/.pnpm/skybridge@0.31.4_@modelcontextprotocol+sdk@1.26.0_zod@4.3.6__@skybridge+devtools@0.31.4_e6e9775b0d1679917fb4d52fdd54194a/node_modules:/home/runner/work/skybridge/skybridge/node_modules/.pnpm/node_modules"
13
+ export NODE_PATH="/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/skybridge@0.31.4_@modelcontextprotocol+sdk@1.26.0_zod@4.3.6__@skybridge+devtools@0.31.4_e6e9775b0d1679917fb4d52fdd54194a/node_modules/skybridge/bin/node_modules:/home/runner/work/skybridge/skybridge/node_modules/.pnpm/skybridge@0.31.4_@modelcontextprotocol+sdk@1.26.0_zod@4.3.6__@skybridge+devtools@0.31.4_e6e9775b0d1679917fb4d52fdd54194a/node_modules/skybridge/node_modules:/home/runner/work/skybridge/skybridge/node_modules/.pnpm/skybridge@0.31.4_@modelcontextprotocol+sdk@1.26.0_zod@4.3.6__@skybridge+devtools@0.31.4_e6e9775b0d1679917fb4d52fdd54194a/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/node_modules:$NODE_PATH"
16
16
  fi
17
17
  if [ -x "$basedir/node" ]; then
18
18
  exec "$basedir/node" "$basedir/../skybridge/bin/run.js" "$@"
@@ -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/skybridge@0.31.4_@modelcontextprotocol+sdk@1.26.0_zod@4.3.6__@skybridge+devtools@0.31.4_e6e9775b0d1679917fb4d52fdd54194a/node_modules/skybridge/bin/node_modules:/home/runner/work/skybridge/skybridge/node_modules/.pnpm/skybridge@0.31.4_@modelcontextprotocol+sdk@1.26.0_zod@4.3.6__@skybridge+devtools@0.31.4_e6e9775b0d1679917fb4d52fdd54194a/node_modules/skybridge/node_modules:/home/runner/work/skybridge/skybridge/node_modules/.pnpm/skybridge@0.31.4_@modelcontextprotocol+sdk@1.26.0_zod@4.3.6__@skybridge+devtools@0.31.4_e6e9775b0d1679917fb4d52fdd54194a/node_modules:/home/runner/work/skybridge/skybridge/node_modules/.pnpm/node_modules"
13
+ export NODE_PATH="/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/skybridge@0.31.4_@modelcontextprotocol+sdk@1.26.0_zod@4.3.6__@skybridge+devtools@0.31.4_e6e9775b0d1679917fb4d52fdd54194a/node_modules/skybridge/bin/node_modules:/home/runner/work/skybridge/skybridge/node_modules/.pnpm/skybridge@0.31.4_@modelcontextprotocol+sdk@1.26.0_zod@4.3.6__@skybridge+devtools@0.31.4_e6e9775b0d1679917fb4d52fdd54194a/node_modules/skybridge/node_modules:/home/runner/work/skybridge/skybridge/node_modules/.pnpm/skybridge@0.31.4_@modelcontextprotocol+sdk@1.26.0_zod@4.3.6__@skybridge+devtools@0.31.4_e6e9775b0d1679917fb4d52fdd54194a/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/node_modules:$NODE_PATH"
16
16
  fi
17
17
  if [ -x "$basedir/node" ]; then
18
18
  exec "$basedir/node" "$basedir/../skybridge/bin/run.js" "$@"
@@ -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.1_@types+node@25.2.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.2.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.2.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"
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.1_@types+node@25.2.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.2.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.2.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"
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" "$@"
@@ -6,28 +6,36 @@
6
6
  "type": "module",
7
7
  "scripts": {
8
8
  "dev": "skybridge dev",
9
+ "dev:tunnel": "skybridge dev --tunnel",
9
10
  "build": "skybridge build",
10
11
  "start": "skybridge start",
11
12
  "deploy": "alpic deploy"
12
13
  },
13
14
  "dependencies": {
14
- "@modelcontextprotocol/sdk": "^1.26.0",
15
+ "@alpic-ai/ui": "^1.122.0",
16
+ "@modelcontextprotocol/sdk": "^1.29.0",
17
+ "lucide-react": "^1.14.0",
15
18
  "react": "^19.2.4",
16
19
  "react-dom": "^19.2.4",
17
- "skybridge": ">=0.31.4 <1.0.0",
18
- "vite": "^7.3.1",
20
+ "skybridge": ">=0.0.0-dev.e76a366",
21
+ "sonner": "^2.0.7",
22
+ "tw-animate-css": "^1.4.0",
23
+ "vite": "^8.0.3",
19
24
  "zod": "^4.3.6"
20
25
  },
21
26
  "devDependencies": {
22
- "@skybridge/devtools": ">=0.31.4 <1.0.0",
23
- "@types/react": "^19.2.13",
27
+ "@skybridge/devtools": ">=0.35.14 <1.0.0",
28
+ "@tailwindcss/vite": "^4.2.4",
29
+ "@types/node": "^24.12.0",
30
+ "@types/react": "^19.2.14",
24
31
  "@types/react-dom": "^19.2.3",
25
- "@vitejs/plugin-react": "^5.1.4",
26
- "alpic": "^1.89.0",
32
+ "@vitejs/plugin-react": "^6.0.1",
33
+ "alpic": "^1.104.1",
34
+ "tailwindcss": "^4.2.4",
27
35
  "tsx": "^4.21.0",
28
- "typescript": "^5.9.3"
36
+ "typescript": "^6.0.2"
29
37
  },
30
38
  "engines": {
31
- "node": ">=24.13.0"
39
+ "node": ">=24.14.1"
32
40
  }
33
41
  }
@@ -0,0 +1,4 @@
1
+ import { generateHelpers } from "skybridge/web";
2
+ import type { AppType } from "./server.js";
3
+
4
+ export const { useToolInfo, useCallTool } = generateHelpers<AppType>();
@@ -0,0 +1,59 @@
1
+ @import url("https://fonts.googleapis.com/css2?family=Mozilla+Text:wght@400..700&display=swap");
2
+ @import "tailwindcss";
3
+ @import "tw-animate-css";
4
+ @import "@alpic-ai/ui/theme";
5
+
6
+ @source "../node_modules/@alpic-ai/ui/src";
7
+
8
+ @theme {
9
+ --font-mozilla: "Mozilla Text", serif;
10
+ --animate-float: float 3s ease-in-out infinite;
11
+ --animate-twirl: twirl 20s ease-in-out infinite;
12
+ --animate-aurora: aurora 20s ease-in-out infinite;
13
+ --animate-gradient-flow: gradient-flow 6s linear infinite;
14
+ }
15
+
16
+ @keyframes gradient-flow {
17
+ 0% {
18
+ background-position: 200% 50%;
19
+ }
20
+ 100% {
21
+ background-position: 0% 50%;
22
+ }
23
+ }
24
+
25
+ @keyframes aurora {
26
+ 0%,
27
+ 100% {
28
+ background-position: 0% 50%;
29
+ }
30
+ 50% {
31
+ background-position: 100% 50%;
32
+ }
33
+ }
34
+
35
+ @keyframes float {
36
+ 0%,
37
+ 100% {
38
+ transform: translateY(0);
39
+ }
40
+ 50% {
41
+ transform: translateY(-6px);
42
+ }
43
+ }
44
+
45
+ @keyframes twirl {
46
+ 0%,
47
+ 80% {
48
+ transform: rotateY(0deg);
49
+ }
50
+ 85% {
51
+ transform: rotateY(180deg);
52
+ }
53
+ 95% {
54
+ transform: rotateY(180deg);
55
+ }
56
+ 100% {
57
+ transform: rotateY(360deg);
58
+ }
59
+ }
@@ -0,0 +1,77 @@
1
+ import { McpServer } from "skybridge/server";
2
+ import { z } from "zod";
3
+
4
+ const server = new McpServer(
5
+ {
6
+ name: "alpic-openai-app",
7
+ version: "0.0.1",
8
+ },
9
+ { capabilities: {} },
10
+ )
11
+ .registerTool(
12
+ {
13
+ name: "start",
14
+ description: "Onboard Skybridge",
15
+ inputSchema: {
16
+ name: z.string().optional().describe("The user name."),
17
+ },
18
+ view: {
19
+ component: "onboarding",
20
+ description: "Onboarding deck",
21
+ csp: {
22
+ resourceDomains: [
23
+ "https://fonts.googleapis.com",
24
+ "https://fonts.gstatic.com",
25
+ ],
26
+ redirectDomains: ["https://docs.skybridge.tech"],
27
+ },
28
+ },
29
+ },
30
+ async ({ name }) => {
31
+ return {
32
+ structuredContent: { name },
33
+ content: [{ type: "text", text: `User name: ${name}` }],
34
+ isError: false,
35
+ };
36
+ },
37
+ )
38
+ .registerTool(
39
+ {
40
+ name: "get-fortune-cookie",
41
+ description: "Get fortune cookie",
42
+ },
43
+ async () => {
44
+ const predictions = [
45
+ "A pleasant surprise is waiting for you.",
46
+ "Your hard work will soon pay off.",
47
+ "An unexpected friendship will brighten your week.",
48
+ "The best is yet to come.",
49
+ "A small step today leads to a giant leap tomorrow.",
50
+ "Trust your instincts: they are sharper than you think.",
51
+ "Adventure awaits just around the corner.",
52
+ "A long-forgotten idea will return with great success.",
53
+ "Kindness given today will be returned threefold.",
54
+ "Something you lost will soon be found.",
55
+ ];
56
+ const prediction =
57
+ predictions[Math.floor(Math.random() * predictions.length)];
58
+
59
+ // simulate backend work
60
+ await new Promise((resolve) => setTimeout(resolve, 1000));
61
+
62
+ return {
63
+ structuredContent: { prediction },
64
+ content: [{ type: "text", text: prediction }],
65
+ isError: false,
66
+ };
67
+ },
68
+ );
69
+
70
+ if (process.env.NODE_ENV === "production") {
71
+ const { default: manifest } = await import("./vite-manifest.js");
72
+ server.setViteManifest(manifest);
73
+ }
74
+
75
+ export default await server.run();
76
+
77
+ export type AppType = typeof server;
@@ -0,0 +1,22 @@
1
+ import type { ReactNode } from "react";
2
+ import { useOpenExternal } from "skybridge/web";
3
+
4
+ export default function DocLink({
5
+ href,
6
+ children,
7
+ }: {
8
+ href: string;
9
+ children: ReactNode;
10
+ }) {
11
+ // useOpenExternal: open a URL in a new browser tab from inside the iframe.
12
+ const openExternal = useOpenExternal();
13
+ return (
14
+ <button
15
+ type="button"
16
+ onClick={() => openExternal(href)}
17
+ className="underline underline-offset-4"
18
+ >
19
+ {children}
20
+ </button>
21
+ );
22
+ }
@@ -0,0 +1,21 @@
1
+ import type { ReactNode } from "react";
2
+
3
+ export default function Doc({ children }: { children: ReactNode }) {
4
+ return (
5
+ <p className="flex items-start gap-2 type-text-xs text-muted-foreground mt-auto">
6
+ <svg
7
+ viewBox="0 0 90 90"
8
+ xmlns="http://www.w3.org/2000/svg"
9
+ role="img"
10
+ aria-label="Skybridge"
11
+ className="size-4 shrink-0 mt-0.5"
12
+ >
13
+ <path
14
+ d="M17.2704 89.9987C37.5976 24.3967 65.182 12.9084 89.9996 35.3807V84.1606C89.9996 87.3849 87.3858 89.9987 84.1615 89.9987H17.2704ZM84.1615 0C87.3858 0 89.9996 2.6139 89.9996 5.83819V30.9146C52.0566 -5.26767 14.9006 31.2366 0.000976562 57.6768V5.83819C0.00104114 2.6139 2.61486 2.23904e-08 5.83917 0H84.1615Z"
15
+ fill="currentColor"
16
+ />
17
+ </svg>
18
+ <span>{children}</span>
19
+ </p>
20
+ );
21
+ }
@@ -0,0 +1,31 @@
1
+ import { Button } from "@alpic-ai/ui/components/button";
2
+ import { CheckCheck } from "lucide-react";
3
+
4
+ export default function Nav({
5
+ current,
6
+ total,
7
+ onChange,
8
+ }: {
9
+ current: number;
10
+ total: number;
11
+ onChange: (index: number) => void;
12
+ }) {
13
+ return (
14
+ <div className="flex justify-end gap-2 mt-auto">
15
+ <Button
16
+ variant="secondary"
17
+ disabled={current === 0}
18
+ onClick={() => onChange(Math.max(current - 1, 0))}
19
+ >
20
+ Previous
21
+ </Button>
22
+ <Button
23
+ disabled={current === total - 1}
24
+ onClick={() => onChange(Math.min(current + 1, total - 1))}
25
+ >
26
+ <CheckCheck />
27
+ Next
28
+ </Button>
29
+ </div>
30
+ );
31
+ }