TanStack Container

An experimental browser-powered sandbox for frontend and full-stack JavaScript development. Projects run in the browser using a virtual filesystem, JavaScript processes, supported package installation, app previews and saved workspaces.

The source is available on GitHub under the MIT license. The npm alpha release is being prepared. No npm packages have been published yet.

What works

The tested workflows cover Vite 7 and representative TanStack Start apps: installation, script and test execution, live edits, previews, SSR, hydration, server functions, navigation, and save/reload/resume. Private split-package candidates have passed repeated Chromium and Firefox runs. The source-bound alpha package pair is undergoing its own verification. Actual Safari remains unverified. Earlier candidate results do not approve later package builds.

This is not a complete Node.js or operating-system implementation. Native addons, arbitrary binaries, dependency install scripts and unrestricted networking are outside the supported alpha scope. Phones are a stretch goal. Offline workspace resume does not mean offline hosting or restoring a running process.

Use the SDK

The SDK is standalone, with no TanStack.com-specific runtime code:

@tanstack/browser-sandbox-experimental provides the public API and types.
@tanstack/browser-sandbox-runtime-experimental supplies the matching custom engines and workers, with upstream compilers as pinned npm dependencies.
Your app explicitly prepares and hosts browser assets. There is no automatic postinstall download.

Start with the SDK setup guide and compatibility boundaries. The basic example and Vite/Start examples demonstrate adoption. Until publication, build the package pair using BUILDING.md.

Full TanStack Start environments require an isolated owner document with the documented headers and a separate preview origin. Lightweight inline examples do not need to adopt the full runtime.

Build and contribute

BUILDING.md lists the pinned toolchains, runtime generation, package build and consumer checks. ALPHA.md is the active release checklist. Its local evidence links may refer to reports that are not included in a source snapshot; they are not shipped acceptance evidence.

Isolation limits

This is not a production security boundary for arbitrary hostile projects. Do not use sensitive source or credentials in an untrusted sandbox. Explicit permissions, quotas, deadlines and owner-controlled networking are implemented, but functional compatibility tests are not a security certification.

See LICENSE for the project license. Dependency notices are preserved in package and prepared deployment outputs.

Name		Name	Last commit message	Last commit date
.github/workflows		.github/workflows
build-inputs		build-inputs
compat		compat
examples		examples
fixtures		fixtures
integrations		integrations
licenses		licenses
patches		patches
preview-host		preview-host
scripts		scripts
shell/mvdan		shell/mvdan
src		src
tests		tests
.gitignore		.gitignore
ALPHA.md		ALPHA.md
BUILDING.md		BUILDING.md
LICENSE		LICENSE
README.md		README.md
SPIKE-FINDINGS.md		SPIKE-FINDINGS.md
index.html		index.html
package-lock.json		package-lock.json
package.json		package.json
playwright.browser-compiler.config.ts		playwright.browser-compiler.config.ts
playwright.combined.config.ts		playwright.combined.config.ts
playwright.compiler-allocation.config.ts		playwright.compiler-allocation.config.ts
playwright.compiler-scale.config.ts		playwright.compiler-scale.config.ts
playwright.compression.config.ts		playwright.compression.config.ts
playwright.config.ts		playwright.config.ts
playwright.desktop.config.ts		playwright.desktop.config.ts
playwright.engine-als.config.ts		playwright.engine-als.config.ts
playwright.esbuild-wasm-install.config.ts		playwright.esbuild-wasm-install.config.ts
playwright.feasibility.config.ts		playwright.feasibility.config.ts
playwright.fiber-compiler-bindings.config.ts		playwright.fiber-compiler-bindings.config.ts
playwright.fiber-kernel.config.ts		playwright.fiber-kernel.config.ts
playwright.fs-descriptors.config.ts		playwright.fs-descriptors.config.ts
playwright.fs-paths.config.ts		playwright.fs-paths.config.ts
playwright.generator-resume.config.ts		playwright.generator-resume.config.ts
playwright.guest-wasm.config.ts		playwright.guest-wasm.config.ts
playwright.http.config.ts		playwright.http.config.ts
playwright.http2-guest.config.ts		playwright.http2-guest.config.ts
playwright.http2-owned.config.ts		playwright.http2-owned.config.ts
playwright.http2.config.ts		playwright.http2.config.ts
playwright.import-surface.config.ts		playwright.import-surface.config.ts
playwright.install-portable.config.ts		playwright.install-portable.config.ts
playwright.install-wasm.config.ts		playwright.install-wasm.config.ts
playwright.install.config.ts		playwright.install.config.ts
playwright.intl.config.ts		playwright.intl.config.ts
playwright.kernel-compiler.config.ts		playwright.kernel-compiler.config.ts
playwright.lab-cold.config.ts		playwright.lab-cold.config.ts
playwright.large-wasm.config.ts		playwright.large-wasm.config.ts
playwright.network.config.ts		playwright.network.config.ts
playwright.node-globals.config.ts		playwright.node-globals.config.ts
playwright.pending-compat.config.ts		playwright.pending-compat.config.ts
playwright.positive-desktop.config.ts		playwright.positive-desktop.config.ts
playwright.process-candidate.config.ts		playwright.process-candidate.config.ts
playwright.processes.config.ts		playwright.processes.config.ts
playwright.production.config.ts		playwright.production.config.ts
playwright.readline.config.ts		playwright.readline.config.ts
playwright.sdk-frameworks.config.ts		playwright.sdk-frameworks.config.ts
playwright.sdk-prebundle.config.ts		playwright.sdk-prebundle.config.ts
playwright.sdk-rebundle.config.ts		playwright.sdk-rebundle.config.ts
playwright.sdk-shell.config.ts		playwright.sdk-shell.config.ts
playwright.sdk-site-counter.config.ts		playwright.sdk-site-counter.config.ts
playwright.sdk.config.ts		playwright.sdk.config.ts
playwright.secondary-checkpoints.config.ts		playwright.secondary-checkpoints.config.ts
playwright.sessions.config.ts		playwright.sessions.config.ts
playwright.stacktrace.config.ts		playwright.stacktrace.config.ts
playwright.start-native.config.ts		playwright.start-native.config.ts
playwright.start-persistence.config.ts		playwright.start-persistence.config.ts
playwright.stdio.config.ts		playwright.stdio.config.ts
playwright.svelte-native.config.ts		playwright.svelte-native.config.ts
playwright.termination.config.ts		playwright.termination.config.ts
playwright.tls-guest.config.ts		playwright.tls-guest.config.ts
playwright.tls-owned.config.ts		playwright.tls-owned.config.ts
playwright.tls-probe.config.ts		playwright.tls-probe.config.ts
playwright.validator-control.config.ts		playwright.validator-control.config.ts
playwright.vm-modules.config.ts		playwright.vm-modules.config.ts
playwright.wasm-interpreter.config.ts		playwright.wasm-interpreter.config.ts
playwright.workloads.config.ts		playwright.workloads.config.ts
playwright.workspace-assets.config.ts		playwright.workspace-assets.config.ts
pnpm-workspace.yaml		pnpm-workspace.yaml
sandbox.html		sandbox.html
tsconfig.json		tsconfig.json
tsconfig.node.json		tsconfig.node.json
vite.config.ts		vite.config.ts

Navigation Menu

Repository files navigation

TanStack Container

What works

Use the SDK

Build and contribute

Isolation limits

About

Releases

Packages

Contributors

Languages

Latest commit

History

Folders and files

Repository files navigation

TanStack Container

What works

Use the SDK

Build and contribute

Isolation limits

About

Resources

Stars

Watchers

Forks

Releases

Packages

Contributors

Languages