[Playground] Can't create fresh playground on ⚡StackBlitz

[loganmzz]

Have you read the Contributing Guidelines on issues?

• I have read the Contributing Guidelines on issues.

Description

Can't start a playground on ⚡StackBlitz (using JS or TS):

~/projects/zzmiqvyljz.github
❯ yarn install && npm start
yarn install v1.22.19
[1/5] 🔍  Validating package.json...
[2/5] 🔍  Resolving packages...
[3/5] 🚚  Fetching packages...
[4/5] 🔗  Linking dependencies...
warning "@docusaurus/core > react-loadable-ssr-addon-v5-slorber@1.0.3" has unmet peer dependency "react-loadable@*".
warning " > @mdx-js/react@3.1.1" has unmet peer dependency "@types/react@>=16".
warning "@docusaurus/preset-classic > @docusaurus/theme-search-algolia > @algolia/autocomplete-core > @algolia/autocomplete-plugin-algolia-insights@1.19.8" has unmet peer dependency "search-insights@>= 1 < 3".
warning "@docusaurus/preset-classic > @docusaurus/theme-search-algolia > @algolia/autocomplete-core > @algolia/autocomplete-shared@1.19.8" has unmet peer dependency "@algolia/client-search@>= 4.9.1 < 6".
warning "@docusaurus/preset-classic > @docusaurus/theme-search-algolia > @docsearch/react > @algolia/autocomplete-core > @algolia/autocomplete-plugin-algolia-insights@1.19.2" has unmet peer dependency "search-insights@>= 1 < 3".
warning "@docusaurus/preset-classic > @docusaurus/theme-search-algolia > @docsearch/react > @algolia/autocomplete-core > @algolia/autocomplete-shared@1.19.2" has unmet peer dependency "@algolia/client-search@>= 4.9.1 < 6".
[5/5] 🔨  Building fresh packages...
✨  Done in 8.19s.

> docusaurus@0.0.0 start
> docusaurus start

[INFO] Starting the development server...
[rspack] Downloading @rspack/binding-wasm32-wasi@1.7.11 on WebContainer...
Packages: +7
+++++++
Progress: resolved 7, reused 0, downloaded 7, added 7, done

dependencies:
+ @rspack/binding-wasm32-wasi 1.7.11 (2.0.2 is available)

Done in 6.4s

[ERROR] Error: To enable Docusaurus Faster options, your site must add the @docusaurus/faster package as a dependency.
    at ensureFaster (/home/projects/zzmiqvyljz.github/node_modules/@docusaurus/bundler/lib/importFaster.js:26:15)
    at async importRspack (/home/projects/zzmiqvyljz.github/node_modules/@docusaurus/bundler/lib/importFaster.js:30:20)
    at async getCurrentBundler (/home/projects/zzmiqvyljz.github/node_modules/@docusaurus/bundler/lib/currentBundler.js:28:24)
    at async loadContext (/home/projects/zzmiqvyljz.github/node_modules/@docusaurus/core/lib/server/site.js:54:28)
    at async loadSite (/home/projects/zzmiqvyljz.github/node_modules/@docusaurus/core/lib/server/site.js:162:21)
    at async createReloadableSite (/home/projects/zzmiqvyljz.github/node_modules/@docusaurus/core/lib/commands/start/utils.js:62:16)
    at async doStart (/home/projects/zzmiqvyljz.github/node_modules/@docusaurus/core/lib/commands/start/start.js:22:28) {
  [cause]: Error: Failed to load native binding
      at Object.eval (/home/projects/zzmiqvyljz.github/node_modules/@swc/html/binding.js:350:15)
      at Module._compile (node:internal/modules/cjs/loader:148:16006)
      at Module._extensions..js (node:internal/modules/cjs/loader:148:16726)
      at Module.load (node:internal/modules/cjs/loader:148:15281)
      at Module._load (node:internal/modules/cjs/loader:148:12773)
      at Module.require (node:internal/modules/cjs/loader:148:15469)
      at require3 (node:internal/modules/helpers:166:2696)
      at Object.eval (/home/projects/zzmiqvyljz.github/node_modules/@swc/html/index.js:30:30)
}
[INFO] Docusaurus version: 3.10.1
Node version: v20.19.1

Note: 📦 CodeSandbox ones are working fine!

Self-service

• I'd be willing to address this documentation request myself.

[riddhij-7]

Hey, I tried reproducing this and dug into the template files.

@docusaurus/faster is already in package.json at 3.10.1, so the error message is misleading.
The actual issue is @swc/html failing to load its native binding inside StackBlitz's WebContainer, which makes sense since WebContainer is browser-based and can't run native Node.js bindings.

Looking at the template's docusaurus.config.js, only future.v4: true is set (no explicit experimental_faster),
but it seems like v4: true in 3.10.1 implicitly activates the Rspack/SWC pipeline which triggers this.

Possible fixes:

• Set experimental_faster: false explicitly in the StackBlitz template config
• Remove v4: true from the playground template since it's just a reproducer environment
• Check if a .stackblitzrc can disable the faster bundler

Happy to send a PR once maintainers confirm the right direction!

[slorber]

This is a problem I'm aware of, and reported to the SWC team: swc-project/swc#11833

I'll see if they plan to fix it in the near future or not before implementing a workaround on our side.

[riddhij-7]

Thanks for confirming! Happy to help implement the workaround on the Docusaurus side whenever you're ready to move forward.