release sdk-v0.12.0

.bundlewatch.config.js

@@ -12,18 +12,18 @@ module.exports = {
       path: './build/livecodes/*(app|embed|headless).*.js',
       maxSize: '120kB',
     },
-    // {
-    //   path: './build/livecodes/lang-*.js',
-    //   maxSize: '10kB',
-    // },
+    {
+      path: './build/livecodes/lang-*.js',
+      maxSize: '10kB',
+    },
     {
       path: './build/livecodes/*.css',
       maxSize: '25kB',
     },
-    // {
-    //   path: './build/livecodes/i18n-*.json',
-    //   maxSize: '10kB',
-    // },
+    {
+      path: './build/livecodes/i18n-*.json',
+      maxSize: '15kB',
+    },
   ],
   defaultCompression: 'brotli',
   normalizeFilenames: /^.+?((\.[^.]{8,}}?)|())\.\w+$/,

.dockerignore

@@ -0,0 +1,20 @@
+node_modules
+*/node_modules
+*/build
+docs/.docusaurus
+.vscode
+.jest
+build
+dist
+.cache
+**/*.log
+.env
+docs/docs/api
+docs/static/**/*.html.md
+docs/static/llms.txt
+docs/static/llms-full.txt
+/test-results/
+/playwright-report/
+/playwright/.cache/
+src/livecodes/i18n/locales/tmp/
+lokalise_tmp

.gitattributes

@@ -0,0 +1 @@
+*.sh text eol=lf

.github/workflows/bundle-size.yml

@@ -0,0 +1,17 @@
+name: Bundle Size
+
+on: [pull_request]
+
+jobs:
+  build:
+    runs-on: ubuntu-latest
+
+    steps:
+      - uses: actions/checkout@v4
+      - uses: preactjs/compressed-size-action@v2
+        with:
+          build-script: 'build:app'
+          pattern: './build/**/*.{js,css,html,json}'
+          strip-hash: "\\b\\w{32}\\."
+          minimum-change-threshold: 200
+          compression: 'brotli'

.github/workflows/docker-deploy.yml

@@ -0,0 +1,28 @@
+name: Docker Deploy
+
+on:
+  push:
+    branches:
+      - main
+
+jobs:
+  deploy:
+    runs-on: ubuntu-latest
+    steps:
+      - name: SSH to server
+        uses: appleboy/ssh-action@v1
+        with:
+          host: ${{ secrets.VPS_HOST }}
+          username: ${{ secrets.VPS_USER }}
+          key: ${{ secrets.VPS_KEY }}
+          passphrase: ${{ secrets.VPS_PASSPHRASE }}
+          script: |
+            set -e
+            cd livecodes
+            git checkout main
+            git pull origin main
+            echo "${{ vars.VPS_ENV }}" > .env
+            docker compose build
+            docker compose up -d
+            docker container prune -f
+            docker image prune -a -f

.github/workflows/release.yml

@@ -82,6 +82,13 @@ jobs:
           CF_ZONE: ${{ secrets.CF_ZONE }}
           CF_TOKEN: ${{ secrets.CF_TOKEN }}
 
+      # - name: Build and Push to Docker Hub
+      #   run: |
+      #     echo ${{secrets.DOCKERHUB_TOKEN}} | docker login --username ${{ vars.DOCKERHUB_USERNAME }} --password-stdin
+      #     docker build -t ${{ vars.DOCKERHUB_USERNAME }}/livecodes:latest -t ${{ vars.DOCKERHUB_USERNAME }}/livecodes:${{steps.vars.outputs.version}} .
+      #     docker push ${{ vars.DOCKERHUB_USERNAME }}/livecodes:latest
+      #     docker push ${{ vars.DOCKERHUB_USERNAME }}/livecodes:${{steps.vars.outputs.version}}
+
       - name: Publish SDK to NPM
         if: startsWith(github.head_ref, 'releases/sdk-v')
         run: |

.gitignore

@@ -4,6 +4,8 @@ dist
 .cache
 **/*.log
 .env
+/ignore
+*.ignore.*
 docs/docs/api
 docs/static/**/*.html.md
 docs/static/llms.txt
@@ -13,3 +15,4 @@ docs/static/llms-full.txt
 /playwright/.cache/
 src/livecodes/i18n/locales/tmp/
 lokalise_tmp
+/server/data

.jest/setup.ts

@@ -0,0 +1,6 @@
+import pkg from '../package.json';
+import { languages } from '../src/livecodes/languages/languages';
+import { processors } from '../src/livecodes/languages/processors';
+
+process.env.VERSION = pkg.appVersion;
+(window as any).deps = { languages, processors };

.nvmrc

@@ -1 +1 @@
-v18.20.4
+v24.4.1

.vscode/settings.json

@@ -24,7 +24,8 @@
     "Build",
     "services",
     "CommandMenu",
-    "Accessibility"
+    "Accessibility",
+    "self-hosting"
   ],
   "html.customData": ["./.vscode/html.html-data.json"]
 }

CHANGELOG.md

@@ -4,6 +4,26 @@ All notable changes to this project will be documented in this file. See [standa
 
 ---
 
+## [sdk-v0.12.0](https://github.com/live-codes/livecodes/compare/sdk-v0.11.1...sdk-v0.12.0) (2025-10-04)
+
+### Features
+
+- **SDK:** allow return value of `getShareUrl()` to be used as `appUrl` ([1294cb9](https://github.com/live-codes/livecodes/commit/1294cb97a82c5c01ee6685e2c7acbdfc37f61e12))
+
+### Bug Fixes
+
+- **SDK:** clean-up SDK event handlers ([3c1184f](https://github.com/live-codes/livecodes/commit/3c1184f9555e609ab757ab66ba4162a2f33e4f7d))
+- **SDK:** fix `height` in Vue SDK ([79b4a70](https://github.com/live-codes/livecodes/commit/79b4a70629c34497bc5cff78e0acacc90e0d5e00))
+- **SDK:** force destroy playground even if stuck (e.g. in infinite loop) ([c44fe3e](https://github.com/live-codes/livecodes/commit/c44fe3ecaf069cccb7711028664bcd89a79ef824))
+
+### Credits
+
+- @felixhuttmann added force destroying playground even if stuck
+
+Thank you ❤️
+
+---
+
 ## [sdk-v0.11.1](https://github.com/live-codes/livecodes/compare/v46...sdk-v0.11.1) (2025-05-24)
 
 ### Bug Fixes

Dockerfile

@@ -0,0 +1,52 @@
+FROM node:24.4.1-alpine3.22 AS builder
+
+RUN apk update --no-cache && apk add --no-cache git
+
+WORKDIR /app
+
+COPY package*.json ./
+COPY docs/package*.json docs/
+COPY storybook/package*.json storybook/
+COPY server/package*.json server/
+
+RUN npm ci
+
+COPY . .
+
+ARG SELF_HOSTED
+ARG SELF_HOSTED_SHARE
+ARG SELF_HOSTED_BROADCAST
+ARG BROADCAST_PORT
+ARG SANDBOX_HOST_NAME
+ARG SANDBOX_PORT
+ARG FIREBASE_CONFIG
+ARG DOCS_BASE_URL
+ARG NODE_OPTIONS
+
+RUN if [ "$DOCS_BASE_URL" == "null" ]; \
+  then npm run build:app; \
+  else npm run build; \
+  fi
+
+FROM node:24.4.1-alpine3.22 AS server
+
+RUN addgroup -S appgroup
+RUN adduser -S appuser -G appgroup
+
+RUN mkdir -p /srv && chown -R appuser:appgroup /srv
+
+USER appuser
+
+WORKDIR /srv
+
+COPY server/package*.json ./
+
+RUN npm ci
+
+COPY --from=builder /app/build/ build/
+
+COPY functions/ functions/
+COPY server/src/ server/src/
+COPY src/livecodes/html/sandbox/ server/src/sandbox/
+
+CMD ["node", "server/src/app.ts"]

README.md

@@ -13,11 +13,11 @@ A [feature-rich](https://livecodes.io/docs/features/), open-source, **client-sid
 [![LiveCodes: npm version](https://img.shields.io/npm/v/livecodes)](https://www.npmjs.com/package/livecodes)
 [![LiveCodes: npm downloads](https://img.shields.io/npm/dm/livecodes)](https://www.npmjs.com/package/livecodes)
 [![LiveCodes: jsdelivr downloads](https://data.jsdelivr.com/v1/package/npm/livecodes/badge?style=rounded)](https://www.jsdelivr.com/package/npm/livecodes)
-[![LiveCodes: languages](https://img.shields.io/badge/languages-96-blue)](https://livecodes.io/docs/languages/)
+[![LiveCodes: languages](https://img.shields.io/badge/languages-97-blue)](https://livecodes.io/docs/languages/)
 [![LiveCodes: docs](https://img.shields.io/badge/Documentation-575757?logo=gitbook&logoColor=white)](https://livecodes.io/docs/)
 [![LiveCodes: llms.txt](https://img.shields.io/badge/llms.txt-575757?logo=googledocs&logoColor=white)](https://livecodes.io/docs/llms.txt)
 [![LiveCodes: llms-full.txt](https://img.shields.io/badge/llms--full.txt-575757?logo=googledocs&logoColor=white)](https://livecodes.io/docs/llms-full.txt)
-[![Codacy Badge](https://app.codacy.com/project/badge/Grade/3d39f15618e048db9d13c2a0e8002b33)](https://www.codacy.com/gh/live-codes/livecodes/dashboard?utm_source=github.com&utm_medium=referral&utm_content=live-codes/livecodes&utm_campaign=Badge_Grade)
+[![Codacy Badge](https://app.codacy.com/project/badge/Grade/3d39f15618e048db9d13c2a0e8002b33)](https://app.codacy.com/gh/live-codes/livecodes/dashboard?utm_source=gh&utm_medium=referral&utm_content=&utm_campaign=Badge_grade)
 [![Lokalise: translated](https://img.shields.io/endpoint?url=https://raw.githubusercontent.com/live-codes/lokalise-badge/main/badges/translated.json)](https://app.lokalise.com/public/34958094667a72e9454592.95108106/)
 [![Lokalise: UI languages](https://img.shields.io/endpoint?url=https://raw.githubusercontent.com/live-codes/lokalise-badge/main/badges/languages.json)](https://app.lokalise.com/public/34958094667a72e9454592.95108106/)
 [![license - MIT](https://img.shields.io/github/license/live-codes/livecodes)](https://github.com/live-codes/livecodes/blob/develop/LICENSE)
@@ -85,7 +85,7 @@ Add this code to your page:
 #### Self-hosted
 
 1. Download a [release](https://github.com/live-codes/livecodes/releases)
-2. Put it on a static file server (for free!) <sup><a href="https://pages.cloudflare.com/" target="_blank" rel="noopener">1</a>, <a href="https://vercel.com/" target="_blank" rel="noopener">2</a>, <a href="https://www.netlify.com/" target="_blank" rel="noopener">3</a>, <a href="https://firebase.google.com/" target="_blank" rel="noopener">4</a>, <a href="https://pages.github.com/" target="_blank" rel="noopener">5</a></sup>
+2. Put it on a static file server (for free!) <sup><a href="https://pages.cloudflare.com/" target="_blank" rel="noopener">1</a>, <a href="https://www.netlify.com/" target="_blank" rel="noopener">2</a>, <a href="https://firebase.google.com/" target="_blank" rel="noopener">3</a>, <a href="https://pages.github.com/" target="_blank" rel="noopener">4</a></sup>
 
    <sup>Check the guide for <a href="https://livecodes.io/docs/features/self-hosting" target="_blank" rel="noopener">self-hosting</a> (including the built-in setup to deploy to GitHub Pages).</sup>
 
@@ -270,8 +270,13 @@ LiveCodes uses services that are generously provided by:
 </img></a><br /><br />
 </p>
 <p>
-<a href="https://codeium.com/" target="_blank" title="Codeium">
-  <img alt="Codeium" width="200" src="https://dev.livecodes.io/docs/img/credits/codeium.svg">
+<a href="https://windsurf.com/" target="_blank" title="Windsurf">
+  <img alt="Windsurf" width="200" src="https://dev.livecodes.io/docs/img/credits/windsurf.svg">
+</img></a><br /><br />
+</p>
+<p>
+<a href="https://m.do.co/c/fb8c00b45b91" target="_blank" title="DigitalOcean">
+  <img alt="DigitalOcean" width="200" src="https://dev.livecodes.io/docs/img/credits/digital-ocean.svg">
 </img></a><br /><br />
 </p>
 <p>

docker-compose.yml

@@ -0,0 +1,83 @@
+services:
+  app:
+    build:
+      context: .
+      dockerfile: Dockerfile
+      args:
+        - SELF_HOSTED=true
+        - SELF_HOSTED_SHARE=${SELF_HOSTED_SHARE:-true}
+        - SELF_HOSTED_BROADCAST=${SELF_HOSTED_BROADCAST:-true}
+        - BROADCAST_PORT=${BROADCAST_PORT:-3030}
+        - SANDBOX_HOST_NAME=${SANDBOX_HOST_NAME:-${HOST_NAME:-livecodes.localhost}}
+        - SANDBOX_PORT=${SANDBOX_PORT:-8090}
+        - FIREBASE_CONFIG=${FIREBASE_CONFIG:-}
+        - DOCS_BASE_URL=${DOCS_BASE_URL:-null}
+        - LOCAL_MODULES=${LOCAL_MODULES:-false}
+        - NODE_OPTIONS=--max-old-space-size=4096
+    restart: unless-stopped
+    environment:
+      - SELF_HOSTED=true
+      - HOST_NAME=${HOST_NAME:-livecodes.localhost}
+      - PORT=${PORT:-443}
+      - SELF_HOSTED_SHARE=${SELF_HOSTED_SHARE:-true}
+      - SELF_HOSTED_BROADCAST=${SELF_HOSTED_BROADCAST:-true}
+      - BROADCAST_PORT=${BROADCAST_PORT:-3030}
+      - BROADCAST_TOKENS=${BROADCAST_TOKENS:-}
+      - SANDBOX_HOST_NAME=${SANDBOX_HOST_NAME:-${HOST_NAME:-livecodes.localhost}}
+      - SANDBOX_PORT=${SANDBOX_PORT:-8090}
+      - LOG_URL=${LOG_URL:-null}
+      - VALKEY_HOST=valkey
+      - VALKEY_PORT=6379
+      - NODE_OPTIONS=--max-old-space-size=4096
+    volumes:
+      - ./assets:/srv/build/assets
+    depends_on:
+      - valkey
+
+  valkey:
+    image: valkey/valkey:8.1.2-alpine3.22
+    restart: on-failure
+    volumes:
+      - valkey-data:/data
+    command:
+      [
+        "sh",
+        "-c",
+        'if [ "$SELF_HOSTED_SHARE" != "false" ]; then valkey-server --save 60 1 --loglevel warning; fi',
+      ]
+
+  server:
+    image: caddy:2.10.0-alpine
+    entrypoint: ["/bin/sh", "./entrypoint.sh"]
+    command:
+      [
+        "caddy",
+        "run",
+        "--config",
+        "/etc/caddy/Caddyfile",
+        "--adapter",
+        "caddyfile",
+      ]
+    restart: unless-stopped
+    ports:
+      - "80:80"
+      - "${PORT:-443}:${PORT:-443}"
+      - "${SANDBOX_PORT:-8090}:${SANDBOX_PORT:-8090}"
+      - "${BROADCAST_PORT:-3030}:${BROADCAST_PORT:-3030}"
+    environment:
+      - HOST_NAME=${HOST_NAME:-livecodes.localhost}
+      - PORT=${PORT:-443}
+      - SANDBOX_HOST_NAME=${SANDBOX_HOST_NAME:-${HOST_NAME:-livecodes.localhost}}
+      - SANDBOX_PORT=${SANDBOX_PORT:-8090}
+      - BROADCAST_PORT=${BROADCAST_PORT:-3030}
+    volumes:
+      - ./server/caddy/entrypoint.sh:/srv/entrypoint.sh
+      - ./server/caddy/Caddyfile:/etc/caddy/Caddyfile
+      - ./server/data/caddy/data:/data
+      - ./server/data/caddy/config:/config
+    depends_on:
+      - app
+
+volumes:
+  valkey-data:
+    name: livecodes-share-data