Big Marge

Big Marge is a reference package family delivered by the Shirei Workers Registry. It demonstrates how one install can add source files, dependencies, Durable Object bindings, R2 bindings, variables, and Wrangler migrations to a project.

big-marge

Durable Object runtime, BIG_MARGE namespace, R2 bucket, variable, and SQLite migration.

big-marge-client

Browser-safe fetch client for the runtime’s message endpoint.

big-marge-full

Bundle that resolves and installs both runtime and client items.

What gets installed

Registry item	Kind	Generated file	Configuration
big-marge	runtime	src/big-marge.ts	DO, R2, variable, migration
big-marge-client	client	src/lib/big-marge-client.ts	Client dependency
big-marge-full	bundle	Both files	Both dependency trees

Install

workers-registry get big-marge-full
workers-registry add big-marge-full

Pin a registry version for reproducible installs:

workers-registry add big-marge-full@0.1.0

The CLI reads workers-registry.jsonc from the current directory or a parent and maps each item kind to a target project.

Package status

Big Marge is currently a registry-delivered source package, not a public npm package. The planned standalone client package is tracked separately from this reference item.

Why it exists

Big Marge is intentionally small. Its purpose is to make the registry’s complete read/install path visible:

1. Discover an item from /registry.json.
2. Resolve its immutable versioned manifest.
3. Select a target project from item kind.
4. Write source files.
5. Merge Wrangler resources and migrations.
6. install package dependencies.

Continue with the runtime guide and client guide.