메뉴
The AMC app shell — hooks.server.ts prerender-time head injection (SEO meta, theme-color, font preloads, icons), hooks.ts URL delocalization, and asset import suffixes (?no-inline, ?url). Read before changing global head tags, fonts, SEO metadata, or hooks.
Codex 또는 Claude로 설치 이 Prompt를 복사해 Codex, Claude 또는 다른 어시스턴트에 붙여 넣으면 Skill 페이지를 검토하고 설치를 진행할 수 있습니다.
SOC 직업 분류 기준
The pakop C#/.NET WASM module (CUE4Parse-based) — what it does (pak-file inspection/hashing), how to build it (pnpm build:pakop), and how to consume it (lazy dynamic import). Read before touching wasm/pakop or the pak routes.
How to fetch data in the AMC web app — the apiClient helper, visibility-aware polling / EventSource / WebSocket wrappers in src/lib/api/_api.ts, per-domain API modules, and protobuf decoding. Read before adding any network call.
High-level architecture of the AMC web app — SvelteKit static/SPA hybrid, Vite plugin pipeline, i18n strategy, WASM modules, dev-server proxies. Read before making structural or build-related changes.
Utility function conventions in the AMC web repo — es-toolkit for lodash-like helpers (lodash-es was removed), but check src/lib/utils first. Read before adding utility helpers.
Import path aliases ($lib, $messages) and workspace packages used in the AMC web repo. Read when writing imports or resolving where a module comes from.
Overlay/floating UI conventions in the AMC web repo — use the homegrown `portal` action from $lib/utils/portal (svelte-portal package is not used/dependency), as done in Tooltip and Modal. Read before building modals, tooltips, or popovers.
| name | app-shell |
| description | The AMC app shell — hooks.server.ts prerender-time head injection (SEO meta, theme-color, font preloads, icons), hooks.ts URL delocalization, and asset import suffixes (?no-inline, ?url). Read before changing global head tags, fonts, SEO metadata, or hooks. |
src/hooks.server.ts (runs at prerender/build time)Two handles in sequence:
handleParaglide — wraps requests in paraglideMiddleware, replacing %lang% and %dir% placeholders in app.html with the resolved locale and text direction.handleStaticHead — replaces the %app.statichead% placeholder in app.html with generated head tags:
theme-color metas for light/dark from $lib/tw-var (colorBackground100 / colorBackground900)m['home.desc_title'](), m.site_name())rel=preload as=style + onload swapGlobal head changes go here, not in +layout.svelte. Per-page head tags use <svelte:head> (see src/lib/components/CommonHead/).
?no-inline — force a file URL instead of base64 inlining (used for fonts, splash, favicons referenced in head strings)?url — import a CSS file's URL (used for deferred font stylesheets)src/hooks.ts (universal)reroute strips the locale prefix from URLs via paraglide's deLocalizeUrl, so route files never see locale segments.
Fonts are self-hosted via @fontsource packages (Noto Sans variants per script, Kanit, Koulen, Playfair Display, Great Vibes). src/lib/font-sans-em.ts holds alternative emphasis font and must only be import on component with font-sans-em class usage. The web app manifest is generated by the custom Vite plugin in vite-plugins/webmanifest.ts.
Related: [[architecture]], [[project-structure]]