Automattic / Automattic/kandelo

[Investigation] `Document-Isolation-Policy` as a primary embedding lane

Open
#366 0 comments 0 reactions 0 assignees View on GitHub
Dominant language
TypeScript
Stars
31
Forks
15
Avg merge
11h 7m
Merged PRs (30d)
80

Description

Today, embedding Kandelo on a third-party page requires the embedder to opt into COOP/COEP, which is a major adoption blocker. The `Document-Isolation-Policy` (DIP) header lets an iframe declare its own isolation and obtain `SharedArrayBuffer` without parent COEP cooperation. It shipped stable in Chrome 137 in May 2025, so on Chrome desktop this is a real, working path today, not a future spec.

#### Why this matters

- Removes the single biggest reason a host site refuses to embed Kandelo.
- Aligns Kandelo's embed story with what WordPress Playground would need to adopt it.
- Falls back cleanly: DIP iframe → COEP-cooperative iframe → popup launcher.

#### Proposed validation

1. Serve `/embed.html` with `Document-Isolation-Policy : isolate-and-credentialless`, no parent COEP.
2. Confirm crossOriginIsolated === true inside the iframe.
3. Boot the kernel worker + a process worker and run hello.wasm.
4. Verify behavior under Safari and Firefox. Fails.

#### Browser support reality

- Chrome desktop 137+: shipped stable.
- Safari: WebKit [issue #399](https://github.com/WebKit/standards-positions/issues/399)
- Firefox: [issue #1074](https://github.com/mozilla/standards-positions/issues/1074).

#### Suggested follow-up if validation passes

Design a `` web component with an auto-degrade ladder [ DIP → COEP cooperative → popup ], so embedders get the best lane their browser supports without per-site config.

Contributor guide

No contributing guide indexed for this repository

Research direction

Start with /embed.html and the existing kernel worker and process worker boot path. Serve the page with Document-Isolation-Policy and no parent COEP, then check crossOriginIsolated and run hello.wasm. Done means the DIP iframe path is validated on Chrome and its failure behavior is recorded for Safari and Firefox.

Written by the indexing model from the issue text.

Assessment

Tech stack
typescript, wasm
Domain
frontend, web-dev
Issue type
Feature
Difficulty
4/5
Estimated time
3-5 days
Activity status
Quiet
Clarity
Mostly clear
Newbie friendliness
45/100

Get new issues in your inbox

A short digest of beginner-friendly GitHub issues.