hashgraph-online/awesome-codex-plugins / plugins/alpoxdev/hypercore/skills/hyper-architecture
hyper-architecture
Verified[Hyper] Use this skill when the user asks for architecture, project setup, or performance work - building, auditing, restructuring, or reviewing project structure, routes, data or server boundaries, the lint/format/type tooling baseline (oxlint, Prettier, tsconfig, rustfmt, clippy), or build and runtime performance - in a Next.js App Router, TanStack Start, Vite with TanStack Router, Astro, Expo, Lynx (ReactLynx), Hono, Axum, Tauri v2, Electron, or Rust CLI, WASM, or MCP server project. It detects the stack from manifests and config files, routes each touched package of a monorepo separately, and applies the matching bundled stack guide, the shared setup baseline, and that stack's performance rules. Do not use it for stacks outside those eleven or for work that crosses no architecture, setup, or performance boundary, such as copy edits, a plain dependency bump, or one build failure.
references/official/lynx/lynx-2026-11-07.md
View on GitHub# Lynx Official Evidence Snapshot
Read when an installed version, a config key, a template file, or an engine compatibility rule decides the change. This snapshot records the official claims this package relies on and the date each was verified.
- last_verified_at: 2026-11-07
- `status`: reviewed from the Lynx documentation site, the `@lynx-js/create-lynx@0.2.1` template tarball, the engine release feed, and npm registry metadata
- `baseline`: engine 4.2.0 (released 2026-10-27, PrimJS 4.2.1); `@lynx-js/react` 0.129.2; `@lynx-js/rspeedy` 0.18.5; `@lynx-js/types` 4.4.2; `@lynx-js/react-rsbuild-plugin` 0.22.2
- `refresh_when`: the installed engine, `@lynx-js/react`, or `@lynx-js/rspeedy` differs materially, or compatibility, threading, or bundle guidance changes
- `authority`: evidence only; user and project instructions and the installed project's own behavior remain authoritative
## Contents
- Versions and release model
- Packages
- Scaffolder
- Tooling reality
- Node and platform floors
- Rspeedy config keys
- `pluginReactLynx` options
- Verbatim template configs
- Compatibility rules
- Unverified items
- Sources
## Versions and release model
| Item | Value | Note |
|---|---|---|
| Documented stable engine | 4.2 | Site header reads "Lynx 4.2" |
| 4.2.0 release date | 2026-10-27 | Pins PrimJS 4.2.1 on Android, iOS, and HarmonyOS |
| Previous engine lines | 4.1, 4.0, 3.9, 3.8.1, 3.7.0, 3.6.0, 3.5.2, 3.4.2, 3.3.2, 3.2.0 | `versions.md` |
| Cadence | Monthly from 3.8 onward | Announced in the 3.8 blog and the 2026 roadmap |
| Cadence reliability | Plan has slipped once | 4.2 was planned for 2026/09, shipped 2026-10-27 |
The published roadmap maps 3.8 through 4.5 onto 2026/05 through 2026/12. Treat it as intent: 3.9.0 landed 2026-06-26 against a 2026/06 plan and 4.2.0 landed 2026-10-27 against a 2026/09 plan.
## Packages
`latest` dist-tag on 2026-11-07:
| Package | Latest | Note |
|---|---|---|
| `@lynx-js/react` | 0.129.2 | Runtime; last publish 2026-11-06; 70 versions since 2025-03-02 |
| `@lynx-js/rspeedy` | 0.18.5 | Build; `engines.node: "^20.19.0 \|\| >=22.12.0"` |
| `create-rspeedy` | 0.18.5 | Deprecated shim; depends on `@lynx-js/create-lynx` |
| `@lynx-js/create-lynx` | 0.2.1 | Current scaffolder |
| `@lynx-js/react-rsbuild-plugin` | 0.22.2 | `engines >=18`; peers `@lynx-js/react ^0.128.0 \|\| ^0.129.0`, `@lynx-js/rspeedy ^0.17.0 \|\| ^0.18.0` |
| `@lynx-js/qrcode-rsbuild-plugin` | 0.7.3 | `engines ^20.19.0 \|\| >=22.12.0` |
| `@lynx-js/types` | 4.4.2 | Tracks the engine major line |
| `@lynx-js/web-core` | 0.26.7 | Lynx for Web; no production-readiness statement found |
| `@lynx-js/testing-environment` | 0.4.0 | Emulates the dual thread for the testing library |
| `@lynx-js/lynx-ui` | 3.141.0 | Headless UI library; no compatibility statement found |
No published matrix ties a `@lynx-js/react` minor to an engine minor. The observed pairing of `@lynx-js/react` 0.129.x with engine 4.2 is an observation, not a contract; read the installed versions.
## Scaffolder
`@lynx-js/create-lynx` supersedes `create-rspeedy`. The changelog for 0.2.0 states that it "supersedes `create-rspeedy`, which now carries a deprecation notice and no longer receives updates."
```bash
# current command
npm create @lynx-js/lynx@latest
# legacy alias still printed in the quick-start page; works today
npm create rspeedy@latest
```
New projects use the first. An existing repository already scaffolded with the second does not need a migration for its own sake.
## Tooling reality
- No official Lynx ESLint plugin exists. `@lynx-js/eslint-plugin-react-lynx` and `@lynx-js/eslint-config` both return 404 on npm as of 2026-11-07.
- The `rslint` template variant ships `@rslint/core` `^0.9.0` with a `rslint.config.ts` that combines `js.configs.recommended`, `ts.configs.recommended`, and `reactHooksPlugin.configs.recommended`, run through `rslint`. The latest `@rslint/core` observed was 0.10.0, so read the installed version rather than hardcoding it.
- The ReactLynx template itself ships no linter and no Prettier config. Prettier appears nowhere in the documentation bundle.
- Oxlint has no Lynx plugin. Its `react/no-unknown-property` rule is DOM-oriented and needs `ignore` entries for Lynx attributes such as `bindtap`, `catchtap`, `main-thread:bindtap`, `item-key`, `list-type`, `span-count`, `scroll-orientation`, and `auto-size`. Config discovery uses `.oxlintrc.json` or `oxlint.config.ts`.
- Any Lynx oxlint configuration is a project choice, not an official Lynx setup.
## Node and platform floors
- Node.js: `^20.19.0 || >=22.12.0`, declared by `@lynx-js/rspeedy` and every scaffolded `package.json`. The quick-start page states "Node.js 20.19 or later. Node.js 22.12 or later is also supported."
- Rspeedy CLI documents Node's native TypeScript stripping at `>=23.6`, `>=22.6` with `--experimental-strip-types`, and `>=22.7` with `--experimental-transform-types`. That is a CLI convenience, not the supported floor.
- Target platforms: iOS 10 and Android 5.0 (API 21) or newer.
- Development OS: macOS recommended; Windows and Linux are "not yet verified or guaranteed" by the engine project.
- Supported runtime platforms today: Android, iOS, Web, OpenHarmony. Desktop through the Clay renderer exists for macOS and Windows; Lynxtron is "Coming soon".
- License: Apache-2.0 for the engine and the frontend stack.
## Rspeedy config keys
Top-level keys verified from the docs and the template:
```text
source.entry string | string[] | Record<string, string | string[] | EntryDescription>
source.tsconfigPath
source.alias
plugins array
tools.rspack.plugins
environments defaults to { lynx: {} }
output.distPath
output.filename.bundle
output.cssModules.auto
output.sourceMap
output.legalComments
splitChunks default false; replaces the obsolete performance.chunkSplit
dev.hmr
dev.liveReload
dev.writeToDisk
dev.assetPrefix
dev.progressBar
dev.watchFiles
resolve.dedupe
```
CLI: `rspeedy dev | build | preview | inspect`. The global binary prefers `./node_modules/.bin/rspeedy`; `--unmanaged` forces the global one. `-c/--config` selects an alternate config; `--env-mode` selects a `.env.[mode]` file.
`rspeedy inspect` prints the resolved Rsbuild and Rspack configs and is the sanctioned way to verify a config claim.
## `pluginReactLynx` options
Twenty-three documented options:
```text
compat
customCSSInheritanceList
debugInfoOutside
defaultDisplayLinear
defineDCE
enableAccessibilityElement
enableCSSInheritance default false
enableCSSInvalidation
enableCSSSelector
enableNewGesture
enableRemoveCSSScope
enableSSR default false
enableUISourceMap
engineVersion default '3.2'
experimental_isLazyBundle
experimental_useElementTemplate
extractStr default false
firstScreenSyncTiming default 'immediately'
globalPropsMode
optimizeBundleSize default false; mainThread/background sub-flags
removeDescendantSelectorScope
shake
targetSdkVersion legacy alias of engineVersion
```
## Verbatim template configs
`lynx.config.ts` from the official ReactLynx TypeScript template, plus the size and verification switches this package recommends:
```ts
import { pluginQRCode } from '@lynx-js/qrcode-rsbuild-plugin';
import { pluginReactLynx } from '@lynx-js/react-rsbuild-plugin';
import { defineConfig } from '@lynx-js/rspeedy';
import { pluginTypeCheck } from '@rsbuild/plugin-type-check';
export default defineConfig({
source: {
entry: './src/index.tsx',
},
plugins: [
pluginQRCode({
schema(url) {
// `?fullscreen=true` opens the page full screen in Lynx Explorer.
return `${url}?fullscreen=true`;
},
}),
pluginReactLynx({
engineVersion: '3.9', // raise only to the lowest host engine you actually ship on
optimizeBundleSize: { mainThread: true, background: true },
extractStr: true,
}),
pluginTypeCheck(),
],
// Web target is opt-in; without this Rspeedy builds `{ lynx: {} }`.
// environments: { lynx: {}, web: {} },
});
```
`tsconfig.json`, exactly as the template ships it:
```json
{
"compilerOptions": {
"strict": true,
"isolatedModules": true,
"verbatimModuleSyntax": true,
"esModuleInterop": true,
"skipLibCheck": true
},
"references": [{ "path": "./tsconfig.node.json" }, { "path": "./src" }],
"files": []
}
```
`tsconfig.node.json`:
```json
{
"extends": "./tsconfig.json",
"compilerOptions": {
"composite": true,
"module": "node16",
"moduleResolution": "node16",
"erasableSyntaxOnly": true,
"lib": ["es2023"],
"target": "es2022",
"noEmit": true
},
"include": ["./lynx.config.ts", "./rstest.config.ts"]
}
```
`src/tsconfig.json`:
```json
{
"extends": "../tsconfig.json",
"compilerOptions": {
"composite": true,
"jsx": "react-jsx",
"jsxImportSource": "@lynx-js/react",
"types": ["@lynx-js/rspeedy/client"],
"module": "ESNext",
"moduleResolution": "Bundler",
"noEmit": true
},
"include": ["./**/*.ts", "./**/*.tsx"]
}
```
`rstest.config.ts`:
```ts
import { withLynxConfig } from '@lynx-js/react/testing-library/rstest-config';
import { defineConfig } from '@rstest/core';
export default defineConfig({
extends: withLynxConfig(),
});
```
`package.json` scripts: `build: rspeedy build`, `dev: rspeedy dev`, `preview: rspeedy preview`, `test: rstest run`, with `engines.node: "^20.19.0 || >=22.12.0"`.
`src/index.tsx`, the entry:
```tsx
import '@lynx-js/preact-devtools';
import '@lynx-js/react/debug';
import { root } from '@lynx-js/react';
import { App } from './App.js';
root.render(<App />);
if (import.meta.webpackHot) {
import.meta.webpackHot.accept();
}
```
## Compatibility rules
| Rule | Detail |
|---|---|
| `engineVersion` semantics | A bundle declaring N runs on an engine of N or newer; on an older engine it fails fatally with error 10204 |
| `engineVersion` default | `'3.2'` — a floor, not a target |
| `targetSdkVersion` | Legacy alias of `engineVersion`; do not introduce it in new config |
| Lazy bundle floor | A Consumer earlier than 0.115.0 cannot load a lazy bundle built with 0.115.0 or later |
| `FetchBundle` loader | Requires `engineVersion` 3.9 or later |
| `!important` in CSS | Requires `engineVersion` 3.9 or later |
| `flex` shorthand | From 3.9, an omitted `flex-basis` parses as `0%` instead of `0` |
| `position: sticky`, `grid-row`/`grid-column` shorthands, HarmonyOS motion path | Added in 3.9 |
| Trace | Supported from engine 3.4 on Android, iOS, and HarmonyOS |
| WebAssembly | From 3.8, Android only, background thread only |
| Main-thread syntax ceiling | ES2019 |
| Background-thread syntax ceiling | ES2015 |
| Polyfills | Injected on iOS only |
| `useLayoutEffect` | Alias of `useEffect` per the API index; called unsupported by the lifecycle page |
| React API level | ReactLynx exposes the React v17 API surface; `@lynx-js/react/compat` adds React 18 APIs such as `startTransition` |
## Unverified items
These were not confirmed by a documentation page or changelog entry at the time of writing. State them as unverified or omit them; never assert them as rules.
- The exact `@lynx-js/react` minor to engine minor mapping. No matrix exists.
- Whether React hooks other than `useMainThreadRef` may be called inside a `'main thread'` function.
- Whether `'background only'` (space) and `background-only` (hyphen) compile identically. Both spellings appear across docs.
- `Suspense` and transition semantics: whether they follow React 17 or React 18 behavior.
- `@lynx-js/lynx-ui` compatibility with a given engine or ReactLynx version.
- Lynx for Web production readiness; `@lynx-js/web-core` is at 0.26.7 against an engine of 4.2 with no readiness statement.
- Node 24 and npm 11 specifically; only `^20.19.0 || >=22.12.0` is asserted.
- The Oxlint `react/no-unknown-property` ignore list for Lynx attributes; the attribute names are documented but the rule configuration is this package's own.
- Desktop host architecture for macOS and Windows; Lynxtron is "Coming soon".
## Sources
> Checked 2026-11-07. Every page and registry record below was read on 2026-11-07 for this snapshot.
- <https://lynxjs.org/>
- <https://lynxjs.org/llms.txt>
- <https://lynxjs.org/llms-full.txt>
- <https://lynxjs.org/versions.md>
- <https://lynxjs.org/guide/start/quick-start.md>
- <https://lynxjs.org/guide/compatibility.md>
- <https://lynxjs.org/guide/scripting-runtime/index.md>
- <https://lynxjs.org/guide/scripting-runtime/main-thread-runtime.md>
- <https://lynxjs.org/guide/start/integrate-with-existing-apps.md>
- <https://lynxjs.org/guide/use-native-modules.md>
- <https://lynxjs.org/guide/use-data-from-host-platform.md>
- <https://lynxjs.org/guide/devtool/trace.md>
- <https://lynxjs.org/guide/performance/analysis-performance/analysis-bundle-size.md>
- <https://lynxjs.org/react/thinking-in-reactlynx.md>
- <https://lynxjs.org/react/main-thread-script.md>
- <https://lynxjs.org/react/lifecycle.md>
- <https://lynxjs.org/react/code-splitting.md>
- <https://lynxjs.org/react/reactlynx-testing-library.md>
- <https://lynxjs.org/rspeedy/typescript.md>
- <https://lynxjs.org/rspeedy/output.md>
- <https://lynxjs.org/rspeedy/cli.md>
- <https://lynxjs.org/blog/lynx-3-8.md>
- <https://lynxjs.org/blog/lynx-3-9.md>
- <https://lynxjs.org/blog/lynx-open-source-roadmap-2026.md>
- <https://github.com/lynx-family/lynx/releases.atom>
- <https://github.com/lynx-family/lynx/develop/README.md>
- <https://registry.npmjs.org/@lynx-js%2Freact>
- <https://registry.npmjs.org/@lynx-js%2Frspeedy>
- <https://registry.npmjs.org/@lynx-js%2Freact-rsbuild-plugin>
- <https://registry.npmjs.org/@lynx-js%2Fqrcode-rsbuild-plugin>
- <https://registry.npmjs.org/@lynx-js%2Ftypes>
- <https://registry.npmjs.org/@lynx-js%2Fweb-core>
- <https://registry.npmjs.org/@lynx-js%2Ftesting-environment>
- <https://registry.npmjs.org/@lynx-js%2Fcreate-lynx>
- <https://registry.npmjs.org/create-rspeedy>
- <https://registry.npmjs.org/@lynx-js%2Fcreate-lynx/-/create-lynx-0.2.1.tgz>
- <https://registry.npmjs.org/@rslint%2Fcore>
- <https://registry.npmjs.org/@rstest%2Fcore>
- <https://oxc.rs/docs/guide/usage/linter/rules/react/no-unknown-property.html>
- <https://oxc.rs/docs/guide/usage/linter/config.html>
Related skills
| Skill | Stars | Updated | Works with | Status | Install |
|---|---|---|---|---|---|
| rea-analysis-optimizationmorluto/reaOptimize REA providers and shared analysis workflows for agent context, latency, CPU, and memory while preserving correctness and Evidence. Use for analysis bottlenecks and cache or query design; CI/test-suite optimization belongs to rea-ci-tests-audit. | Stars: 472k | Updated | Claude CodeCodex | Verified | Install |
| rea-ci-tests-auditmorluto/reaAudit REA CI and test suites for correctness, fixture drift, false passes, and measured performance; use for suite or workflow investigations and efficiency changes, rather than ordinary feature testing or a single test failure. | Stars: 472k | Updated | Claude CodeCodex | Verified | Install |
| rea-tool-designmorluto/reaAudit, investigate, design, or change REA investigation tools, CLI/MCP contracts, provider capabilities, and Evidence semantics. | Stars: 472k | Updated | Claude CodeCodex | Verified | Install |
| ponytail-auditDietrichGebert/ponytailQuality audit of the whole repo: bugs, security, real load, missing tests, speed, and what to delete. Most important first. | Stars: 194k | Updated | Claude CodeCodex | Verified | Install |