create-skybridge 0.0.0-dev.137fc79 → 0.0.0-dev.13828c9

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 (149) hide show
  1. package/dist/index.js +342 -210
  2. package/package.json +9 -8
  3. package/templates/blank/.dockerignore +4 -0
  4. package/templates/blank/AGENTS.md +1 -0
  5. package/templates/blank/Dockerfile +53 -0
  6. package/templates/blank/README.md +93 -0
  7. package/{template → templates/blank}/_gitignore +3 -1
  8. package/templates/blank/node_modules/.bin/alpic +21 -0
  9. package/templates/blank/node_modules/.bin/sb +21 -0
  10. package/templates/blank/node_modules/.bin/skybridge +21 -0
  11. package/{template → templates/blank}/node_modules/.bin/tsc +2 -2
  12. package/{template → templates/blank}/node_modules/.bin/tsserver +2 -2
  13. package/{template → templates/blank}/node_modules/.bin/tsx +2 -2
  14. package/templates/blank/node_modules/.bin/vite +21 -0
  15. package/templates/blank/package.json +29 -0
  16. package/templates/blank/src/helpers.ts +4 -0
  17. package/templates/blank/src/index.ts +3 -0
  18. package/templates/blank/src/server.ts +15 -0
  19. package/templates/blank/tsconfig.json +5 -0
  20. package/templates/blank/vite.config.ts +12 -0
  21. package/templates/demo/.dockerignore +4 -0
  22. package/templates/demo/AGENTS.md +1 -0
  23. package/templates/demo/Dockerfile +53 -0
  24. package/templates/demo/README.md +96 -0
  25. package/templates/demo/_gitignore +7 -0
  26. package/templates/demo/alpic.json +3 -0
  27. package/templates/demo/node_modules/.bin/alpic +21 -0
  28. package/templates/demo/node_modules/.bin/sb +21 -0
  29. package/templates/demo/node_modules/.bin/skybridge +21 -0
  30. package/templates/demo/node_modules/.bin/tsc +21 -0
  31. package/templates/demo/node_modules/.bin/tsserver +21 -0
  32. package/templates/demo/node_modules/.bin/tsx +21 -0
  33. package/templates/demo/node_modules/.bin/vite +21 -0
  34. package/templates/demo/package.json +41 -0
  35. package/templates/demo/src/helpers.ts +4 -0
  36. package/templates/demo/src/index.css +59 -0
  37. package/templates/demo/src/index.ts +3 -0
  38. package/templates/demo/src/server.ts +95 -0
  39. package/templates/demo/src/views/components/doc-link.tsx +22 -0
  40. package/templates/demo/src/views/components/doc.tsx +21 -0
  41. package/templates/demo/src/views/components/nav.tsx +31 -0
  42. package/templates/demo/src/views/components/progress.tsx +35 -0
  43. package/templates/demo/src/views/components/steps/outro.tsx +68 -0
  44. package/templates/demo/src/views/components/steps/state.tsx +47 -0
  45. package/templates/demo/src/views/components/steps/tool-call.tsx +53 -0
  46. package/templates/demo/src/views/components/steps/tool-output.tsx +40 -0
  47. package/templates/demo/src/views/images/mascot/beret.png +0 -0
  48. package/templates/demo/src/views/images/mascot/chapka.png +0 -0
  49. package/templates/demo/src/views/images/mascot/cowboy-hat.png +0 -0
  50. package/templates/demo/src/views/images/mascot/fez.png +0 -0
  51. package/templates/demo/src/views/images/mascot/jester-hat.png +0 -0
  52. package/templates/demo/src/views/images/mascot/mitre.png +0 -0
  53. package/templates/demo/src/views/images/mascot/non-la.png +0 -0
  54. package/templates/demo/src/views/images/mascot/original.png +0 -0
  55. package/templates/demo/src/views/images/mascot/propeller-beanie.png +0 -0
  56. package/templates/demo/src/views/images/mascot/ski-mask.png +0 -0
  57. package/templates/demo/src/views/images/mascot/sombrero.png +0 -0
  58. package/templates/demo/src/views/images/mascot/top-hat.png +0 -0
  59. package/templates/demo/src/views/images/mascot/viking-helmet.png +0 -0
  60. package/templates/demo/src/views/onboarding.tsx +63 -0
  61. package/templates/demo/src/views/use-mascot.ts +60 -0
  62. package/templates/demo/tsconfig.json +11 -0
  63. package/templates/demo/vite.config.ts +20 -0
  64. package/templates/ecom/.dockerignore +4 -0
  65. package/templates/ecom/.env.template +7 -0
  66. package/templates/ecom/.ladle/components.tsx +26 -0
  67. package/templates/ecom/.ladle/config.mjs +11 -0
  68. package/templates/ecom/.ladle/vite.config.ts +11 -0
  69. package/templates/ecom/AGENTS.md +2 -0
  70. package/templates/ecom/Dockerfile +53 -0
  71. package/templates/ecom/README.md +93 -0
  72. package/templates/ecom/_gitignore +9 -0
  73. package/templates/ecom/alpic.json +3 -0
  74. package/templates/ecom/node_modules/.bin/alpic +21 -0
  75. package/templates/ecom/node_modules/.bin/ladle +21 -0
  76. package/templates/ecom/node_modules/.bin/sb +21 -0
  77. package/templates/ecom/node_modules/.bin/skybridge +21 -0
  78. package/templates/ecom/node_modules/.bin/tsc +21 -0
  79. package/templates/ecom/node_modules/.bin/tsserver +21 -0
  80. package/templates/ecom/node_modules/.bin/tsx +21 -0
  81. package/templates/ecom/node_modules/.bin/vite +21 -0
  82. package/templates/ecom/package.json +42 -0
  83. package/templates/ecom/src/catalog/index.ts +19 -0
  84. package/templates/ecom/src/catalog/mock.ts +134 -0
  85. package/templates/ecom/src/catalog/shopify.ts +264 -0
  86. package/templates/ecom/src/components/chip.css.ts +63 -0
  87. package/templates/ecom/src/components/chip.stories.tsx +27 -0
  88. package/templates/ecom/src/components/chip.tsx +49 -0
  89. package/templates/ecom/src/components/empty-state.stories.tsx +3 -0
  90. package/templates/ecom/src/components/empty-state.tsx +12 -0
  91. package/templates/ecom/src/components/expandable-text.css.ts +49 -0
  92. package/templates/ecom/src/components/expandable-text.stories.tsx +20 -0
  93. package/templates/ecom/src/components/expandable-text.tsx +53 -0
  94. package/templates/ecom/src/components/image-gallery.css.ts +172 -0
  95. package/templates/ecom/src/components/image-gallery.stories.tsx +30 -0
  96. package/templates/ecom/src/components/image-gallery.tsx +163 -0
  97. package/templates/ecom/src/components/product-card.css.ts +159 -0
  98. package/templates/ecom/src/components/product-card.stories.tsx +58 -0
  99. package/templates/ecom/src/components/product-card.tsx +102 -0
  100. package/templates/ecom/src/components/product-carousel.css.ts +134 -0
  101. package/templates/ecom/src/components/product-carousel.stories.tsx +64 -0
  102. package/templates/ecom/src/components/product-carousel.tsx +202 -0
  103. package/templates/ecom/src/components/variant-picker.css.ts +27 -0
  104. package/templates/ecom/src/components/variant-picker.stories.tsx +67 -0
  105. package/templates/ecom/src/components/variant-picker.tsx +70 -0
  106. package/templates/ecom/src/components/view-frame.css.ts +22 -0
  107. package/templates/ecom/src/components/view-frame.tsx +27 -0
  108. package/templates/ecom/src/config.ts +12 -0
  109. package/templates/ecom/src/design/contract.css.ts +39 -0
  110. package/templates/ecom/src/design/fonts.css +15 -0
  111. package/templates/ecom/src/design/primitives.css.ts +101 -0
  112. package/templates/ecom/src/design/recipes/typography.css.ts +75 -0
  113. package/templates/ecom/src/design/sprinkles.css.ts +128 -0
  114. package/templates/ecom/src/design/themes/dark.css.ts +36 -0
  115. package/templates/ecom/src/design/themes/light.css.ts +36 -0
  116. package/templates/ecom/src/design/tokens.ts +8 -0
  117. package/templates/ecom/src/helpers.ts +4 -0
  118. package/templates/ecom/src/i18n.ts +35 -0
  119. package/templates/ecom/src/index.css +9 -0
  120. package/templates/ecom/src/index.ts +3 -0
  121. package/templates/ecom/src/lib/cx.ts +9 -0
  122. package/templates/ecom/src/lib/format.ts +9 -0
  123. package/templates/ecom/src/lib/variants.ts +150 -0
  124. package/templates/ecom/src/server.ts +41 -0
  125. package/templates/ecom/src/tools/render-carousel.ts +161 -0
  126. package/templates/ecom/src/tools/search-products.ts +196 -0
  127. package/templates/ecom/src/types.ts +87 -0
  128. package/templates/ecom/src/views/carousel/detail/detail.css.ts +115 -0
  129. package/templates/ecom/src/views/carousel/detail/detail.stories.tsx +133 -0
  130. package/templates/ecom/src/views/carousel/detail/index.tsx +254 -0
  131. package/templates/ecom/src/views/carousel/index.tsx +233 -0
  132. package/templates/ecom/tsconfig.json +11 -0
  133. package/templates/ecom/vite.config.ts +8 -0
  134. package/dist/index.test.d.ts +0 -1
  135. package/dist/index.test.js +0 -33
  136. package/template/AGENTS.md +0 -1
  137. package/template/README.md +0 -97
  138. package/template/node_modules/.bin/alpic +0 -21
  139. package/template/node_modules/.bin/sb +0 -21
  140. package/template/node_modules/.bin/skybridge +0 -21
  141. package/template/node_modules/.bin/vite +0 -21
  142. package/template/package.json +0 -33
  143. package/template/server/src/index.ts +0 -62
  144. package/template/tsconfig.json +0 -9
  145. package/template/web/src/helpers.ts +0 -4
  146. package/template/web/src/index.css +0 -154
  147. package/template/web/src/widgets/magic-8-ball.tsx +0 -27
  148. package/template/web/vite.config.ts +0 -15
  149. /package/{template → templates/blank}/alpic.json +0 -0
@@ -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.18.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.18.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/__entry.js"]
@@ -0,0 +1,93 @@
1
+ # Skybridge Boilerplate
2
+
3
+ A minimal TypeScript boilerplate for building MCP and ChatGPT Apps with the [Skybridge](https://docs.skybridge.tech) framework.
4
+
5
+ ## Getting Started
6
+
7
+ ### Prerequisites
8
+
9
+ - Node.js 24+
10
+
11
+ ### Local Development
12
+
13
+ #### 1. Install
14
+
15
+ ```bash
16
+ npm install
17
+ # or
18
+ pnpm install
19
+ # or
20
+ bun install
21
+ # or
22
+ deno install
23
+ # or
24
+ yarn install
25
+ ```
26
+
27
+ #### 2. Start your local server
28
+
29
+ Run the development server from the root directory:
30
+
31
+ ```bash
32
+ npm run dev
33
+ # or
34
+ pnpm dev
35
+ # or
36
+ bun dev
37
+ # or
38
+ deno task dev
39
+ # or
40
+ yarn dev
41
+ ```
42
+
43
+ This command starts:
44
+ - Your MCP server at `http://localhost:3000/mcp`.
45
+ - Skybridge DevTools UI at `http://localhost:3000`.
46
+
47
+ #### 3. Project structure
48
+
49
+ ```
50
+ ├── src/
51
+ │ ├── index.ts # Entry point (starts the app)
52
+ │ ├── server.ts # App definition (tools, views)
53
+ │ └── helpers.ts # Shared utilities
54
+ ├── vite.config.ts
55
+ ├── alpic.json # Deployment config
56
+ └── package.json
57
+ ```
58
+
59
+ ### Create your first view
60
+
61
+ #### 1. Add a new view
62
+
63
+ - 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.
64
+ - Create a matching React component at `src/views/my-view.tsx`. **The file name must match the view name exactly**.
65
+
66
+ #### 2. Edit views with Hot Module Replacement (HMR)
67
+
68
+ Edit and save components in `src/views/` — changes will appear instantly inside your App.
69
+
70
+ #### 3. Edit server code
71
+
72
+ Modify files in `src/` and refresh the tool list with your MCP Client to see the changes.
73
+
74
+ ### Testing your App
75
+
76
+ You can test your app locally by using our DevTools UI on `http://localhost:3000` while running the `dev` command.
77
+
78
+ To connect your app with web clients like ChatGPT or Claude, expose your server on the internet by adding the `--tunnel` flag.
79
+ By enabling the tunnel, you'll also be able to access a playground to chat with your app and a real LLM. Learn more by reading the [test guide](https://docs.skybridge.tech/quickstart/test-your-app).
80
+
81
+
82
+ ## Deploy to Production
83
+
84
+ Skybridge is infrastructure vendor agnostic, and your app can be deployed on any cloud platform supporting MCP.
85
+
86
+ The simplest way to deploy your app is by running the `deploy` command, which will push your MCP server to the [Alpic](https://alpic.ai/) cloud for free.
87
+
88
+ ## Resources
89
+ - [Skybridge Documentation](https://docs.skybridge.tech/)
90
+ - [Apps SDK Documentation](https://developers.openai.com/apps-sdk)
91
+ - [MCP Apps Documentation](https://github.com/modelcontextprotocol/ext-apps/tree/main)
92
+ - [Model Context Protocol Documentation](https://modelcontextprotocol.io/)
93
+ - [Alpic Documentation](https://docs.alpic.ai/)
@@ -2,4 +2,6 @@ node_modules/
2
2
  dist/
3
3
  .env*
4
4
  .DS_store
5
- *.tsbuildinfo
5
+ *.tsbuildinfo
6
+ .skybridge/
7
+ .vercel/
@@ -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.157.0_@opentelemetry+api@1.9.1_@opentelemetry+core@2.9.0_@opentelemetry+api@1.9_8f13b9696a5fc8688953a3b2ccd28385/node_modules/alpic/node_modules:/home/runner/work/skybridge/skybridge/node_modules/.pnpm/alpic@1.157.0_@opentelemetry+api@1.9.1_@opentelemetry+core@2.9.0_@opentelemetry+api@1.9_8f13b9696a5fc8688953a3b2ccd28385/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.157.0_@opentelemetry+api@1.9.1_@opentelemetry+core@2.9.0_@opentelemetry+api@1.9_8f13b9696a5fc8688953a3b2ccd28385/node_modules/alpic/node_modules:/home/runner/work/skybridge/skybridge/node_modules/.pnpm/alpic@1.157.0_@opentelemetry+api@1.9.1_@opentelemetry+core@2.9.0_@opentelemetry+api@1.9_8f13b9696a5fc8688953a3b2ccd28385/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/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.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
14
  else
15
- export NODE_PATH="/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.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
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/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.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
14
  else
15
- export NODE_PATH="/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.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
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/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.23.1/node_modules/tsx/node_modules:/home/runner/work/skybridge/skybridge/node_modules/.pnpm/tsx@4.23.1/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/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.23.1/node_modules/tsx/node_modules:/home/runner/work/skybridge/skybridge/node_modules/.pnpm/tsx@4.23.1/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" "$@"
@@ -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/vite@8.1.5_@types+node@24.13.3_esbuild@0.28.1_jiti@2.7.0_terser@5.44.1_tsx@4.23.1_yaml@2.9.0/node_modules/vite/node_modules:/home/runner/work/skybridge/skybridge/node_modules/.pnpm/vite@8.1.5_@types+node@24.13.3_esbuild@0.28.1_jiti@2.7.0_terser@5.44.1_tsx@4.23.1_yaml@2.9.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/vite@8.1.5_@types+node@24.13.3_esbuild@0.28.1_jiti@2.7.0_terser@5.44.1_tsx@4.23.1_yaml@2.9.0/node_modules/vite/node_modules:/home/runner/work/skybridge/skybridge/node_modules/.pnpm/vite@8.1.5_@types+node@24.13.3_esbuild@0.28.1_jiti@2.7.0_terser@5.44.1_tsx@4.23.1_yaml@2.9.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/../vite/bin/vite.js" "$@"
19
+ else
20
+ exec node "$basedir/../vite/bin/vite.js" "$@"
21
+ fi
@@ -0,0 +1,29 @@
1
+ {
2
+ "name": "skybridge-blank",
3
+ "version": "0.0.1",
4
+ "private": true,
5
+ "description": "Blank Skybridge MCP server template",
6
+ "type": "module",
7
+ "scripts": {
8
+ "dev": "skybridge dev",
9
+ "dev:tunnel": "skybridge dev --tunnel",
10
+ "build": "skybridge build",
11
+ "start": "skybridge start",
12
+ "deploy": "alpic deploy"
13
+ },
14
+ "dependencies": {
15
+ "skybridge": "^0.0.0-dev.13828c9",
16
+ "vite": "^8.1.5"
17
+ },
18
+ "devDependencies": {
19
+ "@skybridge/devtools": "^1.2.7",
20
+ "@skybridge/vite-plugin": "^0.0.0-dev.13828c9",
21
+ "@types/node": "^24.13.3",
22
+ "alpic": "^1.155.0",
23
+ "tsx": "^4.23.1",
24
+ "typescript": "^6.0.3"
25
+ },
26
+ "engines": {
27
+ "node": ">=24.18.0"
28
+ }
29
+ }
@@ -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,3 @@
1
+ import { app } from "./server.js";
2
+
3
+ export default await app.run();
@@ -0,0 +1,15 @@
1
+ import { Skybridge } from "skybridge/server";
2
+
3
+ // Register tools with `server.registerTool(...)`.
4
+ // Docs: https://docs.skybridge.tech/api-reference/register-tool
5
+
6
+ export const app = new Skybridge(
7
+ {
8
+ name: "skybridge-blank",
9
+ version: "0.0.1",
10
+ capabilities: {},
11
+ },
12
+ (server) => server,
13
+ );
14
+
15
+ export type AppType = typeof app;
@@ -0,0 +1,5 @@
1
+ {
2
+ "extends": "skybridge/tsconfig",
3
+
4
+ "include": ["src", ".skybridge/**/*.d.ts"]
5
+ }
@@ -0,0 +1,12 @@
1
+ import { skybridge } from "@skybridge/vite-plugin";
2
+ import { defineConfig } from "vite";
3
+
4
+ export default defineConfig({
5
+ plugins: [skybridge()],
6
+ server: {
7
+ forwardConsole: {
8
+ unhandledErrors: true,
9
+ logLevels: ["error"],
10
+ },
11
+ },
12
+ });
@@ -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.18.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.18.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/__entry.js"]
@@ -0,0 +1,96 @@
1
+ # Skybridge Template
2
+
3
+ A starter TypeScript template for building MCP and ChatGPT Apps with the [Skybridge](https://docs.skybridge.tech) framework.
4
+
5
+ ## Getting Started
6
+
7
+ ### Prerequisites
8
+
9
+ - Node.js 24+
10
+
11
+ ### Local Development
12
+
13
+ #### 1. Install
14
+
15
+ ```bash
16
+ npm install
17
+ # or
18
+ pnpm install
19
+ # or
20
+ bun install
21
+ # or
22
+ deno install
23
+ # or
24
+ yarn install
25
+ ```
26
+
27
+ #### 2. Start your local server
28
+
29
+ Run the development server from the root directory:
30
+
31
+ ```bash
32
+ npm run dev
33
+ # or
34
+ pnpm dev
35
+ # or
36
+ bun dev
37
+ # or
38
+ deno task dev
39
+ # or
40
+ yarn dev
41
+ ```
42
+
43
+ This command starts:
44
+ - Your MCP server at `http://localhost:3000/mcp`.
45
+ - Skybridge DevTools UI at `http://localhost:3000`.
46
+
47
+ #### 3. Project structure
48
+
49
+ ```
50
+ ├── src/
51
+ │ ├── index.ts # Entry point (starts the app)
52
+ │ ├── server.ts # App definition (tools, views)
53
+ │ ├── views/ # React components (one per view)
54
+ │ ├── components/ # Shared UI components
55
+ │ ├── helpers.ts # Shared utilities
56
+ │ └── index.css # Global styles
57
+ ├── vite.config.ts
58
+ ├── alpic.json # Deployment config
59
+ └── package.json
60
+ ```
61
+
62
+ ### Create your first view
63
+
64
+ #### 1. Add a new view
65
+
66
+ - 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.
67
+ - Create a matching React component at `src/views/my-view.tsx`. **The file name must match the view name exactly**.
68
+
69
+ #### 2. Edit views with Hot Module Replacement (HMR)
70
+
71
+ Edit and save components in `src/views/` — changes will appear instantly inside your App.
72
+
73
+ #### 3. Edit server code
74
+
75
+ Modify files in `src/` and refresh the tool list with your MCP Client to see the changes.
76
+
77
+ ### Testing your App
78
+
79
+ You can test your app locally by using our DevTools UI on `http://localhost:3000` while running the `dev` command.
80
+
81
+ To connect your app with web clients like ChatGPT or Claude, expose your server on the internet by adding the `--tunnel` flag.
82
+ By enabling the tunnel, you'll also be able to access a playground to chat with your app and a real LLM. Learn more by reading the [test guide](https://docs.skybridge.tech/quickstart/test-your-app).
83
+
84
+
85
+ ## Deploy to Production
86
+
87
+ Skybridge is infrastructure vendor agnostic, and your app can be deployed on any cloud platform supporting MCP.
88
+
89
+ The simplest way to deploy your app is by running the `deploy` command, which will push your MCP server to the [Alpic](https://alpic.ai/) cloud for free.
90
+
91
+ ## Resources
92
+ - [Skybridge Documentation](https://docs.skybridge.tech/)
93
+ - [Apps SDK Documentation](https://developers.openai.com/apps-sdk)
94
+ - [MCP Apps Documentation](https://github.com/modelcontextprotocol/ext-apps/tree/main)
95
+ - [Model Context Protocol Documentation](https://modelcontextprotocol.io/)
96
+ - [Alpic Documentation](https://docs.alpic.ai/)
@@ -0,0 +1,7 @@
1
+ node_modules/
2
+ dist/
3
+ .env*
4
+ .DS_store
5
+ *.tsbuildinfo
6
+ .skybridge/
7
+ .vercel/
@@ -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.157.0_@opentelemetry+api@1.9.1_@opentelemetry+core@2.9.0_@opentelemetry+api@1.9_8f13b9696a5fc8688953a3b2ccd28385/node_modules/alpic/node_modules:/home/runner/work/skybridge/skybridge/node_modules/.pnpm/alpic@1.157.0_@opentelemetry+api@1.9.1_@opentelemetry+core@2.9.0_@opentelemetry+api@1.9_8f13b9696a5fc8688953a3b2ccd28385/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.157.0_@opentelemetry+api@1.9.1_@opentelemetry+core@2.9.0_@opentelemetry+api@1.9_8f13b9696a5fc8688953a3b2ccd28385/node_modules/alpic/node_modules:/home/runner/work/skybridge/skybridge/node_modules/.pnpm/alpic@1.157.0_@opentelemetry+api@1.9.1_@opentelemetry+core@2.9.0_@opentelemetry+api@1.9_8f13b9696a5fc8688953a3b2ccd28385/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
@@ -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/tsserver" "$@"
19
+ else
20
+ exec node "$basedir/../typescript/bin/tsserver" "$@"
21
+ fi