Local modules!

.nvmrc

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

Dockerfile

@@ -1,4 +1,4 @@
-FROM node:24.1.0-alpine3.21 AS builder
+FROM node:24.4.1-alpine3.22 AS builder
 
 RUN apk update --no-cache && apk add --no-cache git
 
@@ -11,23 +11,35 @@ COPY server/package*.json server/
 
 RUN npm ci
 
-COPY . .
-
 ARG SELF_HOSTED
+ARG HOST_NAME
+ARG PORT
 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 LOCAL_MODULES
+ARG NODE_OPTIONS
+
+COPY scripts/download-modules.js scripts/
+COPY src/livecodes/vendors.ts src/livecodes/
+COPY src/sdk/package.sdk.json src/sdk/
+
+RUN if [ "$LOCAL_MODULES" == "true" ]; \
+  then npm run download-modules; \
+  fi
+
+COPY . .
 
 RUN if [ "$DOCS_BASE_URL" == "null" ]; \
   then npm run build:app; \
   else npm run build; \
   fi
 
-FROM node:24.1.0-alpine3.21 AS server
+FROM node:24.4.1-alpine3.22 AS server
 
 RUN addgroup -S appgroup
 RUN adduser -S appuser -G appgroup

docker-compose.yml

@@ -5,13 +5,17 @@ services:
       dockerfile: Dockerfile
       args:
         - 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}
         - 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
@@ -26,6 +30,7 @@ services:
       - 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:

docs/docs/advanced/docker.mdx

@@ -169,10 +169,56 @@ The hostname and many other options can be set using [environment variables](#en
 
   Runs code in a separate origin [sandboxed iframe](https://www.html5rocks.com/en/tutorials/security/sandboxed-iframes/) to prevent cross-site scripting.
 
+- Local modules
+
+  See [Local Modules](#local-modules) section for details.
+
 - [404 page](https://livecodes.io/404)
 
   Custom 404 page for resources that are not found.
 
+## Local Modules
+
+(EXPERIMENTAL)
+
+LiveCodes depends on a large number of external modules to support a wide range of features (e.g. code editors, compilers, formatters, etc).
+These modules are loaded from CDNs (e.g. [jsDelivr](https://www.jsdelivr.com/), [unpkg](https://unpkg.com/), etc).
+So, in spite of being a client-side app, LiveCodes requires an internet connection to load these modules.
+
+However, if you want to be able to run LiveCodes without an internet connection, you can download all these modules locally by setting the [environment variable](#environment-variables) `LOCAL_MODULES=true` (it is set to `false` by default).
+In this case, all modules are downloaded during build (~ 1.5 GB), and are served locally.
+
+When working without internet connection, all resources have to be available locally. So, automatic [module resolution](../features/module-resolution.mdx) (e.g. of npm modules imported in user code) and loading type definitions for [intellisense](../features/intellisense.mdx) and auto-complete will not work out of the box.
+However, you can provide the list of modules to load using the [`imports`](../configuration/configuration-object.mdx#imports) property of the [config](../configuration/configuration-object.mdx) object (see [Custom Module Resolution](../features/module-resolution.mdx#custom-module-resolution)).
+Similarly, you can also provide the list of type definitions to load using the [`types`](../configuration/configuration-object.mdx#types) property (see [Custom Types](../features/intellisense.mdx#custom-types)).
+These modules and type definitions should be prepared in advance and made available to the running app (e.g. in the `/assets` directory - see [Volumes](#volumes)).
+
+Example:
+
+To run [React starter template](https://livecodes.io/?template=react) locally without internet connection, you need to:
+
+(assuming that the app is running on this URL: https://livecodes.localhost/)
+
+- Add [these files](https://github.com/hatemhosny/custom-modules-demo/tree/main/modules) to the [`/assets` directory](#volumes).
+- Open React starter template: https://livecodes.localhost/?template=react
+- Add this code to custom settings (Project menu → Custom Settings):
+
+```json
+{
+  "imports": {
+    "react": "https://livecodes.localhost/assets/react.js",
+    "react/compiler-runtime": "https://livecodes.localhost/assets/react-compiler-runtime.js",
+    "react/jsx-runtime": "https://livecodes.localhost/assets/react-jsx-runtime.js",
+    "react-dom": "https://livecodes.localhost/assets/react-dom.js",
+    "react-dom/client": "https://livecodes.localhost/assets/react-dom-client.js",
+    "scheduler": "https://livecodes.localhost/assets/scheduler.js"
+  },
+  "types": {
+    "react": "https://livecodes.localhost/assets/react.d.ts"
+  }
+}
+```
+
 ## Environment Variables
 
 The app can be customized by setting different environment variables.
@@ -205,6 +251,7 @@ The following environment variables are supported:
 | `FIREBASE_CONFIG` | [Firebase config object](https://firebase.google.com/docs/web/learn-more#config-object) (JSON), used for [authentication](../features/github-integration.mdx) | |
 | `DOCS_BASE_URL` | [Base URL](../features/self-hosting.mdx#custom-build) of the documentation (e.g. `/docs/`) | `null` |
 | `LOG_URL` | Full URL to send [server-side analytics](https://github.com/live-codes/livecodes/blob/develop/functions/index.ts) (e.g. `https://api.website.com/log`) | `null` |
+| `LOCAL_MODULES` | Download and use all modules locally (see [Local Modules](#local-modules)) | `false` |
 
 :::info note
 When running in a non-local environment (e.g. VPS),

docs/docs/languages/python-wasm.mdx

@@ -101,7 +101,7 @@ Check the [starter template](#starter-template) for an example.
 
 ### Version
 
-Pyodide v0.25.1, running Python v3.11.3
+Pyodide v0.28.0, running Python v3.13.2
 
 ## Code Formatting
 

eslint.config.mjs

@@ -31,6 +31,7 @@ export default [
       '**/.docusaurus',
       '**/.jest',
       '**/.storybook',
+      '**/.cache',
       'functions/vendors',
     ],
   },