Skip to content

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.

FileKindSize
SKILL.ko.mdmarkdown19.9 KB
SKILL.mdskill md18.4 KB
assets/evals/astro-cases.jsonlother17.1 KB
assets/evals/axum-cases.jsonlother13.7 KB
assets/evals/electron-cases.jsonlother14.6 KB
assets/evals/expo-cases.jsonlother18.3 KB
assets/evals/hono-cases.jsonlother22.2 KB
assets/evals/hyper-architecture-cases.jsonlother26.0 KB
assets/evals/lynx-cases.jsonlother17.9 KB
assets/evals/nextjs-cases.jsonlother21.5 KB
assets/evals/rust-cases.jsonlother17.8 KB
assets/evals/tanstack-start-cases.jsonlother21.0 KB
assets/evals/tauri-cases.jsonlother18.6 KB
assets/evals/vite-cases.jsonlother18.6 KB
assets/templates/setup/repo/editorconfigother357 B
assets/templates/setup/repo/gitattributesother714 B
assets/templates/setup/repo/lefthook.ymlconfig843 B
assets/templates/setup/rust/clippy.tomlconfig110 B
assets/templates/setup/rust/rust-toolchain.tomlconfig86 B
assets/templates/setup/rust/rustfmt.tomlconfig200 B
assets/templates/setup/rust/workspace-lints.tomlconfig809 B
assets/templates/setup/typescript/oxlintrc.jsonconfig929 B
assets/templates/setup/typescript/oxlintrc.react.jsonconfig1.1 KB
assets/templates/setup/typescript/prettierignoreother316 B
assets/templates/setup/typescript/prettierrc.jsonconfig263 B
assets/templates/setup/typescript/tsconfig.base.jsonconfig551 B
references/official/astro/astro-2026-11-07.ko.mdmarkdown18.6 KB
references/official/astro/astro-2026-11-07.mdmarkdown17.0 KB
references/official/axum/axum-docs.ko.mdmarkdown5.7 KB
references/official/axum/axum-docs.mdmarkdown4.8 KB
references/official/axum/ecosystem-docs.ko.mdmarkdown3.8 KB
references/official/axum/ecosystem-docs.mdmarkdown3.5 KB
references/official/axum/sqlx-docs.ko.mdmarkdown5.5 KB
references/official/axum/sqlx-docs.mdmarkdown4.7 KB
references/official/axum/tower-docs.ko.mdmarkdown4.2 KB
references/official/axum/tower-docs.mdmarkdown3.7 KB
references/official/axum/utoipa-docs.ko.mdmarkdown4.1 KB
references/official/axum/utoipa-docs.mdmarkdown3.7 KB
references/official/electron/electron-2026-11-08.ko.mdmarkdown15.7 KB
references/official/electron/electron-2026-11-08.mdmarkdown14.1 KB
references/official/expo/expo-react-native-2026-11-04.ko.mdmarkdown23.0 KB
references/official/expo/expo-react-native-2026-11-04.mdmarkdown21.5 KB
references/official/hono/drizzle-docs.ko.mdmarkdown7.0 KB
references/official/hono/drizzle-docs.mdmarkdown6.6 KB
references/official/hono/hono-docs.ko.mdmarkdown15.8 KB
references/official/hono/hono-docs.mdmarkdown14.8 KB
references/official/lynx/lynx-2026-11-07.ko.mdmarkdown14.3 KB
references/official/lynx/lynx-2026-11-07.mdmarkdown14.0 KB
references/official/nextjs/current-docs-2026-11-04.ko.mdmarkdown13.1 KB
references/official/nextjs/current-docs-2026-11-04.mdmarkdown12.0 KB
references/official/nextjs/drizzle-docs.ko.mdmarkdown6.7 KB
references/official/nextjs/drizzle-docs.mdmarkdown6.3 KB
references/official/nextjs/nextjs-docs.ko.mdmarkdown13.6 KB
references/official/nextjs/nextjs-docs.mdmarkdown13.9 KB
references/official/rust/rust-crates-2026-11-07.ko.mdmarkdown22.6 KB
references/official/rust/rust-crates-2026-11-07.mdmarkdown22.0 KB
references/official/tanstack-start/current-docs-2026-11-04.ko.mdmarkdown16.0 KB
references/official/tanstack-start/current-docs-2026-11-04.mdmarkdown14.7 KB
references/official/tanstack-start/tanstack-router-2026-11-04.ko.mdmarkdown10.5 KB
references/official/tanstack-start/tanstack-router-2026-11-04.mdmarkdown9.6 KB
references/official/tanstack-start/tanstack-start-2026-11-04.ko.mdmarkdown25.8 KB
references/official/tanstack-start/tanstack-start-2026-11-04.mdmarkdown23.9 KB
references/official/tauri/tanstack-vite-react-2026-11-04.ko.mdmarkdown14.1 KB
references/official/tauri/tanstack-vite-react-2026-11-04.mdmarkdown13.1 KB
references/official/tauri/tauri-v2-2026-11-04.ko.mdmarkdown18.5 KB
references/official/tauri/tauri-v2-2026-11-04.mdmarkdown17.6 KB
references/official/tooling/tooling-2026-11-07.ko.mdmarkdown21.0 KB
references/official/tooling/tooling-2026-11-07.mdmarkdown20.5 KB
references/official/vite/current-docs-2026-11-04.ko.mdmarkdown11.2 KB
references/official/vite/current-docs-2026-11-04.mdmarkdown10.3 KB
rules/astro/actions-middleware-env.ko.mdmarkdown14.6 KB
rules/astro/actions-middleware-env.mdmarkdown12.9 KB
rules/astro/content.ko.mdmarkdown8.1 KB
rules/astro/content.mdmarkdown7.3 KB
rules/astro/performance.ko.mdmarkdown11.3 KB
rules/astro/performance.mdmarkdown10.0 KB
rules/astro/project-structure.ko.mdmarkdown11.2 KB
rules/astro/project-structure.mdmarkdown9.6 KB
rules/astro/rendering-and-islands.ko.mdmarkdown10.2 KB
rules/astro/rendering-and-islands.mdmarkdown8.7 KB
rules/astro/testing.ko.mdmarkdown10.4 KB
rules/astro/testing.mdmarkdown9.4 KB
rules/axum/conventions.ko.mdmarkdown5.3 KB
rules/axum/conventions.mdmarkdown4.8 KB
rules/axum/database.ko.mdmarkdown11.9 KB
rules/axum/database.mdmarkdown10.2 KB
rules/axum/errors.ko.mdmarkdown6.5 KB
rules/axum/errors.mdmarkdown6.0 KB
rules/axum/handlers.ko.mdmarkdown5.6 KB
rules/axum/handlers.mdmarkdown5.0 KB
rules/axum/middleware.ko.mdmarkdown5.4 KB
rules/axum/middleware.mdmarkdown4.9 KB
rules/axum/openapi.ko.mdmarkdown9.5 KB
rules/axum/openapi.mdmarkdown8.3 KB
rules/axum/performance.ko.mdmarkdown9.6 KB
rules/axum/performance.mdmarkdown8.6 KB
rules/axum/platform.ko.mdmarkdown6.9 KB
rules/axum/platform.mdmarkdown6.3 KB
rules/axum/project-structure.ko.mdmarkdown10.8 KB
rules/axum/project-structure.mdmarkdown9.9 KB
rules/axum/routes.ko.mdmarkdown7.3 KB
rules/axum/routes.mdmarkdown6.3 KB
rules/axum/testing.ko.mdmarkdown5.2 KB
rules/axum/testing.mdmarkdown4.6 KB
rules/axum/validation.ko.mdmarkdown4.8 KB
rules/axum/validation.mdmarkdown4.4 KB
rules/electron/packaging.ko.mdmarkdown7.9 KB
rules/electron/packaging.mdmarkdown7.0 KB
rules/electron/performance.ko.mdmarkdown5.8 KB
rules/electron/performance.mdmarkdown5.0 KB
rules/electron/processes-and-ipc.ko.mdmarkdown10.6 KB
rules/electron/processes-and-ipc.mdmarkdown9.7 KB
rules/electron/project-structure.ko.mdmarkdown8.8 KB
rules/electron/project-structure.mdmarkdown8.1 KB
rules/electron/renderer.ko.mdmarkdown10.8 KB
rules/electron/renderer.mdmarkdown9.8 KB
rules/electron/security.ko.mdmarkdown10.3 KB
rules/electron/security.mdmarkdown9.2 KB
rules/electron/testing.ko.mdmarkdown5.7 KB
rules/electron/testing.mdmarkdown5.0 KB
rules/expo/data-state-and-boundaries.ko.mdmarkdown4.7 KB
rules/expo/data-state-and-boundaries.mdmarkdown4.3 KB
rules/expo/native-platform-and-security.ko.mdmarkdown8.2 KB
rules/expo/native-platform-and-security.mdmarkdown7.5 KB
rules/expo/performance.ko.mdmarkdown11.2 KB
rules/expo/performance.mdmarkdown10.1 KB
rules/expo/project-structure.ko.mdmarkdown13.4 KB
rules/expo/project-structure.mdmarkdown13.2 KB
rules/expo/routing-and-navigation.ko.mdmarkdown8.6 KB
rules/expo/routing-and-navigation.mdmarkdown8.0 KB
rules/expo/testing-and-validation.ko.mdmarkdown5.1 KB
rules/expo/testing-and-validation.mdmarkdown4.8 KB
rules/hono/conventions.ko.mdmarkdown3.7 KB
rules/hono/conventions.mdmarkdown3.5 KB
rules/hono/database.ko.mdmarkdown11.7 KB
rules/hono/database.mdmarkdown10.8 KB
rules/hono/errors.ko.mdmarkdown3.9 KB
rules/hono/errors.mdmarkdown3.7 KB
rules/hono/handlers.ko.mdmarkdown2.5 KB
rules/hono/handlers.mdmarkdown2.2 KB
rules/hono/middleware.ko.mdmarkdown3.3 KB
rules/hono/middleware.mdmarkdown3.0 KB
rules/hono/openapi.ko.mdmarkdown11.7 KB
rules/hono/openapi.mdmarkdown10.9 KB
rules/hono/performance.ko.mdmarkdown8.9 KB
rules/hono/performance.mdmarkdown8.0 KB
rules/hono/platform.ko.mdmarkdown5.0 KB
rules/hono/platform.mdmarkdown4.7 KB
rules/hono/project-structure.ko.mdmarkdown10.4 KB
rules/hono/project-structure.mdmarkdown9.9 KB
rules/hono/routes.ko.mdmarkdown6.9 KB
rules/hono/routes.mdmarkdown6.6 KB
rules/hono/testing-rpc.ko.mdmarkdown5.6 KB
rules/hono/testing-rpc.mdmarkdown5.2 KB
rules/hono/validation.ko.mdmarkdown3.7 KB
rules/hono/validation.mdmarkdown3.5 KB
rules/lynx/native-and-platform.ko.mdmarkdown11.4 KB
rules/lynx/native-and-platform.mdmarkdown10.7 KB
rules/lynx/performance.ko.mdmarkdown11.6 KB
rules/lynx/performance.mdmarkdown10.6 KB
rules/lynx/project-structure.ko.mdmarkdown10.2 KB
rules/lynx/project-structure.mdmarkdown9.6 KB
rules/lynx/testing.ko.mdmarkdown7.0 KB
rules/lynx/testing.mdmarkdown6.4 KB
rules/lynx/threading.ko.mdmarkdown13.0 KB
rules/lynx/threading.mdmarkdown12.0 KB
rules/lynx/ui-and-data.ko.mdmarkdown11.8 KB
rules/lynx/ui-and-data.mdmarkdown10.8 KB
rules/nextjs/data-fetching.ko.mdmarkdown9.9 KB
rules/nextjs/data-fetching.mdmarkdown9.3 KB
rules/nextjs/db.ko.mdmarkdown8.1 KB
rules/nextjs/db.mdmarkdown7.3 KB
rules/nextjs/execution-model.ko.mdmarkdown5.0 KB
rules/nextjs/execution-model.mdmarkdown4.5 KB
rules/nextjs/hooks.ko.mdmarkdown5.8 KB
rules/nextjs/hooks.mdmarkdown5.3 KB
rules/nextjs/performance.ko.mdmarkdown12.5 KB
rules/nextjs/performance.mdmarkdown11.2 KB
rules/nextjs/platform.ko.mdmarkdown7.7 KB
rules/nextjs/platform.mdmarkdown7.0 KB
rules/nextjs/project-structure.ko.mdmarkdown9.4 KB
rules/nextjs/project-structure.mdmarkdown9.0 KB
rules/nextjs/route-handlers.ko.mdmarkdown4.7 KB
rules/nextjs/route-handlers.mdmarkdown4.3 KB
rules/nextjs/routes.ko.mdmarkdown5.0 KB
rules/nextjs/routes.mdmarkdown4.6 KB
rules/nextjs/server-actions.ko.mdmarkdown7.1 KB
rules/nextjs/server-actions.mdmarkdown6.4 KB
rules/nextjs/services.ko.mdmarkdown5.8 KB
rules/nextjs/services.mdmarkdown5.5 KB
rules/nextjs/validation.ko.mdmarkdown2.2 KB
rules/nextjs/validation.mdmarkdown2.3 KB
rules/rust/cli.ko.mdmarkdown13.6 KB
rules/rust/cli.mdmarkdown12.0 KB
rules/rust/crate-layout.ko.mdmarkdown11.4 KB
rules/rust/crate-layout.mdmarkdown10.1 KB
rules/rust/errors-and-logging.ko.mdmarkdown13.0 KB
rules/rust/errors-and-logging.mdmarkdown11.6 KB
rules/rust/mcp-server.ko.mdmarkdown15.2 KB
rules/rust/mcp-server.mdmarkdown13.8 KB

references/official/electron/electron-2026-11-08.md

View on GitHub
# Official Electron, Tooling, and Renderer Stack Snapshot — 2026-11-08

- last_verified_at: 2026-11-08
- applies_to: Electron 43–45 (45 stable), electron-vite 6, Electron Forge 8, electron-builder 26, Vite 8, React 19.3, Tailwind CSS 4.3, TanStack Router v1, TanStack Query v5
- source_priority: vendor documentation and release notes > package registry metadata > vendor source code > surveyed open-source projects
- refresh_when: a new Electron stable major ships (46 is scheduled for 2027-01-05); electron-vite, Forge, or electron-builder changes major; Tailwind, TanStack Router, or Query changes major

Use this file for version-sensitive facts only. The rule files under `rules/electron/` own the decisions; project and user instructions remain authoritative.

## Contents

- Package Snapshot
- Electron Versions and Support
- Breaking Changes That Shape Architecture
- Process Model and IPC
- Security Checklist and Fuses
- Build Tools
- Packaging and Updates
- Renderer Stack
- Testing
- Unverified Topics
- Sources

## Package Snapshot

npm `latest` observed on 2026-11-08. Evidence of registry state, not an upgrade instruction.

| Package | Version | Note |
|---|---:|---|
| `electron` | 45.2.3 | Chromium 156.0.8078.80, Node 24.22.2, V8 15.6 |
| `electron-vite` | 6.0.0 | peer `vite ^6 \|\| ^7 \|\| ^8`, Node `^20.19.0 \|\| >=22.12.0` |
| `@electron-forge/cli`, `@electron-forge/plugin-vite`, `@electron-forge/plugin-fuses` | 8.0.1 | ESM-only, Node ≥22.13 |
| `electron-builder` | 26.18.0 | `next` is 27.0.0-alpha |
| `electron-updater` | 6.8.11 | |
| `@electron/fuses` | 2.1.3 | |
| `@electron-toolkit/preload` | 3.0.2 | exposes raw `ipcRenderer` methods |
| `vite` | 8.3.6 | Rolldown-based |
| `@vitejs/plugin-react` | 6.2.1 | peer `vite ^8` only; 5.x for Vite 7 |
| `react` | 19.3.1 | |
| `typescript` | 7.0.2 | |
| `tailwindcss`, `@tailwindcss/vite` | 4.3.5 | lockstep versions |
| `prettier-plugin-tailwindcss` | 0.8.1 | |
| `@tanstack/react-router` | 1.170.46 | |
| `@tanstack/router-plugin` | 1.169.0 | |
| `@tanstack/react-query` | 5.107.1 | |
| `zod` | 4.6.7 | |
| `@playwright/test` | 1.65.0 | |
| `vitest` | 5.1.0 | |
| `electron-trpc` / `@egoist/tipc` | 1.0.0 / 0.4.0 | typed IPC libraries; single-maintainer projects |

## Electron Versions and Support

- A new major ships every 8 weeks, following even Chromium majors, after a 4-week alpha and a 4-week beta. The 45 → 46 gap is about 11 weeks.
- The latest three stable majors are supported, each only at its latest minor; the oldest gets security fixes only. Breaking changes normally stay working for at least two majors before removal.

| Line | Stable | End of life |
|---|---|---|
| 43 | 2026-06-30 | 2027-01-05 |
| 44 | 2026-08-24 | 2027-03-02 |
| 45 | 2026-10-21 | 2027-04-27 |
| 46 (planned) | 2027-01-05 | 2027-06-22 |

Long-standing defaults: `nodeIntegration` false since 5, `contextIsolation` true since 12, renderer sandbox on since 20, `remote` removed in 14, `ipcRenderer` sent over `contextBridge` arrives as `{}` since 29, `File.path` removed in 32 (`webUtils.getPathForFile`), `BrowserView` deprecated in 30 (`WebContentsView`).

## Breaking Changes That Shape Architecture

- 44: macOS 13 or later; no 32-bit builds; `clipboard` removed from the renderer (`navigator.clipboard` or a preload wrapper).
- 45: sandboxed preloads lose `events`, `timers`, `url`, `Buffer`, `setImmediate` — `require` loads only `electron`; screen capture is requested as `display-capture`, not `media`; `window.open` children of an unsandboxed opener get their own sandboxed process; ASAR file descriptors work only through `fs`; synchronous `safeStorage` APIs deprecated.
- 46 (unreleased): synchronous `safeStorage` removed; `utilityProcess` `child.kill()` no longer force-kills.

## Process Model and IPC

- Main: Node, all Electron main APIs, owns the UI thread. Renderer: Chromium, no Node, sandboxed. Preload: sandboxed context with `require('electron')` only (`contextBridge`, `ipcRenderer`, `webFrame`, `webUtils`, `nativeImage`, `crashReporter`). Utility process: Node, forked after `ready`, can use the app `session`.
- `child_process.fork` fails when the `RunAsNode` fuse is off; `utilityProcess.fork` is the documented replacement.
- IPC patterns: `invoke`/`handle` (recommended), `send`/`on`, `webContents.send` to the renderer, `MessagePort` between renderers or processes. `sendSync` is discouraged.
- Payloads use structured clone: DOM objects, `process.env`, streams, Electron objects, and class prototypes do not cross; `Error` loses custom properties.
- `contextBridge` copies and freezes values, proxies functions, drops `Symbol`. A listener wrapper must not pass `IpcRendererEvent` to the page.
- ESM (since 28): main via `.mjs` or `"type": "module"` with explicit awaits before `ready`; sandboxed preloads cannot use ESM and must be CommonJS; unsandboxed ESM preloads need `.mjs`.
- Lifecycle: `requestSingleInstanceLock` plus `second-instance`; `window-all-closed` quits except on macOS; `activate` recreates a window on macOS; `open-url` and `open-file` must be registered before `ready`; macOS URL schemes must be declared in `Info.plist` at build time.

## Security Checklist and Fuses

The security tutorial lists 20 items: secure content; no Node for remote content; context isolation; sandbox; permission request handlers (Electron grants everything by default); keep `webSecurity`; CSP; no `allowRunningInsecureContent`; no experimental features; no `enableBlinkFeatures`; `<webview>` without `allowpopups` and with verified options; limit navigation by parsed origin; limit new windows; no untrusted input to `shell.openExternal`; current Electron; validate every IPC sender; avoid `file://` in favour of a custom protocol; review fuses; do not expose Electron APIs to untrusted content.

- `protocol.registerSchemesAsPrivileged` runs once before `ready`; `protocol.handle` serves after `ready` and must reject path escapes. The `register*Protocol`/`intercept*Protocol` family is deprecated.
- Fuses (defaults): `RunAsNode` on, `EnableCookieEncryption` off, `EnableNodeOptionsEnvironmentVariable` on, `EnableNodeCliInspectArguments` on, `EnableEmbeddedAsarIntegrityValidation` off, `OnlyLoadAppFromAsar` off, `LoadBrowserProcessSpecificV8Snapshot` off, `GrantFileProtocolExtraPrivileges` on, `WasmTrapHandlers` on. They are flipped at package time before signing.
- ASAR integrity: macOS from 16, Windows from 30; mismatch terminates the app.
- `safeStorage`: main only; async API from 45; Keychain, DPAPI, Secret Service or KWallet; `basic_text` on Linux is no protection; macOS needs a stable signature.

## Build Tools

- electron-vite: `electron.vite.config.*` with `main`, `preload`, `renderer` blocks; default entries `src/main/index.ts`, `src/preload/index.ts`, `src/renderer/index.html`; renderer `base: './'` in production; dev URL in `ELECTRON_RENDERER_URL`; env prefixes `MAIN_VITE_`, `PRELOAD_VITE_`, `RENDERER_VITE_`, `VITE_`; `.env` files are not loaded into the config by default (`loadEnv`). Version 6 integrates Rolldown and accepts `rollupOptions` and `rolldownOptions`. `build.externalizeDeps` (default on for main and preload) and `build.bytecode` replaced the deprecated plugins in 5. Isolated build (`build.isolatedEntries` with `externalizeDeps: false`) yields a sandbox-compatible single-bundle preload. `electron-vite dev -w` rebuilds and restarts main and reloads on preload changes. Some docs pages still describe version 5.
- Electron Forge 8: Vite plugin stable, targets Vite 8, isolated builds, opt-in `hotRestart`; `publish` renamed `release`; injected `MAIN_WINDOW_VITE_DEV_SERVER_URL` and `MAIN_WINDOW_VITE_NAME`; template `vite` (TypeScript) with three `vite.*.config.mts` files and a `FusesPlugin` flipping six fuses.
- Official electron-vite `react-ts` template: `sandbox: false`, exposes `@electron-toolkit/preload` `electronAPI`, loads production with `loadFile`, ships `tsconfig.node.json` and `tsconfig.web.json`, no router, no Tailwind, no tests.

## Packaging and Updates

- electron-builder 26: `electron-builder.yml`, `asarUnpack`, `electronFuses`, `npmRebuild`; `mac.notarize` with hardened runtime and `allow-jit` entitlement; default docs URLs show v27, stable docs live under `/v26/`; implicit CI publishing deprecated.
- `electron-updater`: app dependency, `publish` config, no `setFeedURL`; macOS needs the `zip` target; Squirrel.Windows unsupported.
- Built-in `autoUpdater`: macOS (Squirrel.Mac, signed app required) and Windows (MSIX or Squirrel.Windows); no Linux. `update.electronjs.org` needs a public GitHub repository and checks every 10 minutes through `update-electron-app`.

## Renderer Stack

- TanStack Router: browser history is the default; hash history fits environments without a server; memory history keeps location in memory. The Vite plugin runs before `@vitejs/plugin-react`; `routesDirectory` and `generatedRouteTree` resolve from the working directory, so electron-vite renderers pass absolute paths. Exclude `routeTree.gen.ts` from lint and format.
- TanStack Query: stale by default, refetch on mount, focus (via `visibilitychange`), and reconnect; `focusManager.setEventListener` and `onlineManager.setEventListener` replace the web listeners; `networkMode: 'always'` suits a `queryFn` that does not need the network.
- Tailwind CSS v4: `@tailwindcss/vite` plus `@import "tailwindcss"`; CSS-first `@theme`, `@source`, `@plugin`, `@custom-variant`; scanning skips `.gitignore`d paths, `node_modules`, binaries, CSS, and lockfiles; baseline Safari 16.4, Chrome 111, Firefox 128; `npx @tailwindcss/upgrade` migrates from v3; `prettier-plugin-tailwindcss` must be last and needs `tailwindStylesheet` for v4.

## Testing

- Electron ships no runner; documented options are WebdriverIO, Selenium, and Playwright (experimental, through CDP, Electron 21+).
- Playwright `_electron.launch` times out when the inspect fuse is off; native dialogs must be stubbed through `evaluate`.
- Vitest environments: `node`, `jsdom`, `happy-dom`, `edge-runtime`; Browser Mode is a project.

## Unverified Topics

- Whether `@tanstack/router-plugin` file watching interacts with electron-vite main-process restarts; no primary source.
- Official TanStack guidance specific to Electron beyond "environments that don't have a server".
- `electron-trpc` 1.0 behaviour with `sandbox: true`.
- The Electron versions that introduced `protocol.handle` and `utilityProcess`; the docs state none.
- Linux deep-link registration through `.desktop` files; not covered by the `app` API page.
- How `autoCodeSplitting` interacts with electron-vite chunking.

## Sources

> Links checked 2026-11-08.

| Claim | Source |
|---|---|
| Versions and publish dates | https://registry.npmjs.org/electron/latest and the `latest` URL of each package in the snapshot table; https://releases.electronjs.org/releases.json |
| Release cadence, support policy, and schedule | https://www.electronjs.org/docs/latest/tutorial/electron-timelines, https://releases.electronjs.org/schedule |
| Breaking changes 43–47 | https://www.electronjs.org/docs/latest/breaking-changes |
| Process model, sandbox, context isolation, ESM | https://www.electronjs.org/docs/latest/tutorial/process-model, https://www.electronjs.org/docs/latest/tutorial/sandbox, https://www.electronjs.org/docs/latest/tutorial/context-isolation, https://www.electronjs.org/docs/latest/tutorial/esm |
| IPC, `contextBridge`, `MessagePort` | https://www.electronjs.org/docs/latest/tutorial/ipc, https://www.electronjs.org/docs/latest/api/context-bridge, https://www.electronjs.org/docs/latest/tutorial/message-ports |
| Lifecycle and deep links | https://www.electronjs.org/docs/latest/api/app |
| Security checklist, protocol, fuses, ASAR integrity, `safeStorage`, `session`, `net` | https://www.electronjs.org/docs/latest/tutorial/security, https://www.electronjs.org/docs/latest/api/protocol, https://www.electronjs.org/docs/latest/tutorial/fuses, https://www.electronjs.org/docs/latest/tutorial/asar-integrity, https://www.electronjs.org/docs/latest/api/safe-storage, https://www.electronjs.org/docs/latest/api/session, https://www.electronjs.org/docs/latest/api/net |
| Performance recommendations | https://www.electronjs.org/docs/latest/tutorial/performance |
| Auto update | https://www.electronjs.org/docs/latest/api/auto-updater, https://www.electronjs.org/docs/latest/tutorial/updates |
| Testing | https://www.electronjs.org/docs/latest/tutorial/automated-testing, https://playwright.dev/docs/api/class-electron, https://vitest.dev/guide/environment |
| electron-vite | https://electron-vite.org/guide/dev, https://electron-vite.org/guide/env-and-mode, https://electron-vite.org/guide/isolated-build, https://electron-vite.org/guide/dependency-handling, https://electron-vite.org/guide/source-code-protection, https://github.com/alex8088/electron-vite/blob/master/CHANGELOG.md |
| Official electron-vite template and toolkit preload | https://github.com/alex8088/quick-start, https://github.com/alex8088/electron-toolkit |
| Electron Forge 8 | https://github.com/electron/forge/releases/tag/v8.0.1, https://www.electronforge.io/config/plugins/vite, https://www.electronforge.io/config/plugins/fuses |
| electron-builder and electron-updater | https://www.electron.build/v26/docs/configuration, https://www.electron.build/v26/docs/code-signing-mac, https://www.electron.build/v26/docs/auto-update, https://www.electron.build/v26/docs/publish |
| TanStack Router and Query | https://tanstack.com/router/latest/docs/framework/react/guide/history-types, https://tanstack.com/router/latest/docs/framework/react/installation/with-vite, https://github.com/TanStack/router/issues/1170, https://tanstack.com/query/latest/docs/framework/react/guides/important-defaults, https://tanstack.com/query/latest/docs/reference/focusManager, https://tanstack.com/query/latest/docs/framework/react/guides/network-mode |
| Tailwind CSS v4 | https://tailwindcss.com/docs/installation/using-vite, https://tailwindcss.com/docs/detecting-classes-in-source-files, https://tailwindcss.com/docs/compatibility, https://tailwindcss.com/docs/upgrade-guide, https://github.com/tailwindlabs/prettier-plugin-tailwindcss |
| Surveyed project structures | https://github.com/CherryHQ/cherry-studio, https://github.com/chatboxai/chatbox, https://github.com/electron-react-boilerplate/electron-react-boilerplate, https://github.com/cawa-93/vite-electron-builder, https://github.com/guasam/electron-react-app |
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: 471kUpdated Claude CodeCodexVerifiedInstall
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: 471kUpdated Claude CodeCodexVerifiedInstall
rea-tool-designmorluto/reaAudit, investigate, design, or change REA investigation tools, CLI/MCP contracts, provider capabilities, and Evidence semantics.Stars: 471kUpdated Claude CodeCodexVerifiedInstall
ponytail-auditDietrichGebert/ponytailQuality audit of the whole repo: bugs, security, real load, missing tests, speed, and what to delete. Most important first.Stars: 194kUpdated Claude CodeCodexVerifiedInstall