stackblitz-install-auth

StackBlitz Install & Auth

Overview

Set up the WebContainer API for running Node.js in the browser, or the StackBlitz SDK for embedding interactive code editors. WebContainers require no auth -- they run entirely client-side. The StackBlitz SDK is for embedding projects from stackblitz.com.

Prerequisites

• Node.js 18+ for build tooling
• Modern browser with SharedArrayBuffer support (requires HTTPS + COOP/COEP headers)

Instructions

Step 1: Install WebContainer API

npm install @webcontainer/api

Step 2: Install StackBlitz SDK (for embedding)

npm install @stackblitz/sdk

Step 3: Configure Required HTTP Headers

WebContainers require cross-origin isolation. Add these headers to your server:

// Express middleware
app.use((req, res, next) => {
  res.setHeader('Cross-Origin-Embedder-Policy', 'require-corp');
  res.setHeader('Cross-Origin-Opener-Policy', 'same-origin');
  next();
});

// Vite config
export default defineConfig({
  server: {
    headers: {
      'Cross-Origin-Embedder-Policy': 'require-corp',
      'Cross-Origin-Opener-Policy': 'same-origin',
    },
  },
});

Step 4: Verify WebContainer Boot

import { WebContainer } from '@webcontainer/api';

const wc = await WebContainer.boot();
console.log('WebContainer booted successfully');

// Verify filesystem works
await wc.mount({ 'test.txt': { file: { contents: 'Hello WebContainers!' } } });
const content = await wc.fs.readFile('/test.txt', 'utf-8');
console.log(`File content: ${content}`);

Output

WebContainer booted successfully
File content: Hello WebContainers!

Error Handling

Error	Cause	Solution
SharedArrayBuffer is not defined	Missing COOP/COEP headers	Add cross-origin isolation headers
Failed to boot	Multiple instances	Only one WebContainer per page
Not in secure context	HTTP instead of HTTPS	Use HTTPS or localhost

Resources

• WebContainer API Docs
• WebContainer Quickstart
• StackBlitz SDK

Next Steps

Proceed to stackblitz-hello-world for your first WebContainer project.