Documentation for Redweb 0.13.3. Install that exact version when following these examples.
Choose and verify a Redweb release
Redweb is a Node.js HTTP/WebSocket library with server-rendered TSX, not a hosted service. Evaluate the exact package, runtime, application and deployment you intend to use. A passing test suite, a registry signature and a provenance statement answer different questions; none certifies an application as secure.
Runtime and compiler compatibility
| Area | Contract and verification boundary |
|---|---|
| Core runtime | The package declares Node >=18. This is an installation/compatibility floor, not a recommendation to deploy an end-of-life runtime. |
| Production Node | Use a currently maintained LTS release with current security patches. As checked on 2026-08-30, Node 22 and 24 are LTS; Node 18 and 20 are end-of-life. Recheck the official schedule when deploying. |
| CI coverage | The repository matrix targets Node 18, 20, 22 and 24 on Linux. The 18/20 jobs are legacy-compatibility checks, not security-support claims. A configured job is not a passing result; inspect checks for your exact commit. |
| TypeScript/TSX | The starter uses the package's tested TypeScript dependency and redweb/tsconfig.json. Standard decorators and legacy experimentalDecorators consumers have separate compile tests. Node's native TypeScript execution is not a replacement for compiling TSX/decorators with this configuration. |
| Persistent dashboard | This application recipe requires Node 22.13+ and native node:sqlite; it is not part of the core runtime requirement. Its database and account/session design are single-process. |
| Browser | The real-browser gates exercise Chromium. They are not a Firefox/Safari compatibility certification. Test the browsers you support, including reconnect and forms, before release. |
| Runtime platforms | This branch has local Windows evidence and Linux CI configuration. Neither proves every OS, architecture, proxy, container platform or serverless host works. Live pages require a long-lived Node listener with WebSocket upgrades. Static export is a separate deployment mode. |
Use the official Node release schedule for maintained releases, the TypeScript decorator documentation for the distinction between decorator modes, and Node's TypeScript limitations for native execution constraints. Current per-commit test evidence and uncompleted checks are recorded in the release checklist, not inferred from this table.
Pin the package and the documentation together
For a published application, select an exact release, commit its lockfile, and use npm ci in CI/deployment. This guide is versioned for 0.13.3. Before registry publication, verify the packed candidate; after publication, repeat these registry checks from a clean application:
npm view redweb@0.13.3 version engines dist.integrity dist.signatures dist.attestations gitHead --json
npm install --save-exact redweb@0.13.3
npm audit signatures
npm audit --omit=devThe signature command must run in the installed application directory. Keep TLS verification enabled and use a current npm CLI; a certificate/trust-store failure is not a reason to disable verification. A lockfile's integrity value detects changed package bytes; registry signatures authenticate registry metadata; provenance, when present and verified, links an artifact to a build/source identity. Vulnerability audit is a separate check against known advisories, not an application penetration test.
Redweb 0.13.3 contains the server-rendered TSX, reactive state/actions, complete starters, shared socket contracts, authorization, diagnostics, lifecycle work, and bounded heartbeat grace described by these versioned guides. Keep the package and documentation version aligned; do not mix a development guide or a future checkout with 0.13.3 and assume newer APIs exist.
Redweb is pre-1.0. Consult the changelog and versioned guide before upgrading, run your own real HTTP/WebSocket/browser tests, and keep a rollback artifact. Patch/minor numbers and a compatible TypeScript build alone do not prove wire compatibility, preserved sessions, database compatibility or application authorization. HTTP-created live-page sessions are process-owned; a restart or rolling replacement does not migrate them automatically. Raw socket protocol versions are negotiated only when the route opts in, and application payload compatibility remains your contract.
Historical registry verification
Read-only registry inspection after publication on 2026-09-01 UTC reported latest: 0.13.0, with:
gitHead:7196d504ee65dfaf5ac869ea4bda66d7cf86d015, the verified merge commit onmain.- SHA-512 integrity:
sha512-n5OQl214vC6ithpfg6QyhAmaOtjY8AYEGrWZGl8LxdSCyagD1K2bvplcxhQOruZP3exwkIyRPnhIuFe9rIcQFQ==. - SHA-1 registry checksum:
1ff22dbd2a5c3d8eafad219055f01fe5b85b9d10. - Registry signature present; no
dist.attestationsfield was returned. Build provenance is therefore not claimed for this release.
An independently created temporary application installed that exact package with lifecycle scripts disabled and ran npm audit signatures --json using Node 22.21.0/npm 11.6.2 and the Windows system trust store. It exited successfully with invalid: [] and missing: []; npm audit --omit=dev --json reported zero vulnerabilities. All 215 published files matched content at the recorded gitHead: two byte-for-byte and 213 after normalizing Windows CRLF materialization to Git's LF blobs. The retained release audit receipt at docs/releases/audit-0.13.0.json records the archive hashes and every published/Git file hash. These checks authenticate and compare the observed artifact; they do not certify the application, prove every dependency has build provenance, or verify a future release.
The immutable 0.13.0 tarball has a known documentation-only release-process defect. Its bundled docs/generated.json says channel: "unreleased"; its changelog says 0.13.0 was not yet published; and its README uses development-tarball setup, calls that setup prerelease/development-only, and later says Redweb remains unreleased. Runtime files and public declarations match the verified merge commit. The repository and website sources correct those labels. The repository's docs/releases/0.13.0.json is therefore a corrected post-publication documentation snapshot for 0.13.0, not the catalogue that shipped inside the immutable 0.13.0 tarball. A future patch release is required to deliver the corrected bundled documentation to npm consumers.
Registry inspection after the later 0.13.1 publication reported gitHead db64d5b655d5668a75b587122c9e1e9ef4c9bca1, SHA-512 integrity sha512-DCLcmiDj89kXf3+80H5/1W+nQEXIhF8RfiBlU6b/LA7418/ChkzhZ8oV4JmVLDL/nt7zFNcytyjavzrDT/XfoA==, SHA-1 checksum c05f3e0dc560d4bb379b8fbd6747c3470fcc31f0, a registry signature, and no provenance attestation. Its runtime contains the heartbeat correction, but its 217-file immutable archive again labels docs/generated.json and the README as unreleased and contains no docs/releases/0.13.1.json. Its package version was materialized in the publication workspace rather than committed at the recorded gitHead, so 0.13.1 is not presented as a clean source-identical release.
The 0.13.2 release candidate corrects that process: version metadata and lockfile, an empty Unreleased section, registry-pinned README setup, and docs/releases/0.13.2.json must exist in the reviewed commit before manual publication. Publish only that clean merged commit, then verify the registry metadata and installed archive before synchronizing the website.
The commands above let you repeat the check. See npm's signature and attestation verification and viewing provenance documentation for current verification behavior.
Publishing provenance is a maintainer action
The 0.13.0 and 0.13.1 registry metadata contain signatures but no provenance attestations. To add provenance to a future release, the maintainer must choose an authorized supported build/publish workflow, configure the correct repository identity and npm permissions, publish the exact tested artifact, and verify the resulting registry attestation afterward. A local npm pack, gitHead, checksum, badge or successful CI run is not a substitute for a verified attestation. Do not label older releases retroactively as provenance-verified.
npm describes the supported providers and identity requirements in generating provenance and trusted publishing. Provenance provides origin/build evidence, not proof that source code is safe.
Support and reporting boundaries
For ordinary bugs, provide a minimal reproducible project, exact Redweb/Node/npm/TypeScript versions, operating system, decorator mode, sanitized logs, and the failing HTTP/WebSocket sequence in the issue tracker. Never include tokens, cookies, passwords, private database contents or customer traffic.
There is no paid support contract, response-time SLA or long-term backport policy established by these files. No private vulnerability contact is invented here. The repository inspection on 2026-08-30 reported no published security policy; the maintainer still needs to establish a private reporting channel and its handling policy before the project claims one. Do not disclose a suspected vulnerability or working exploit in a public bug report merely because that is the only linked tracker.