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/project-structure.md

View on GitHub
# Project Structure

> One folder per process, one shared contract folder, one build config with three blocks, and two tsconfig files that match the two runtimes.

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.

## 1. Target layout

```text
electron.vite.config.ts        main, preload, renderer blocks (or forge.config.ts + three vite.*.config.mts)
electron-builder.yml           packaging, when electron-builder is the packager
tsconfig.json                  references only
tsconfig.node.json             src/main, src/preload, src/shared — Node and Electron types
tsconfig.web.json              src/renderer, src/shared — DOM types, no Node types
resources/                     icons and files shipped outside app.asar (asarUnpack)
src/
  main/
    index.ts                   lifecycle only: single-instance lock, protocol, windows, registerIpc()
    windows/                   one file per window: BrowserWindow options, load URL, navigation guards
    ipc/                       one handler file per domain, plus sender.ts and index.ts (registerIpc)
    services/<domain>/         main-side domain logic the handlers call (store, fs, net, safeStorage)
    workers/                   utilityProcess entry points for long CPU or I/O work
  preload/
    index.ts                   contextBridge.exposeInMainWorld — the only file the renderer can reach
  shared/
    ipc/                       channels.ts, schemas.ts, api.ts (DesktopApi), result.ts
    types/                     domain types used across processes
  renderer/
    index.html
    src/
      main.tsx                 createRoot, QueryClientProvider, RouterProvider
      router.tsx               QueryClient, hash history, createRouter, Register
      main.css                 @import "tailwindcss"; @theme; @source
      routes/                  TanStack Router file routes (__root.tsx, index.tsx, …)
      routeTree.gen.ts         generated, never edited
      features/<domain>/       components, query options, hooks for one domain
      platform/desktop.ts      the only renderer file that reads window.desktop
      components/              shared UI with no IPC and no domain logic
      env.d.ts                 Window augmentation
```

- `official` — electron-vite's default entries are `src/main/index.ts`, `src/preload/index.ts`, and `src/renderer/index.html`, with the renderer root at `src/renderer`, so this layout needs no entry overrides. Electron Forge's `vite-typescript` template instead uses flat `src/main.ts`, `src/preload.ts`, `src/renderer.ts` with three `vite.*.config.mts` files; keep that shape in a Forge project and apply the same ownership rules to it.
- `hypercore-default` — Dependencies point inward to `shared`: `main` and `preload` and `renderer` may import `shared`; `shared` imports none of them; `renderer` never imports `main` or `preload` (type-only imports of `shared/ipc/api.ts` are the bridge contract). Features never import each other.
- `hypercore-default` — A small app may stay flatter (no `services/`, no `workers/`, no `features/`); do not scaffold empty layers. The process folders and `shared/ipc/` are not optional.
- `hypercore-default` — A multi-window app gives each window its own HTML entry under `src/renderer/` and its own file under `src/main/windows/`, all sharing the one preload contract unless a window needs a narrower one.

## 2. Build configuration

- `official` — `electron.vite.config.ts` has three blocks: `main`, `preload`, `renderer`. Renderer-only plugins (`@vitejs/plugin-react`, `@tailwindcss/vite`, `@tanstack/router-plugin/vite`) go in `renderer.plugins` only; a root-level plugin or a separate `vite.config.ts` does not reach the renderer build the way you expect.
- `official` — electron-vite's renderer preset sets `base: './'` in production, so emitted asset URLs are relative and resolve from whatever origin serves `index.html`.
- `official` — An electron-vite renderer exposes `RENDERER_VITE_` and `VITE_` prefixed variables, the preload `PRELOAD_VITE_`, and main `MAIN_VITE_`; all of them are inlined at build time and are not secrets.
- `official` — A sandboxed preload must be one CommonJS bundle. Bundle its dependencies instead of externalizing them (electron-vite's isolated build or the dependency-externalizing option turned off for the preload) and keep `sandbox: true`; turning the sandbox off to load an external module is not the fix.
- `hypercore-default` — Mirror one `@shared` alias in all three blocks and in both tsconfig files, so a shared module resolves identically in every bundle and in the type checker.
- `hypercore-default` — Choose one dev/prod URL convention per repository: electron-vite's `process.env.ELECTRON_RENDERER_URL`, or Forge's `MAIN_WINDOW_VITE_DEV_SERVER_URL` and `MAIN_WINDOW_VITE_NAME`. Mixing them leaves `undefined` URLs in production.

## 3. Starter templates are not a baseline

- `official` — The official electron-vite `react-ts` template sets `sandbox: false` and exposes `@electron-toolkit/preload`'s `electronAPI`, which includes raw `ipcRenderer.send`, `sendSync`, `invoke`, and `on`. It also loads production through `loadFile`.
- `hypercore-default` — A project scaffolded from that template keeps its layout but fixes the three points: `sandbox: true` with a bundled preload, a named-function preload instead of `electronAPI`, and a custom protocol instead of `loadFile`. Treat each as a `rules/electron/security.md` finding, not as an accepted default.
- `hypercore-default` — Before adopting a community starter, check its last push date and its Electron major; a starter pinned to an Electron major outside the supported three is a migration, not a baseline.

## 4. Generated and owned files

| Path | Owner | Rule |
|---|---|---|
| `src/renderer/src/routeTree.gen.ts` | `@tanstack/router-plugin` | regenerate, never edit; excluded from lint and format |
| `out/`, `dist/`, `release/` | electron-vite, electron-builder, Forge | build output, gitignored |
| `src/shared/ipc/*` | the team | every change compiles in all three tsconfig projects |
| `src/preload/index.ts` | the team | security review on every change |
| `electron-builder.yml`, `forge.config.ts` | the team | fuse and signing settings reviewed in `rules/electron/packaging.md` |

## Review gate

1. A renderer file imports from `src/main/`, `src/preload/`, `electron`, or `node:*`.
2. `src/shared/` imports a process-specific runtime.
3. A renderer plugin sits outside the renderer build block.
4. The preload is externalized or emitted as ESM while sandboxed, or `sandbox: false` was set to make a dependency load.
5. The type check runs one tsconfig over all processes, or the renderer tsconfig includes Node types.
6. Two dev/prod URL conventions coexist.

## Sources

> Checked 2026-11-08.

| Claim | Source |
|---|---|
| electron-vite default entries, renderer root, three config blocks, and env prefixes | https://electron-vite.org/guide/dev, https://electron-vite.org/guide/env-and-mode |
| Renderer `base: './'` in production | https://github.com/alex8088/electron-vite/blob/master/src/plugins/electron.ts |
| Isolated build as the prerequisite for a sandboxed single-bundle preload | https://electron-vite.org/guide/isolated-build |
| Sandboxed preload must be CommonJS | https://www.electronjs.org/docs/latest/tutorial/esm |
| The `react-ts` template's `sandbox: false`, `electronAPI`, and `loadFile` | https://github.com/alex8088/quick-start/tree/master/packages/create-electron/template, https://github.com/alex8088/electron-toolkit/blob/master/packages/preload/src/index.ts |
| Forge `vite-typescript` layout and injected URL constants | https://github.com/electron/forge/tree/main/packages/template/vite/tmpl, https://www.electronforge.io/config/plugins/vite |
| `src/shared` across processes and two tsconfig files as the common convention | surveyed projects: https://github.com/CherryHQ/cherry-studio, https://github.com/chatboxai/chatbox, https://github.com/alex8088/quick-start |
| The inward dependency rule, the `platform/desktop.ts` adapter, and the fix-the-template policy | 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