Skip to content

docs(bare): fix stale WebAssembly, Bluetooth and React Native details - #436

Merged
lucas-tortora merged 1 commit into
publishedfrom
docs/wasm-bluetooth-stale-fixes
Oct 28, 2026
Merged

lucas-tortora merged 1 commit into
publishedfrom
docs/wasm-bluetooth-stale-fixes

Conversation

@lucas-tortora

@lucas-tortora lucas-tortora commented Oct 28, 2026 •

Copy link
Copy Markdown

Fixes stale or imprecise spots found while fact-checking the WebAssembly and Bluetooth blog drafts against upstream and the docs merged in #424, #425 and #430.

Changes

Page Fix Source
bare-wasm reference Regenerated against 0.1.1 (--only bare-wasm --write; only the intro and upstreamVersion change). 0.1.1 loads without the WebAssembly global. On use, its exports throw or reject with WEBASSEMBLY_UNAVAILABLE. The intro says Bare 1.36.0 still bundles 0.1.0. holepunchto/bare-wasm#4, lib/unavailable.js at v0.1.1; Bare v1.36.0 package-lock.json L1218
WebAssembly addons explanation The bare-wasm README now names iOS, where V8 runs without a JIT, as a place the global is unavailable. bare-wasm v0.1.1 README
Native-addon CI prebuilds cmake-bare minimum is 1.10.1. 1.10.0 linked with --allow-undefined-file=${bare_headers}/bare/wasm.syms, and no bare-headers release ships that file. holepunchto/cmake-bare#33; npm pack bare-headers@1.35.0; bare-sqlite 0.1.5 requires ^1.10.1
Release overview Adds bare-wasm v0.1.1 (2026-10-27) and bare-make v2.1.1 (2026-10-28). GitHub releases and compare views
bare-make reference Documents the 2.1.1 AddressSanitizer runtime preload in Environment and in test.env(). The page is hand-curated beyond the generator, so it is edited by hand rather than regenerated. holepunchto/bare-make#25
Bluetooth best practices The setup guide no longer shows native host code (removed in #430). Only bare-bluetooth and ble-swarm carry an experimental banner, not bare-mobile-doctor. #430; upstream READMEs
Embed Bare in React Native react-native-bare-kit 0.16.0 no longer links native addons, so this links to the existing "Linking native addons" section of the Bare Kit reference. holepunchto/react-native-bare-kit#65

versions.json bumps bare-wasm to 0.1.1 only. bare-make is left at 2.0.1, as it was, because this PR doesn't regenerate that page. Note for later: a regenerated bare-make preview drops the hand-written Usage subsections (Environment, Toolchain, Compiler and linker flags), so a --write regen of bare-make would remove them.

Checks run locally

check-internal-links, check-includes, check-doctypes, check-code-imports, check-agent-ready-metadata, check-docs-versions, bare-refgen/check.ts (75 modules OK), vale --minAlertLevel=error on the changed pages (0 errors), and an MDX compile of every changed page. next build was not run locally.

🤖 Generated with Claude Code

- bare-wasm: regenerate the reference against 0.1.1, which loads without
  the WebAssembly global and throws WEBASSEMBLY_UNAVAILABLE on use. Say that
  Bare 1.36.0 still bundles 0.1.0.
- WebAssembly addons explanation: the bare-wasm 0.1.1 README names iOS
  without a JIT as a place the WebAssembly global is unavailable.
- Native-addon CI prebuilds: cmake-bare 1.10.1 is the minimum. 1.10.0 links
  with --allow-undefined-file pointing at a bare/wasm.syms that no
  bare-headers release ships.
- Release overview: add bare-wasm 0.1.1 (2026-10-27) and bare-make 2.1.1
  (2026-10-28).
- bare-make: document the AddressSanitizer runtime preload added in 2.1.1.
- Bluetooth best practices: the setup guide no longer shows native host
  code (#430), and only bare-bluetooth and ble-swarm carry an experimental
  banner.
- Embed Bare in React Native: react-native-bare-kit 0.16.0 stopped linking
  native addons, so point to the bare-link instructions.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
@kinsta

kinsta Bot commented Oct 28, 2026

Copy link
Copy Markdown

Preview deployments for pear-docs preview ⚡️

Status Branch preview Commit preview
❌ Failed to deploy N/A N/A

Commit: 5e6dd34175aebd1562ef375df5f685dd219062d4

Deployment ID: afa672d8-7ebb-48a6-8907-eb2c066cb2e9

Static site name: pear-docs-preview-iimt7

@kinsta

kinsta Bot commented Oct 28, 2026

Copy link
Copy Markdown

Preview deployments for pear-docs published ⚡️

Status Branch preview Commit preview
✅ Ready Visit preview Visit preview

Commit: 5e6dd34175aebd1562ef375df5f685dd219062d4

Deployment ID: cbe06c4f-c780-4222-bd28-3075edbe1844

Static site name: pear-docs-published-i1yp5

@lucas-tortora
lucas-tortora merged commit f0a0591 into published Oct 28, 2026
11 checks passed
@lucas-tortora
lucas-tortora deleted the docs/wasm-bluetooth-stale-fixes branch October 28, 2026 15:49

This branch was successfully deployed

1 active deployment
preview — 5e6dd341 Deployed Oct 28, 2026 by kinsta[bot]
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