Statement
Configuration values consumed by build-time plugins (rehype, remark) in astro.config.mjs shall be defined independently of site.ts, because Vite path aliases are not available during Astro config parsing. Site overrides affecting plugin behavior shall be synchronized in both astro.config.mjs and site.ts.
Rationale
Vite aliases resolve only after Astro config is loaded. Importing site.ts (which uses aliases) from astro.config.mjs would fail at startup. This dual-location constraint must be documented to prevent breakage when adding new build-time plugins. Delivered by PLN-11 (D-PLN11-05).
Topics
Owner: rendering-runtime
Applies To
- Architecture DOC-00020
- Image Lightbox DOC-00088