Skip to content

feat(docs): build and save a virtual filesystem in the browser - #338

Merged
lloydrichards merged 28 commits into
mainfrom
fix-demo-workspace-dependencies
Nov 16, 2026
Merged

lloydrichards merged 28 commits into
mainfrom
fix-demo-workspace-dependencies

Conversation

@lloydrichards

@lloydrichards lloydrichards commented Nov 16, 2026 •

Copy link
Copy Markdown
Owner

Goal/Scope

Let readers edit, build, and save a virtual filesystem directly in the static docs. Keep the native Node workbench available as a local example.

Description

The playground bundles JavaScript modules from an in-memory Effect VFS using the browser build of esbuild. Readers can browse the file tree, edit modules, and build with either an Editor or Reader caller. Both use the same volume. The Reader can build but lacks write access to the example files. Saving captures the volume as a snapshot, writes it to a SQLite BLOB, and stores the database bytes in IndexedDB. Readers can query the saved row and reopen the checkpoint after a reload. The page diagrams the two callers and the path from memory through SQLite to IndexedDB. Both WebAssembly engines load from the docs site on demand.

The local Node workbench resolves its Node declarations without NODE_PATH. The dependency fixes also let Alchemy, virtual-build, and the documentation build resolve their test and build tools under Bun’s isolated layout.

Comment

The playground keeps one saved checkpoint per site and browser profile. Reloading starts a fresh working copy. Reopen saved restores the last explicit save.

@vercel

vercel Bot commented Nov 16, 2026 •

Copy link
Copy Markdown

The latest updates on your projects. Learn more about Vercel for GitHub.

Project Deployment Actions Updated
effect-vfs-docs Ready Ready Preview Nov 16, 2026 8:44pm UTC

@changeset-bot

changeset-bot Bot commented Nov 16, 2026 •

Copy link
Copy Markdown

⚠️ No Changeset found

Latest commit: b016ecb

Merging this PR will not cause a version bump for any packages. If these changes should not result in a new version, you're good to go. If these changes should result in a version bump, you need to add a changeset.

This PR includes no changesets

When changesets are added to this PR, you'll see the packages that this PR includes changesets for and the associated semver types

Click here to learn what changesets are, and how to add one.

Click here if you're a maintainer who wants to add a changeset to this PR

@pullfrog pullfrog Bot left a comment

Copy link
Copy Markdown

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

✅ No new issues found.

Reviewed changes for Bun's isolated workspace dependency resolution across demo tests, the TypeScript workbench, and repository builds.

  • Workbench types: Resolve undici-types relative to the installed @types/node package.
  • Demo tests: Import Alchemy's crypto layer through its declared dependency and share the root @effect/vitest installation with virtual-build.
  • Build dependencies: Declare virtual-build's Node types, the docs' shared TypeScript configuration, and the root tsx executable, with corresponding lockfile updates.

Validation passed: bun install --frozen-lockfile, bun run build (including documentation example checks), bun run test -- --project virtual-build --project demo-alchemy (19 tests), and the workbench's native test suite under Node 26.11.1 (7 tests).

Pullfrog  | View workflow run | Using gpt-6.1-sol | 𝕏

@lloydrichards lloydrichards changed the title fix(demos): resolve workspace dependencies for tests and builds fix(demos): resolve workspace dependencies and document the Node and Vite examples Nov 16, 2026
@lloydrichards lloydrichards changed the title fix(demos): resolve workspace dependencies and document the Node and Vite examples feat(docs): build and save a virtual filesystem in the browser Nov 16, 2026
@vercel

vercel Bot commented Nov 16, 2026

Copy link
Copy Markdown

Deployment failed for project effect-vfs-docs with the following error:

Resource is limited - try again in 24 hours (more than 100, code: "api-deployments-free-per-day").

Learn More: https://vercel.com/lloydrichards-projects?upgradeToPro=build-rate-limit

@lloydrichards
lloydrichards merged commit 28120f8 into main Nov 16, 2026
10 of 11 checks passed
@lloydrichards
lloydrichards deleted the fix-demo-workspace-dependencies branch November 16, 2026 20:51
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant