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

rules/electron/security.md

View on GitHub
# Security

> Treat the renderer as untrusted web content, keep every privilege in the main process, serve the app from a custom protocol, and flip the fuses before signing.

Rules are labelled `official` when a page in `references/official/electron/electron-2026-11-08.md` states them, and `hypercore-default` when this package chose the default. The numbers in brackets are the item numbers of Electron's security checklist.

## 1. `webPreferences` baseline

```ts
// src/main/windows/main-window.ts
new BrowserWindow({
  show: false,
  webPreferences: {
    preload: join(__dirname, '../preload/index.js'),
    contextIsolation: true,   // default since 12 [3]
    sandbox: true,            // default since 20 [4]
    nodeIntegration: false,   // default since 5 [2]
    webSecurity: true,        // [6]
  },
})
```

- `official` — Write the four security keys explicitly even though they match the defaults, so a reviewer sees them and a copied snippet cannot silently turn one off. Turning `contextIsolation` off or `nodeIntegration` on also disables the sandbox [3].
- `official` — Never set `allowRunningInsecureContent`, `experimentalFeatures`, or `enableBlinkFeatures` [8, 9, 10]. Disabling `webSecurity` also forces `allowRunningInsecureContent` on [6].
- `hypercore-default` — Call `app.enableSandbox()` before `ready` in a new app, so a window created later with `sandbox: false` is still sandboxed [4].

## 2. Content and navigation

- `official` — Load only secure content: the packaged app from a custom protocol, remote content over HTTPS only [1, 18].
- `official` — Register the app scheme once, before `ready`, with `protocol.registerSchemesAsPrivileged([{ scheme: 'app', privileges: { standard: true, secure: true, supportFetchAPI: true } }])`, then serve files with `protocol.handle('app', …)` after `ready`. `standard` gives relative URL resolution and web storage; the older `register*Protocol` and `intercept*Protocol` family is deprecated.
- `official` — The `protocol.handle` callback resolves the requested path against the renderer output folder and rejects any path that escapes it (`path.relative` result starting with `..`). A handler without that check serves the whole disk.
- `official` — `file://` pages get privileges beyond a browser's; with the `GrantFileProtocolExtraPrivileges` fuse on they can reach every file. Load the production build from the custom protocol, not `loadFile` [18].
- `official` — Set a Content-Security-Policy as a response header through `session.defaultSession.webRequest.onHeadersReceived` or in the `protocol.handle` response; a `<meta http-equiv>` tag is the fallback only where headers cannot be set [7].
- `official` — Limit navigation in `app.on('web-contents-created')`: handle `will-navigate` by comparing `new URL(url).origin` with an allowlist (never `startsWith`), and deny `setWindowOpenHandler` by default with `{ action: 'deny' }` [13, 14].
- `official` — Pass a URL to `shell.openExternal` only after parsing it and checking its protocol (`https:` and the mail scheme you need) and host against an allowlist; untrusted input there can become command execution [15].
- `official` — Do not use `<webview>`. When an existing app must, verify its options in `will-attach-webview` and never set `allowpopups` [11, 12]. New embedded content uses `WebContentsView`; `BrowserView` is deprecated since Electron 30.

### Development and production URLs

- `hypercore-default` — In development load the Vite dev server URL that electron-vite or Forge provides (`ELECTRON_RENDERER_URL` or the Forge-injected constant); in production load `app://…/index.html`. Choose by `app.isPackaged` or the build-time mode, never by a renderer-supplied value, and allow the dev origin in the navigation allowlist only in development builds.

## 3. Permissions and sessions

- `official` — Electron approves every permission request by default. Install `setPermissionRequestHandler` (and `setPermissionCheckHandler`) on every session that loads content, granting only the permissions the product needs for the app origin [5].
- `official` — Since Electron 45 screen capture is requested as `display-capture`, and `media` means camera and microphone only; a handler that granted `media` for screen sharing must now grant `display-capture`.
- `hypercore-default` — Load untrusted remote content, if the app must, in its own `session.fromPartition()` with its own permission handler, never in the app's default session that holds the login cookies.

## 4. IPC exposure

- `official` — Do not expose Electron APIs, especially `ipcRenderer`, to the renderer; expose one narrow function per operation [20].
- `official` — Validate the sender of all IPC messages through `event.senderFrame` and an origin allowlist [17].
- The full IPC contract, including runtime input parsing, lives in `rules/electron/processes-and-ipc.md`.

## 5. Secrets

- `official` — `safeStorage` runs in the main process only. In Electron 45 the synchronous `encryptString`/`decryptString`/`isEncryptionAvailable` are deprecated, and they are removed in 46: use `isAsyncEncryptionAvailable`, `encryptStringAsync`, and `decryptStringAsync`, and re-encrypt when the result reports `shouldReEncrypt`.
- `official` — On Linux the `basic_text` backend means a hardcoded password, not protection; check `getSelectedStorageBackend()` and report it. On macOS a stable code signature keeps the Keychain from re-prompting after each update.
- `hypercore-default` — Tokens and API keys stay in main, encrypted at rest with `safeStorage`; authenticated requests run from main with `net.fetch` (Chromium's network stack, proxy-aware) or from a utility process given the app `session`. The renderer receives data, never the token. Renderer `import.meta.env` values (`VITE_` or `RENDERER_VITE_` prefixes) are public build-time strings.

## 6. Fuses and package integrity

`official` — Fuses are flipped at package time, before code signing, with `@electron/fuses` or Forge's fuses plugin [19]. Hardened set:

| Fuse | Set to | Why |
|---|---|---|
| `RunAsNode` | off | blocks `ELECTRON_RUN_AS_NODE` turning the binary into Node |
| `EnableNodeOptionsEnvironmentVariable` | off | blocks `NODE_OPTIONS` injection |
| `EnableNodeCliInspectArguments` | off | blocks `--inspect` attach in production |
| `GrantFileProtocolExtraPrivileges` | off | the app is served from a custom protocol |
| `EnableCookieEncryption` | on | encrypts the cookie store (one-way; needs signing on macOS) |
| `EnableEmbeddedAsarIntegrityValidation` | on | terminates on a modified `app.asar` (macOS, and Windows from Electron 30) |
| `OnlyLoadAppFromAsar` | on | pair with integrity validation so only validated code loads |

- `official` — Turning `RunAsNode` off breaks `child_process.fork`; use `utilityProcess.fork`.
- `official` — Stay on a supported Electron major (the latest three) and upgrade one major at a time against the breaking-changes page [16].

## Review gate

Reject or correct the change when:

1. Any of `contextIsolation: false`, `sandbox: false`, `nodeIntegration: true`, `webSecurity: false`, `allowRunningInsecureContent`, `experimentalFeatures`, or `enableBlinkFeatures` appears without a recorded, accepted risk.
2. The production renderer loads through `file://` or `loadFile`, or the `protocol.handle` callback has no path-escape check.
3. No CSP is set, or it contains `unsafe-eval`, or `script-src` allows a remote origin the app does not need.
4. `will-navigate` or `setWindowOpenHandler` is missing, compares with a string prefix, or allows by default.
5. `shell.openExternal` receives an unparsed or unchecked URL.
6. A session that loads content has no permission request handler, or the handler grants everything.
7. A credential reaches renderer code, renderer storage, or a `VITE_`-prefixed variable, or the synchronous `safeStorage` API is used in new code.
8. A release build ships without the hardened fuse set, or flips fuses after signing.

## Sources

> Checked 2026-11-08 against the Electron 45 documentation set.

| Claim | Source |
|---|---|
| The 20-item checklist, its defaults, and sender validation | https://www.electronjs.org/docs/latest/tutorial/security |
| Sandbox default and `app.enableSandbox()` | https://www.electronjs.org/docs/latest/tutorial/sandbox |
| `registerSchemesAsPrivileged`, `protocol.handle`, the path-escape example, and the deprecated family | https://www.electronjs.org/docs/latest/api/protocol |
| `display-capture` replacing `media` for screen capture in 45 | https://www.electronjs.org/docs/latest/breaking-changes |
| Permission handlers and partitions | https://www.electronjs.org/docs/latest/api/session |
| `safeStorage` async API, deprecation, backends, and signing note | https://www.electronjs.org/docs/latest/api/safe-storage |
| `net.fetch` on Chromium's network stack | https://www.electronjs.org/docs/latest/api/net |
| Fuse names, defaults, and flipping before signing | https://www.electronjs.org/docs/latest/tutorial/fuses |
| ASAR integrity platforms and termination on mismatch | https://www.electronjs.org/docs/latest/tutorial/asar-integrity |
| `BrowserView` deprecated in favour of `WebContentsView` | https://www.electronjs.org/docs/latest/breaking-changes |
| Development versus production URL choice, a separate partition for remote content, and tokens kept in main | this package's convention, not an official Electron requirement |
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: 468kUpdated 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: 468kUpdated Claude CodeCodexVerifiedInstall
rea-tool-designmorluto/reaAudit, investigate, design, or change REA investigation tools, CLI/MCP contracts, provider capabilities, and Evidence semantics.Stars: 468kUpdated 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