# Stackblitz Rate Limits

> 'WebContainer resource limits: memory, CPU, file system size, process count. Use when working with WebContainers or StackBlitz SDK. Trigger: "webcontainer limits". '

- Skill: `thedixitjain/stackblitz-rate-limits` (Agent Skill)
- Install (CLI): `npx skillmds add thedixitjain/stackblitz-rate-limits`
- Raw SKILL.md: https://api.skillmd.com/api/skills/thedixitjain/stackblitz-rate-limits/raw
- Safety review: pending
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: AI & ML
- Author: thedixitjain (https://skillmd.com/u/thedixitjain)
- Updated: 2026-09-08
- Page: https://skillmd.com/skills/thedixitjain/stackblitz-rate-limits

---


# StackBlitz Rate Limits

## Overview

WebContainer resource limits: memory, CPU, file system size, process count.

## Instructions

### Step 1: WebContainer Resource Limits

| Resource | Limit | Notes |
|----------|-------|-------|
| Memory | ~2GB | Shared with browser tab |
| File system | Ephemeral, in-memory | Lost on page refresh |
| Processes | Multiple concurrent | Each consumes memory |
| Network | HTTP only | No raw TCP/UDP sockets |
| npm packages | Most work | Native addons not supported |

### Step 2: Handle Memory Pressure

```typescript
// Monitor memory usage inside WebContainer
const proc = await wc.spawn('node', ['-e', `
  setInterval(() => {
    const mem = process.memoryUsage();
    const mbUsed = Math.round(mem.heapUsed / 1024 / 1024);
    if (mbUsed > 500) console.warn('High memory: ' + mbUsed + 'MB');
  }, 5000);
`]);
```

### Step 3: Optimize File System Size

```typescript
// Mount only essential files -- skip test files, docs, etc.
const productionFiles: FileSystemTree = {
  'package.json': { file: { contents: minimalPackageJson } },
  src: { directory: { /* only source files */ } },
  // Skip: tests/, docs/, .git/, large assets
};
await wc.mount(productionFiles);
```

## Error Handling

| Issue | Cause | Solution |
|-------|-------|----------|
| Tab crashes | OOM | Reduce mounted files, fewer deps |
| Slow npm install | Large deps | Use --prefer-offline, fewer packages |
| Process killed | Memory limit | Monitor with memoryUsage() |

## Resources

- [WebContainer Guides](https://webcontainers.io/guides/introduction)

## Next Steps

For security, see `stackblitz-security-basics`.

---

**Source:** [`jeremylongshore/claude-code-plugins-plus-skills`](https://github.com/jeremylongshore/claude-code-plugins-plus-skills) → `plugins/saas-packs/stackblitz-pack/skills/stackblitz-rate-limits/SKILL.md`