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/tanstack-start/tanstack-start-2026-11-04.ko.md

View on GitHub
# TanStack Start 공식 스냅샷

- last_verified_at: 2026-11-04
- next_re_verification: 2027-05-04 (또는 아래 Refresh Trigger가 먼저 발동하면 그때)
- packages_checked:
  - `@tanstack/react-start`: `1.169.4`
  - `@tanstack/start-client-core`: `1.170.39`
  - `@tanstack/start-server-core`: `1.169.45`
  - `@tanstack/start-plugin-core`: `1.171.55`
  - `@tanstack/router-plugin`: `1.168.48`
  - `@tanstack/router-cli`: `1.167.46`
  - `@tanstack/zod-adapter`: `1.167.0`
  - `@tanstack/cli`: `0.72.16`
  - `vite`: `8.3.6`
  - `zod`: `4.6.7`
  - `@tanstack/react-query`: `5.107.1`
- patch_checked_at: 2026-11-07 (`vite`와 `@tanstack/react-query`만. 나머지 행은 2026-11-04 확인값입니다)
- engines: `@tanstack/react-start@1.169.4`는 `node >=22.12.0`을, `peerDependencies.vite`는 `>=8.0.0`을 선언합니다
- source_priority: canonical guide pages > API/reference pages > examples > migration/comparison pages > release notes for drift context
- supersedes: 은퇴한 2026-09-22 Start 스냅샷(release candidate 시기)

Start-specific API behavior가 architecture rule에 영향을 줄 때 이 파일을 사용합니다. 아래 모든 사실에는 `Official` 라벨이 붙습니다. 즉 TanStack 자체 guide page, source tree, package metadata에서 온 내용입니다. Hypercore conventions는 `rules/tanstack-start/`에 두고 official facts는 여기에 둡니다.

## Contents

- [Corrected from the 2026-09-22 snapshot](#corrected-from-the-2026-09-22-snapshot)
- [Release status](#release-status)
- [Project structure](#project-structure)
- [Router setup](#router-setup)
- [Server functions](#server-functions)
- [Execution model](#execution-model)
- [Import protection](#import-protection)
- [Middleware](#middleware)
- [Server routes](#server-routes)
- [SSR, hydration, and rendering](#ssr-hydration-and-rendering)
- [Platform and tooling](#platform-and-tooling)
- [Refresh Triggers](#refresh-triggers)
- [Sources](#sources)

## Corrected from the 2026-09-22 snapshot

- **`.inputValidator(...)`는 폐기가 아니라 제거됐습니다.** 은퇴한 2026-09-22 스냅샷과 그 이전 2026-04-30 스냅샷은 이 별칭을 "폐기됐지만 런타임에서 계속 해석된다"고 기록했습니다. `@tanstack/react-start@1.169.0`이 `createServerFn`과 `createMiddleware` 양쪽에서 제거했고, `start-client-core@1.170.39`의 type 선언에는 `inputValidator`가 한 번도 나오지 않습니다. 남아 있는 호출은 깨진 코드입니다.
- **Start는 stable입니다.** 은퇴한 스냅샷은 Release Candidate 단계를 설명했지만, overview page는 이제 "TanStack Start is stable."로 시작합니다.
- **Vite 8은 필수입니다.** 은퇴한 스냅샷은 Vite 7을 지원 갈래로 다뤘습니다. Start 1.169+는 Vite 8을 요구합니다.
- 위 version 목록은 2026-11-04에 npm `latest` dist-tag에서 다시 측정했습니다.

## Release status

- Start overview page 원문입니다. "TanStack Start is stable. If you're upgrading from a release candidate, follow `Migrate from the Release Candidate`."
- `@tanstack/react-start` 1.169.0이 첫 stable release이고 2026-10-12에 게시됐습니다. migration page도 분명히 적습니다. "`@tanstack/react-start` 1.169 is the first stable release of TanStack Start." 현재 stable patch는 1.169.4(2026-10-22)입니다.
- Release candidate에서 올릴 때 제거되는 API입니다. `@tanstack/nitro-v2-vite-plugin`은 `nitro/vite`의 `nitro()`로, `useSession`은 iron-session 같은 session library로(새 library는 기존 Start session cookie를 읽을 수 없으므로 새 cookie 이름을 쓰거나 기존 cookie를 먼저 읽는 migration을 검증해야 합니다), `.inputValidator()`는 `.validator()`로 바뀝니다.
- Vite 8: "Start requires Vite 8 when you build with Vite." release note는 "Require Vite 8 for Vite builds. Vite 7 is no longer supported."라고 덧붙입니다.
- stable이 되어도 실험 단계로 남아 도입 근거가 되지 않는 표면입니다. Deferred hydration(`<Hydrate>`), static server functions, React Server Components.
- Sources:
  - <https://tanstack.com/start/latest/docs/framework/react/overview.md>
  - <https://tanstack.com/start/latest/docs/framework/react/migrate-from-release-candidate.md>
  - <https://github.com/TanStack/router/releases/tag/%40tanstack%2Freact-start%401.169.0>

## Project structure

- Start plugin은 `srcDirectory` 기본값을 `'src'`로 두고, routes directory는 `tanstackStart({ router: { routesDirectory } })`로 덮어쓰지 않는 한 `<srcDirectory>/routes`로 해석됩니다. 따라서 `src/routes`를 hard-code하지 말고 config에서 실제 route root를 도출합니다.
- 문서가 보여주는 typical shape는 `src/routes`, `src/router.tsx`, generated `src/routeTree.gen.ts`, `src/styles.css`, optional `src/types`, `public/`, root bundler config(`vite.config.ts` 또는 `rsbuild.config.ts`), `package.json`, `tsconfig.json`입니다.
- `routeTree.gen.ts`는 Router tooling이 생성합니다. Router FAQ는 이 파일을 커밋하라고 말합니다. "it is essentially part of your application's runtime, not a build artifact." file-based-routing API page는 생성된 path를 linter와 formatter에서 무시하도록 권고합니다. 손으로 고치지 않습니다(Hypercore convention).
- File organization: server-functions guide는 `*.functions.ts`(server function wrapper, 어디서든 import해도 안전) / `*.server.ts`(server-only helper) / 접미사 없는 `*.ts`(client-safe) 분리를 "one approach"로 제시할 뿐 의무로 두지 않습니다.
- `.functions.ts`는 import protection이 **강제하지 않습니다.** import-protection guide의 기본 file pattern은 `**/*.server.*`와 `**/*.client.*`뿐이고, `.functions.ts`는 server-functions guide의 file-organization 절에만 나옵니다.
- Router는 flat, directory, mixed route file 구조를 공식 지원합니다. route directory 선호는 로컬 관례이며 공식 TanStack 동작이 아닙니다(<https://tanstack.com/router/latest/docs/routing/file-based-routing>).
- Sources:
  - <https://tanstack.com/start/latest/docs/framework/react/guide/server-functions.md>
  - <https://tanstack.com/start/latest/docs/framework/react/guide/import-protection.md>
  - <https://tanstack.com/router/latest/docs/faq>
  - <https://tanstack.com/router/latest/docs/api/file-based-routing>
  - <https://raw.githubusercontent.com/TanStack/router/fe7f1fd0e6ef73c3f341dd2338b406749538a85d/packages/start-plugin-core/src/schema.ts>

## Router setup

- `src/router.tsx`는 호출할 때마다 새 router instance를 반환하는 `getRouter` function을 export해야 합니다. 공식 예시는 function declaration을 씁니다. `export function getRouter() { ... }`
- Search validation: Zod v4는 schema를 `validateSearch`에 직접 전달합니다. `@tanstack/zod-adapter`는 `peerDependencies`가 `zod: ^3.23.8`을 고정하므로 Zod v3 전용이고, Zod 4 프로젝트는 설치할 수 없습니다. Zod v3는 여전히 adapter의 `zodValidator` / `fallback`을 씁니다.
- Sources:
  - <https://tanstack.com/start/latest/docs/framework/react/guide/routing.md>
  - <https://tanstack.com/router/latest/docs/guide/search-params>
  - <https://tanstack.com/router/latest/docs/how-to/validate-search-params>
  - <https://registry.npmjs.org/@tanstack/zod-adapter/latest>

## Server functions

- `createServerFn()`이 server function을 정의합니다. `method` 기본값은 `'GET'`이고, `Method`는 정확히 `'GET' | 'POST'`입니다. 다른 verb는 없습니다(`packages/start-client-core/src/createServerFn.ts:449`, `:84-86`).
- `.validator(...)`가 유일한 표기입니다. `.inputValidator(...)`는 1.169.0에서 `createServerFn`과 `createMiddleware`에서 제거됐습니다. release note 원문은 "Remove the deprecated `.inputValidator()` from `createServerFn` and `createMiddleware`. Use `.validator()`, which takes the same validator,"이고, `start-client-core@1.170.39`의 선언에는 `inputValidator`가 전혀 없습니다.
- Zod schema는 `.validator(...)`에 직접 전달합니다. validator input type은 serializable해야 하고, `FormData`도 `POST` server function에서 허용됩니다.
- builder가 담는 validator는 **하나**입니다. `.validator(...)`는 그 하나를 설정하고(나중 호출이 앞 호출을 대체) `.middleware([...])`는 반복 호출이 가능하며 이전 middleware와 merge됩니다.
- `strict` 옵션이 있고 기본값은 `strict: true`입니다. TypeScript 수준 serialization 검사를 관장하며, `createServerFn({ strict: false })`와 세분화 형태 `strict: { input: false }` / `strict: { output: false }`로 opt out합니다. 문서는 `strict: false`가 type 검사만 완화한다고 경고합니다. 값은 여전히 runtime serialization layer가 제대로 처리해야 합니다.
- Server function은 same-origin app RPC endpoint입니다. loaders, components, hooks, 다른 server function, event handler에서 호출할 수 있고, hook ergonomics가 필요하면 `useServerFn()`을 씁니다.
- Sources:
  - <https://tanstack.com/start/latest/docs/framework/react/guide/server-functions.md>
  - <https://raw.githubusercontent.com/TanStack/router/fe7f1fd0e6ef73c3f341dd2338b406749538a85d/packages/start-client-core/src/createServerFn.ts>

## Execution model

- Start code는 기본적으로 isomorphic입니다. 명시적으로 제한하지 않으면 두 환경에서 실행되고 양쪽 bundle에 포함됩니다. route loader도 isomorphic이며 server-only가 아닙니다. SSR 중에는 server에서, client navigation 중에는 client에서 실행됩니다.
- Execution-control primitive는 `createServerFn`, `createServerOnlyFn`, `createClientOnlyFn`, `createIsomorphicFn`입니다.
- `createIsomorphicFn()`은 `.server(...)`와 `.client(...)`로 환경별 구현을 하나의 function에 합성합니다. 한쪽이 없으면 error가 아니라 `undefined`를 반환하는 no-op입니다. Environment function은 bundle별로 tree-shaken됩니다.
- `createServerOnlyFn(...)`과 `createClientOnlyFn(...)`은 환경에 묶인 실행을 강제하고, 잘못된 환경에서 호출하면 설명이 담긴 runtime error를 던집니다.
- Secrets, DB access, filesystem access, privileged SDK calls는 server-only 또는 server-function boundary 뒤에 있어야 합니다.
- Sources:
  - <https://tanstack.com/start/latest/docs/framework/react/guide/execution-model.md>
  - <https://tanstack.com/start/latest/docs/framework/react/guide/code-execution-patterns.md>
  - <https://tanstack.com/start/latest/docs/framework/react/guide/environment-functions.md>

## Import protection

- **Status: 문서화됨, Experimental 표시 없음.** 페이지는 "Import protection prevents server-only code from leaking into client bundles and client-only code from leaking into server bundles. It runs inside TanStack Start and is enabled by default."로 시작합니다. 문서화된 option surface는 `enabled`, `behavior`, `log`, `include`, `exclude`, `maxTraceDepth`, `client`/`server` rule(`files`, `specifiers`, `excludeFiles`), `ignoreImporters`, `onViolation`입니다.
- 기본 활성화입니다. 문서화된 기본값: `enabled: true`; `behavior: { dev: 'mock', build: 'error' }`; `log: 'once'`(반복 위반을 deduplicate); `include` = Start의 `srcDirectory`; `exclude: []`; `maxTraceDepth: 20`.
- 기본 deny rule: `client.files` = `['**/*.server.*']`, `server.files` = `['**/*.client.*']`, `client.specifiers` = framework server specifiers, `server.specifiers` = `[]`, 양쪽 `excludeFiles` = `['**/node_modules/**']`.
- **replace와 additive를 헷갈리는 것이 함정입니다.** option table 기준으로 `client.specifiers`는 **기본값에 additive**이고, `client.files`, `client.excludeFiles`, `server.files`, `server.specifiers`, `server.excludeFiles`는 기본값을 **replace**합니다. `excludeFiles`는 `['**/node_modules/**']`를 **완전히 replace**하므로, `node_modules`를 계속 건너뛰면서 경로를 더 제외하려면 둘 다 넘깁니다. `client.files`를 `'**/*.server.*'` 없이 설정하면 기본 deny rule이 조용히 사라집니다.
- Type-only import와 re-export는 런타임에 지워지므로 무시됩니다. mixed import는 runtime 값을 하나라도 담으면 여전히 검사 대상입니다.
- 명시적 boundary를 위한 side-effect marker import는 그대로 쓸 수 있습니다. `@tanstack/react-start/server-only`와 `@tanstack/react-start/client-only`입니다.
- `mockAccess`(`'error' | 'warn' | 'off'`)는 `@tanstack/start-plugin-core@1.171.55`의 `schema.d.ts`에 있지만 **import-protection guide에는 없습니다.** 실제로 존재하되 문서화되지 않은 schema option이므로, 인용할 때는 그렇게 라벨하고 문서화된 옵션처럼 제시하지 않습니다.
- dev mode 위반은 오탐일 수 있습니다. build mode는 tree-shaking 뒤까지 검사를 미루므로 production graph에서 사라지는 import가 dev에서 경고로 남을 수 있습니다. boundary를 고치기 전에 build로 확인합니다.
- Sources:
  - <https://tanstack.com/start/latest/docs/framework/react/guide/import-protection.md>
  - <https://raw.githubusercontent.com/TanStack/router/fe7f1fd0e6ef73c3f341dd2338b406749538a85d/packages/start-plugin-core/src/schema.ts>

## Middleware

- Middleware type은 둘입니다. **Request middleware**는 모든 server request를 customize하고, **server function middleware**는 그 부분집합으로서 input validation과 client-side logic처럼 server function 전용 기능을 더합니다. Request middleware는 `createMiddleware()`(또는 `createMiddleware({ type: 'request' })`)를, server function middleware는 `createMiddleware({ type: 'function' })`를 씁니다.
- Middleware input validation도 `.validator(...)`를 씁니다. 같은 1.169.0 release에서 `inputValidator`가 `createMiddleware`에서 제거됐습니다.
- `sendContext`는 명시적이고 hop마다 단방향입니다. Client context는 기본적으로 server에 전송되지 않고 `next({ sendContext: {...} })`로 넘겨야 합니다. Client가 보낼 수 있는 값은 client가 거짓으로 만들 수 있습니다.
- **"Shape validation is not authorization."** 파싱된 UUID나 number는 잘 형성된 identifier일 뿐 authorized identifier가 아닙니다. 그 값이 어떤 row를 읽거나 쓸지 고르는 경우(query key, filter, path parameter)에는 session principal의 접근 권한을 따로 검증해야 합니다. 그렇지 않으면 로그인한 사용자가 자기 요청에서 값을 바꿔 다른 tenant의 data에 닿습니다.
- 문서가 요구하는 패턴입니다. "Always derive the session itself from a server-trusted source (a cookie + DB lookup in `authMiddleware`), never from `sendContext`."
- **CSRF.** `createCsrfMiddleware()`가 server function을 cross-site request에서 보호합니다. guide의 설치 예시는 filter를 함께 씁니다. `createCsrfMiddleware({ filter: (ctx) => ctx.handlerType === 'serverFn' })`이고, 이유는 "by default, `createCsrfMiddleware()` validates every request handled by the middleware"입니다. `Sec-Fetch-Site`, `Origin`, `Referer`를 검사하고 same-origin임을 증명할 수 없는 request를 거부하며, 세 header를 모두 싣지 않은 request는 `allowRequestsWithoutOriginCheck: true`가 아니면 거부합니다. type 표면(`createCsrfMiddleware.d.ts`)은 `filter`, `origin`, `secFetchSite`(기본 `'same-origin'`), `referer`(기본 `true`), `allowRequestsWithoutOriginCheck`(기본 `false`), `failureResponse`(기본 `403 Forbidden`)입니다. guide가 문서화한 것은 `filter`, `origin`, `allowRequestsWithoutOriginCheck`이고 나머지 셋은 type 수준 사실입니다.
- **CSRF 함정:** app이 `src/start.ts`를 정의하지 않으면 Start가 server function용 CSRF middleware를 자동으로 설치합니다. `src/start.ts`를 정의하는 순간 그 자동 설치가 조용히 사라지므로, 그 파일이 CSRF middleware를 직접 추가해야 합니다. `src/start.ts`가 있는데 이 middleware가 없으면 Start가 server function request에 대해 development warning을 기록합니다. CSRF를 다른 방식으로 처리하는 app은 `serverFns.disableCsrfMiddlewareWarning: true`로 그 warning을 끕니다.
- Sources:
  - <https://tanstack.com/start/latest/docs/framework/react/guide/middleware.md>
  - <https://tanstack.com/start/latest/docs/framework/react/guide/server-functions.md>
  - <https://raw.githubusercontent.com/TanStack/router/fe7f1fd0e6ef73c3f341dd2338b406749538a85d/packages/start-client-core/src/createCsrfMiddleware.ts>
  - <https://raw.githubusercontent.com/TanStack/router/fe7f1fd0e6ef73c3f341dd2338b406749538a85d/packages/start-client-core/src/createMiddleware.ts>
  - <https://raw.githubusercontent.com/TanStack/router/fe7f1fd0e6ef73c3f341dd2338b406749538a85d/packages/start-plugin-core/src/schema.ts>

## Server routes

- Server route는 route file의 `createFileRoute(...)(...)` 호출에 `server`를 더해 선언하고, Router의 file-based routing 관례를 따릅니다.
- `handlers`는 HTTP method를 handler function에 매핑한 object이거나, middleware 구성을 직접 해야 하는 handler를 위해 `createHandlers`를 받는 function입니다. 선택적인 route-level `middleware` 배열은 모든 handler에 적용되고 handler별 middleware보다 먼저 실행됩니다.
- Pathless layout route와 break-out route로 server route middleware를 묶을 수 있습니다. Pathless layout은 route 묶음에 middleware를 더하고, break-out route는 parent middleware에서 빠져나옵니다.
- GET과 POST를 넘어 `PUT`, `PATCH`, `DELETE`도 server route에서 지원됩니다.
- Source: <https://tanstack.com/start/latest/docs/framework/react/guide/server-routes.md>

## SSR, hydration, and rendering

- 초기 request에 match되는 route는 기본적으로 server에서 render됩니다. route별 `ssr` 기본값은 `true`이고, `createStart({ defaultSsr: false })`가 그 기본값을 바꿉니다.
- Hydration mismatch는 `Intl` locale/time-zone 차이, `Date.now()`, random ID, responsive-only logic, feature flag, user preference에서 옵니다. 문서가 제시하는 해법은 cookie(우선)나 `Accept-Language` header로 server에서 한 번 계산해 그것을 initial state로 hydrate하는 것입니다.
- **Deferred hydration은 experimental입니다.** `<Hydrate>`와 `@tanstack/react-start/hydration`에서 import하는 strategy를 씁니다.
- ISR을 쓸 수 있습니다. Static prerendering에 표준 HTTP cache header와 revalidation을 더한 방식이며, 의도적으로 CDN에 종속되지 않습니다.
- Sources:
  - <https://tanstack.com/start/latest/docs/framework/react/guide/selective-ssr.md>
  - <https://tanstack.com/start/latest/docs/framework/react/guide/hydration-errors.md>
  - <https://tanstack.com/start/latest/docs/framework/react/guide/deferred-hydration.md>
  - <https://tanstack.com/start/latest/docs/framework/react/guide/isr.md>

## Platform and tooling

- 공식 bundler는 둘입니다. Vite(기본)와 **Rsbuild**이며, Rsbuild는 `rsbuild.config.ts`에서 `@tanstack/react-start/plugin/rsbuild`로 import합니다. Rsbuild production build는 client asset을 `dist/client`에, server bundle을 `dist/server/index.js`에 냅니다.
- `autoCodeSplitting`은 기본값 `false`인 bundler-plugin option입니다(v2에서는 `true`가 기본이 될 예정). Start plugin의 config schema는 이를 제외하므로(`configSchema.omit({ autoCodeSplitting: true, target: true })`) `tanstackStart()`를 통해 **전달할 수 없습니다.**
- Client에 노출되는 environment variable은 build tool의 public prefix를 씁니다. Vite는 `VITE_`, Rsbuild는 `PUBLIC_`입니다.
- `src/server.ts`는 선택적인 server entry point이고 fetch 형태의 `ServerEntry`를 씁니다. 없으면 Start가 기본값을 공급합니다. `createStartHandler(...)`가 반환한 handler는 이제 원래 error를 다시 던집니다. `createServerEntry`가 error를 response로 바꾸고 built-in entry는 이미 그것을 씁니다. `handleStartError(error)`는 helper state를 적용한 Start error response를 만듭니다. `@tanstack/react-router`의 `Register` interface에 `server.requestContext`를 등록하면 `handler.fetch(request, { context })`로 넘기는 context에 type이 붙습니다.
- Nitro hosting은 `nitro/vite`의 `nitro()`를 씁니다. `@tanstack/nitro-v2-vite-plugin`은 제거됐습니다. 공식 partner는 Cloudflare(`@cloudflare/vite-plugin` + `wrangler`), Netlify(`@netlify/vite-plugin-tanstack-start`), Railway(Nitro 경유)입니다.
- Static server function은 **experimental입니다**(`@tanstack/start-static-server-functions`의 `staticFunctionMiddleware`).
- Scaffolding은 `npx @tanstack/cli@latest create`(`@tanstack/cli` `0.71.0`) 또는 TanStack Builder입니다. Legacy alias `create-tsrouter-app`, `create-start-app`, `create-tanstack-app`, `create-tanstack`, `@tanstack/create-start`는 deprecation warning을 출력합니다.
- Sources:
  - <https://tanstack.com/start/latest/docs/framework/react/guide/hosting.md>
  - <https://tanstack.com/start/latest/docs/framework/react/guide/environment-variables.md>
  - <https://tanstack.com/start/latest/docs/framework/react/guide/server-entry-point.md>
  - <https://tanstack.com/start/latest/docs/framework/react/guide/static-server-functions.md>
  - <https://raw.githubusercontent.com/TanStack/router/fe7f1fd0e6ef73c3f341dd2338b406749538a85d/packages/start-plugin-core/src/schema.ts>

## Refresh Triggers

다음 경우 이 snapshot을 refresh합니다.

- Sources 아래에 나열한 Start guide page가 본문, option table, 문서화된 기본값을 바꿀 때.
- 이 skill이 의존하는 Start guide page가 이름을 바꾸거나 사라지거나 새 page로 대체될 때.
- security advisory가 pinned package에 영향을 줄 때. 저장소 advisory(`gh api repos/TanStack/router/security-advisories`)와 npm advisory database를 확인합니다. 선례: advisory `GHSA-g7cv-rxg3-hmpx`(2026-05-11)는 42개 `@tanstack/*` package의 악성 version을 공표했습니다. 따라서 advisory 확인은 모든 재검증 pass에 들어갑니다.
- Start가 새 major를 발표하거나 stable line의 최소 Vite/Node 하한을 바꿀 때.

**이 trigger를 version number만으로 걸지 않습니다.** Router와 Start는 `1.x`에 머물면서 patch release에서도 breaking change를 흡수합니다. `@tanstack/react-router` 1.170.41부터 1.170.46까지는 내부 composition과 link hydration 변경, agent skill 배포뿐이어서 version bump가 잡아낼 동작 변화가 없습니다. 반대로 `@tanstack/react-start@1.169.0`은 평범한 minor처럼 보이지만 `useSession`과 `.inputValidator()`를 제거했습니다. 그래서 version 기반 trigger는 과하게도, 모자라게도 발동합니다. 위 version 목록은 2026-11-04에 무엇을 측정했는지 남기는 provenance 기록이지 trigger가 아닙니다.

## Sources

> 출처 확인 2026-11-04. 이 snapshot이 검증 날짜로 기록한 날짜이며, 파일 이름의 날짜와 그 기록은 구조상 일치합니다. 아래 출처는 모두 2026-11-04에 이 snapshot을 위해 가져왔습니다. `guide/` path segment는 필수이고, 같은 page에서 이 segment를 빼면 404가 납니다. 인용한 line number는 이전에 가져온 사본에서의 위치이므로 page가 바뀌면 함께 이동합니다. 안정된 기준은 인용문 자체입니다. 위 목록 밖의 출처는 주장하지 않습니다.

- <https://tanstack.com/start/latest/docs/framework/react/overview.md>
- <https://tanstack.com/start/latest/docs/framework/react/migrate-from-release-candidate.md>
- <https://tanstack.com/start/latest/docs/framework/react/guide/routing.md>
- <https://tanstack.com/start/latest/docs/framework/react/guide/server-functions.md>
- <https://tanstack.com/start/latest/docs/framework/react/guide/environment-functions.md>
- <https://tanstack.com/start/latest/docs/framework/react/guide/middleware.md>
- <https://tanstack.com/start/latest/docs/framework/react/guide/server-routes.md>
- <https://tanstack.com/start/latest/docs/framework/react/guide/import-protection.md>
- <https://tanstack.com/start/latest/docs/framework/react/guide/code-execution-patterns.md>
- <https://tanstack.com/start/latest/docs/framework/react/guide/execution-model.md>
- <https://tanstack.com/start/latest/docs/framework/react/guide/selective-ssr.md>
- <https://tanstack.com/start/latest/docs/framework/react/guide/hydration-errors.md>
- <https://tanstack.com/start/latest/docs/framework/react/guide/deferred-hydration.md>
- <https://tanstack.com/start/latest/docs/framework/react/guide/isr.md>
- <https://tanstack.com/start/latest/docs/framework/react/guide/environment-variables.md>
- <https://tanstack.com/start/latest/docs/framework/react/guide/hosting.md>
- <https://tanstack.com/start/latest/docs/framework/react/guide/server-entry-point.md>
- <https://tanstack.com/start/latest/docs/framework/react/guide/static-server-functions.md>
- <https://tanstack.com/router/latest/docs/faq>
- <https://tanstack.com/router/latest/docs/api/file-based-routing>
- <https://tanstack.com/router/latest/docs/routing/file-based-routing>
- <https://tanstack.com/router/latest/docs/guide/search-params>
- <https://tanstack.com/router/latest/docs/how-to/validate-search-params>
- <https://registry.npmjs.org/@tanstack/zod-adapter/latest>
- <https://raw.githubusercontent.com/TanStack/router/fe7f1fd0e6ef73c3f341dd2338b406749538a85d/packages/start-client-core/src/createServerFn.ts>
- <https://raw.githubusercontent.com/TanStack/router/fe7f1fd0e6ef73c3f341dd2338b406749538a85d/packages/start-client-core/src/createMiddleware.ts>
- <https://raw.githubusercontent.com/TanStack/router/fe7f1fd0e6ef73c3f341dd2338b406749538a85d/packages/start-client-core/src/createStart.ts>
- <https://raw.githubusercontent.com/TanStack/router/fe7f1fd0e6ef73c3f341dd2338b406749538a85d/packages/start-client-core/src/createCsrfMiddleware.ts>
- <https://raw.githubusercontent.com/TanStack/router/fe7f1fd0e6ef73c3f341dd2338b406749538a85d/packages/start-plugin-core/src/schema.ts>
- <https://registry.npmjs.org/@tanstack/react-start/latest>
- <https://github.com/TanStack/router/releases/tag/%40tanstack%2Freact-start%401.169.0>
- <https://github.com/TanStack/router/security/advisories/GHSA-g7cv-rxg3-hmpx>
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: 470kUpdated 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: 470kUpdated Claude CodeCodexVerifiedInstall
rea-tool-designmorluto/reaAudit, investigate, design, or change REA investigation tools, CLI/MCP contracts, provider capabilities, and Evidence semantics.Stars: 470kUpdated 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