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.ko.md

View on GitHub
# Electron, 도구, renderer 스택 공식 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: 제조사 문서와 release note > package registry metadata > 제조사 source code > 조사한 오픈소스 프로젝트
- refresh_when: 새 Electron stable major가 나올 때(46은 2027-01-05 예정), electron-vite, Forge, electron-builder가 major를 바꿀 때, Tailwind, TanStack Router, Query가 major를 바꿀 때

이 파일은 version에 민감한 사실에만 씁니다. 결정은 `rules/electron/` 아래 rule 파일이 소유하며, 프로젝트 및 사용자 지시가 여전히 우선합니다.

## 목차

- 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

2026-11-08에 관측한 npm `latest`입니다. registry 상태의 근거이며 upgrade 지시가 아닙니다.

| 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 전용, Node ≥22.13 |
| `electron-builder` | 26.18.0 | `next`는 27.0.0-alpha |
| `electron-updater` | 6.8.11 | |
| `@electron/fuses` | 2.1.3 | |
| `@electron-toolkit/preload` | 3.0.2 | raw `ipcRenderer` method를 노출합니다 |
| `vite` | 8.3.6 | Rolldown 기반 |
| `@vitejs/plugin-react` | 6.2.1 | peer는 `vite ^8`뿐, Vite 7에는 5.x를 씁니다 |
| `react` | 19.3.1 | |
| `typescript` | 7.0.2 | |
| `tailwindcss`, `@tailwindcss/vite` | 4.3.5 | version을 함께 올립니다 |
| `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 library이며 유지관리자가 한 명인 프로젝트입니다 |

## Electron Versions and Support

- 새 major는 8주마다 나오며, 짝수 Chromium major를 따르고 alpha 4주와 beta 4주를 거칩니다. 45 → 46 간격은 약 11주입니다.
- 지원 대상은 최근 stable major 세 개이고 각 major의 최신 minor만 지원하며, 가장 오래된 major는 보안 fix만 받습니다. Breaking change는 보통 두 major 이상 동작을 유지한 뒤 제거됩니다.

| 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 |

오래 유지된 default는 이렇습니다. `nodeIntegration`은 5부터 false, `contextIsolation`은 12부터 true, renderer sandbox는 20부터 켜져 있고, `remote`는 14에서 제거됐고, `contextBridge`로 넘긴 `ipcRenderer`는 29부터 `{}`로 도착하며, `File.path`는 32에서 제거됐고(`webUtils.getPathForFile`), `BrowserView`는 30에서 폐기됐습니다(`WebContentsView`).

## Breaking Changes That Shape Architecture

- 44: macOS 13 이상, 32-bit build 없음, renderer에서 `clipboard` 제거(`navigator.clipboard` 또는 preload wrapper를 씁니다).
- 45: sandbox preload에서 `events`, `timers`, `url`, `Buffer`, `setImmediate`를 잃고, `require`는 `electron`만 불러옵니다. screen capture는 `media`가 아니라 `display-capture`로 요청합니다. sandbox가 아닌 opener의 `window.open` 자식 창은 자체 sandbox process를 갖습니다. ASAR file descriptor는 `fs`를 거쳐야만 동작합니다. 동기 `safeStorage` API는 폐기됐습니다.
- 46(미출시): 동기 `safeStorage`가 제거되고, `utilityProcess`의 `child.kill()`은 더 이상 강제 종료하지 않습니다.

## Process Model and IPC

- Main은 Node이며 Electron main API 전체를 쓰고 UI thread를 소유합니다. Renderer는 Chromium이고 Node가 없으며 sandbox에서 돕니다. Preload는 `require('electron')`만 쓸 수 있는 sandbox context입니다(`contextBridge`, `ipcRenderer`, `webFrame`, `webUtils`, `nativeImage`, `crashReporter`). Utility process는 Node이며 `ready` 뒤에 fork되고 app `session`을 쓸 수 있습니다.
- `RunAsNode` fuse가 꺼져 있으면 `child_process.fork`가 실패합니다. 문서가 지정한 대체 수단은 `utilityProcess.fork`입니다.
- IPC pattern은 `invoke`/`handle`(권장), `send`/`on`, renderer로 보내는 `webContents.send`, renderer나 process 사이의 `MessagePort`입니다. `sendSync`는 권장하지 않습니다.
- Payload는 structured clone을 씁니다. DOM object, `process.env`, stream, Electron object, class prototype은 넘어가지 않고, `Error`는 custom property를 잃습니다.
- `contextBridge`는 값을 복사해 freeze하고 function을 proxy하며 `Symbol`을 버립니다. listener wrapper는 `IpcRendererEvent`를 page로 넘기면 안 됩니다.
- ESM(28부터): main은 `.mjs` 또는 `"type": "module"`을 쓰고 `ready` 전에 명시적으로 await합니다. sandbox preload는 ESM을 쓸 수 없어 CommonJS여야 하고, sandbox가 아닌 ESM preload는 `.mjs`가 필요합니다.
- Lifecycle: `requestSingleInstanceLock`과 `second-instance`를 함께 씁니다. `window-all-closed`는 macOS를 빼고 종료합니다. `activate`는 macOS에서 창을 다시 만듭니다. `open-url`과 `open-file`은 `ready` 전에 등록해야 합니다. macOS URL scheme은 build 시점에 `Info.plist`에 선언해야 합니다.

## Security Checklist and Fuses

보안 tutorial은 20개 항목을 나열합니다. 안전한 content, remote content에 Node를 주지 않음, context isolation, sandbox, permission request handler(Electron은 기본으로 모두 허용합니다), `webSecurity` 유지, CSP, `allowRunningInsecureContent` 금지, experimental feature 금지, `enableBlinkFeatures` 금지, `allowpopups` 없이 option을 검증한 `<webview>`, 파싱한 origin으로 navigation 제한, 새 창 제한, `shell.openExternal`에 untrusted input 금지, 최신 Electron 사용, 모든 IPC sender 검증, `file://` 대신 custom protocol 사용, fuse 검토, untrusted content에 Electron API를 노출하지 않음입니다.

- `protocol.registerSchemesAsPrivileged`는 `ready` 전에 한 번 실행합니다. `protocol.handle`은 `ready` 뒤에 응답하며 경로 이탈을 거부해야 합니다. `register*Protocol`/`intercept*Protocol` 계열은 폐기됐습니다.
- Fuse(default): `RunAsNode` on, `EnableCookieEncryption` off, `EnableNodeOptionsEnvironmentVariable` on, `EnableNodeCliInspectArguments` on, `EnableEmbeddedAsarIntegrityValidation` off, `OnlyLoadAppFromAsar` off, `LoadBrowserProcessSpecificV8Snapshot` off, `GrantFileProtocolExtraPrivileges` on, `WasmTrapHandlers` on입니다. Fuse는 signing 전 packaging 시점에 뒤집습니다.
- ASAR integrity: macOS는 16부터, Windows는 30부터 지원하며 불일치하면 앱이 종료됩니다.
- `safeStorage`: main 전용이고 45부터 async API를 씁니다. Keychain, DPAPI, Secret Service 또는 KWallet을 쓰며, Linux의 `basic_text`는 보호가 아닙니다. macOS는 안정적인 signature가 필요합니다.

## Build Tools

- electron-vite: `electron.vite.config.*`에 `main`, `preload`, `renderer` block을 둡니다. 기본 entry는 `src/main/index.ts`, `src/preload/index.ts`, `src/renderer/index.html`이고 production에서 renderer는 `base: './'`입니다. dev URL은 `ELECTRON_RENDERER_URL`에 있고 env prefix는 `MAIN_VITE_`, `PRELOAD_VITE_`, `RENDERER_VITE_`, `VITE_`입니다. `.env` file은 기본으로 config에 load되지 않습니다(`loadEnv`). Version 6은 Rolldown을 통합하고 `rollupOptions`와 `rolldownOptions`를 받습니다. `build.externalizeDeps`(main과 preload에 기본 on)와 `build.bytecode`가 5에서 폐기된 plugin을 대체합니다. Isolated build(`build.isolatedEntries`에 `externalizeDeps: false`)는 sandbox와 호환되는 single-bundle preload를 만듭니다. `electron-vite dev -w`는 main을 rebuild해 restart하고 preload 변경 시 reload합니다. 일부 문서 page는 아직 version 5를 설명합니다.
- Electron Forge 8: Vite plugin이 stable이고 Vite 8을 대상으로 하며 isolated build와 opt-in `hotRestart`를 씁니다. `publish`는 `release`로 이름이 바뀌었습니다. `MAIN_WINDOW_VITE_DEV_SERVER_URL`과 `MAIN_WINDOW_VITE_NAME`을 주입합니다. template `vite`(TypeScript)는 `vite.*.config.mts` 세 개와 fuse 여섯 개를 뒤집는 `FusesPlugin`을 포함합니다.
- 공식 electron-vite `react-ts` template: `sandbox: false`이고 `@electron-toolkit/preload`의 `electronAPI`를 노출하며 production은 `loadFile`로 load합니다. `tsconfig.node.json`과 `tsconfig.web.json`을 넣어 주고 router, Tailwind, test는 없습니다.

## Packaging and Updates

- electron-builder 26: `electron-builder.yml`, `asarUnpack`, `electronFuses`, `npmRebuild`를 씁니다. `mac.notarize`는 hardened runtime과 `allow-jit` entitlement를 씁니다. 기본 docs URL은 v27을 보여 주고 stable docs는 `/v26/` 아래에 있습니다. 암묵적 CI publishing은 폐기됐습니다.
- `electron-updater`: app dependency이고 `publish` config를 쓰며 `setFeedURL`은 쓰지 않습니다. macOS는 `zip` target이 필요하고 Squirrel.Windows는 지원하지 않습니다.
- 내장 `autoUpdater`: macOS(Squirrel.Mac, signed app 필요)와 Windows(MSIX 또는 Squirrel.Windows)를 지원하고 Linux는 없습니다. `update.electronjs.org`는 공개 GitHub 저장소가 필요하며 `update-electron-app`으로 10분마다 확인합니다.

## Renderer Stack

- TanStack Router: browser history가 기본이고, hash history는 server가 없는 환경에 맞으며 memory history는 location을 memory에 둡니다. Vite plugin은 `@vitejs/plugin-react`보다 먼저 실행됩니다. `routesDirectory`와 `generatedRouteTree`는 작업 directory 기준으로 해석되므로 electron-vite renderer는 절대 경로를 넘깁니다. `routeTree.gen.ts`는 lint와 format에서 제외합니다.
- TanStack Query: 기본으로 stale이고 mount, focus(`visibilitychange` 경유), reconnect에서 refetch합니다. `focusManager.setEventListener`와 `onlineManager.setEventListener`가 web listener를 대체하고, `networkMode: 'always'`는 network가 필요 없는 `queryFn`에 맞습니다.
- Tailwind CSS v4: `@tailwindcss/vite`와 `@import "tailwindcss"`를 씁니다. CSS 우선 방식의 `@theme`, `@source`, `@plugin`, `@custom-variant`가 있고, scan은 `.gitignore`된 경로, `node_modules`, binary, CSS, lockfile을 건너뜁니다. 기준 browser는 Safari 16.4, Chrome 111, Firefox 128이고, `npx @tailwindcss/upgrade`로 v3에서 옮깁니다. `prettier-plugin-tailwindcss`는 마지막에 두고 v4에서는 `tailwindStylesheet`가 필요합니다.

## Testing

- Electron은 runner를 제공하지 않습니다. 문서가 제시한 선택지는 WebdriverIO, Selenium, Playwright(실험적, CDP 경유, Electron 21 이상)입니다.
- Playwright `_electron.launch`는 inspect fuse가 꺼져 있으면 time out합니다. native dialog는 `evaluate`로 stub해야 합니다.
- Vitest environment는 `node`, `jsdom`, `happy-dom`, `edge-runtime`이고 Browser Mode는 별도 프로젝트입니다.

## Unverified Topics

- `@tanstack/router-plugin`의 file watching이 electron-vite main process restart와 어떻게 상호작용하는지. 1차 출처가 없습니다.
- "server가 없는 환경"이라는 설명을 넘어선, Electron에 특정된 공식 TanStack 지침.
- `sandbox: true`에서 `electron-trpc` 1.0의 동작.
- `protocol.handle`과 `utilityProcess`를 도입한 Electron version. 문서는 밝히지 않습니다.
- `.desktop` file을 통한 Linux deep-link 등록. `app` API page가 다루지 않습니다.
- `autoCodeSplitting`이 electron-vite chunking과 어떻게 상호작용하는지.

## Sources

> 링크 확인 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