[{"data":1,"prerenderedAt":484},["ShallowReactive",2],{"navigation_docs":3,"rule-content-\u002Fnuxt\u002Frules\u002Fconfig\u002Fno-runtime-env-in-build-options":48},[4,8,12,16,20,24,28,32,36,40,44],{"title":5,"path":6,"stem":7},"CLI","\u002Fcli","1.cli",{"title":9,"path":10,"stem":11},"Nuxt","\u002Fnuxt","2.nuxt",{"title":13,"path":14,"stem":15},"Vue","\u002Fvue","3.vue",{"title":17,"path":18,"stem":19},"Vite","\u002Fvite","4.vite",{"title":21,"path":22,"stem":23},"Nitro","\u002Fnitro","5.nitro",{"title":25,"path":26,"stem":27},"TypeScript","\u002Ftypescript","6.typescript",{"title":29,"path":30,"stem":31},"shadcn","\u002Fshadcn","7.shadcn",{"title":33,"path":34,"stem":35},"Package","\u002Fpackage","8.package",{"title":37,"path":38,"stem":39},"Extending Doctor","\u002Fextending","9.extending",{"title":41,"path":42,"stem":43},"MCP","\u002Fmcp","9.mcp",{"title":45,"path":46,"stem":47},"Pinia","\u002Fpinia","9.pinia",{"id":49,"title":50,"body":51,"category":57,"description":472,"diagnosticCodes":473,"docsUrl":59,"extension":474,"fix":60,"framework":475,"meta":476,"navigation":477,"pack":61,"path":479,"recommendedReplacement":480,"ruleId":62,"seo":481,"severity":63,"source":64,"sourceUrl":65,"stem":482,"why":110,"__hash__":483},"rules\u002Fnuxt\u002Frules\u002Fconfig\u002Fno-runtime-env-in-build-options.md","Do not freeze runtime config environment variables into build options",{"type":52,"value":53,"toc":463},"minimark",[54,66,71,103,107,111,115,122,126,138,142,147,150,284,287,459],[55,56],"rule-metadata",{"category":57,"diagnosticCodes":58,"docsUrl":59,"fix":60,"pack":61,"ruleId":62,"severity":63,"source":64,"sourceUrl":65},"runtime-config","NUXT0090","https:\u002F\u002Fnuxt.com\u002Fdocs\u002F4.x\u002Fguide\u002Fgoing-further\u002Fruntime-config#environment-variables","suggestion","vite-doctor\u002Fnuxt","nuxt\u002Fconfig\u002Fno-runtime-env-in-build-options","warn","src\u002Frule-packs\u002Fnuxt\u002Frules\u002Fnuxt\u002Fno-runtime-env-in-build-options.ts","https:\u002F\u002Fgithub.com\u002Fonmax\u002Fvite-doctor\u002Fblob\u002Fmain\u002Fsrc\u002Frule-packs\u002Fnuxt\u002Frules\u002Fnuxt\u002Fno-runtime-env-in-build-options.ts",[67,68,70],"h2",{"id":69},"run-this-rule","Run this rule",[72,73,78],"pre",{"className":74,"code":75,"language":76,"meta":77,"style":77},"language-bash shiki shiki-themes material-theme-lighter material-theme material-theme-palenight","pnpm nuxt doctor --rules nuxt\u002Fconfig\u002Fno-runtime-env-in-build-options\n","bash","",[79,80,81],"code",{"__ignoreMap":77},[82,83,86,90,94,97,100],"span",{"class":84,"line":85},"line",1,[82,87,89],{"class":88},"sBMFI","pnpm",[82,91,93],{"class":92},"sfazB"," nuxt",[82,95,96],{"class":92}," doctor",[82,98,99],{"class":92}," --rules",[82,101,102],{"class":92}," nuxt\u002Fconfig\u002Fno-runtime-env-in-build-options\n",[67,104,106],{"id":105},"why-it-matters","Why it matters",[108,109,110],"p",{},"nuxt.config runs once, when the app is built, so every option outside runtimeConfig keeps the value the variable had at build time. Nuxt applies NUXT_ variables to runtimeConfig again when the server starts, which is why they are the usual way to configure one build per environment or tenant. An option that reads the same variable gets the build-time value instead, often empty in a Docker build that sets the variable only on the running container. Doctor only reports values whose environment reads are all NUXT_ or NITRO_ variables and at least one of them matches a key declared in runtimeConfig. A fallback to a variable without a NUXT_ or NITRO_ prefix, or passing process.env as a whole, is treated as an intentional build-time source.",[67,112,114],{"id":113},"recommended-fix","Recommended fix",[108,116,117,118,121],{},"Read the value from ",[79,119,120],{},"useRuntimeConfig()"," where it is used, or set the variable in the build environment when the option has to be fixed at build time.",[67,123,125],{"id":124},"useful-links","Useful links",[127,128,129],"ul",{},[130,131,132],"li",{},[133,134,137],"a",{"href":59,"rel":135},[136],"nofollow","Rule reference",[67,139,141],{"id":140},"example","Example",[143,144,146],"h3",{"id":145},"read-tenant-config-at-runtime","Read tenant config at runtime",[108,148,149],{},"Before",[72,151,155],{"className":152,"code":153,"language":154,"meta":77,"style":77},"language-ts shiki shiki-themes material-theme-lighter material-theme material-theme-palenight","const organization = process.env.NUXT_PUBLIC_ORGANIZATION_CODE\n\nexport default defineNuxtConfig({\n  runtimeConfig: { public: { organizationCode: organization } },\n  piniaPluginPersistedstate: { key: `${organization}:%id` },\n})\n","ts",[79,156,157,185,192,212,245,276],{"__ignoreMap":77},[82,158,159,163,167,171,174,177,180,182],{"class":84,"line":85},[82,160,162],{"class":161},"spNyl","const",[82,164,166],{"class":165},"sTEyZ"," organization ",[82,168,170],{"class":169},"sMK4o","=",[82,172,173],{"class":165}," process",[82,175,176],{"class":169},".",[82,178,179],{"class":165},"env",[82,181,176],{"class":169},[82,183,184],{"class":165},"NUXT_PUBLIC_ORGANIZATION_CODE\n",[82,186,188],{"class":84,"line":187},2,[82,189,191],{"emptyLinePlaceholder":190},true,"\n",[82,193,195,199,202,206,209],{"class":84,"line":194},3,[82,196,198],{"class":197},"s7zQu","export",[82,200,201],{"class":197}," default",[82,203,205],{"class":204},"s2Zo4"," defineNuxtConfig",[82,207,208],{"class":165},"(",[82,210,211],{"class":169},"{\n",[82,213,215,219,222,225,228,230,232,235,237,239,242],{"class":84,"line":214},4,[82,216,218],{"class":217},"swJcz","  runtimeConfig",[82,220,221],{"class":169},":",[82,223,224],{"class":169}," {",[82,226,227],{"class":217}," public",[82,229,221],{"class":169},[82,231,224],{"class":169},[82,233,234],{"class":217}," organizationCode",[82,236,221],{"class":169},[82,238,166],{"class":165},[82,240,241],{"class":169},"}",[82,243,244],{"class":169}," },\n",[82,246,248,251,253,255,258,260,263,266,268,271,274],{"class":84,"line":247},5,[82,249,250],{"class":217},"  piniaPluginPersistedstate",[82,252,221],{"class":169},[82,254,224],{"class":169},[82,256,257],{"class":217}," key",[82,259,221],{"class":169},[82,261,262],{"class":169}," `${",[82,264,265],{"class":165},"organization",[82,267,241],{"class":169},[82,269,270],{"class":92},":%id",[82,272,273],{"class":169},"`",[82,275,244],{"class":169},[82,277,279,281],{"class":84,"line":278},6,[82,280,241],{"class":169},[82,282,283],{"class":165},")\n",[108,285,286],{},"After",[72,288,290],{"className":152,"code":289,"language":154,"meta":77,"style":77},"export default defineNuxtConfig({\n  runtimeConfig: { public: { organizationCode: '' } },\n})\n\n\u002F\u002F app\u002Fplugins\u002Fpersisted-state.ts\nexport default defineNuxtPlugin(({ $pinia }) => {\n  const { organizationCode } = useRuntimeConfig().public\n  $pinia.use(createPersistedState({ key: id => `${organizationCode}:${id}` }))\n})\n",[79,291,292,304,330,336,340,346,373,399,452],{"__ignoreMap":77},[82,293,294,296,298,300,302],{"class":84,"line":85},[82,295,198],{"class":197},[82,297,201],{"class":197},[82,299,205],{"class":204},[82,301,208],{"class":165},[82,303,211],{"class":169},[82,305,306,308,310,312,314,316,318,320,322,325,328],{"class":84,"line":187},[82,307,218],{"class":217},[82,309,221],{"class":169},[82,311,224],{"class":169},[82,313,227],{"class":217},[82,315,221],{"class":169},[82,317,224],{"class":169},[82,319,234],{"class":217},[82,321,221],{"class":169},[82,323,324],{"class":169}," ''",[82,326,327],{"class":169}," }",[82,329,244],{"class":169},[82,331,332,334],{"class":84,"line":194},[82,333,241],{"class":169},[82,335,283],{"class":165},[82,337,338],{"class":84,"line":214},[82,339,191],{"emptyLinePlaceholder":190},[82,341,342],{"class":84,"line":247},[82,343,345],{"class":344},"sHwdD","\u002F\u002F app\u002Fplugins\u002Fpersisted-state.ts\n",[82,347,348,350,352,355,357,360,364,367,370],{"class":84,"line":278},[82,349,198],{"class":197},[82,351,201],{"class":197},[82,353,354],{"class":204}," defineNuxtPlugin",[82,356,208],{"class":165},[82,358,359],{"class":169},"({",[82,361,363],{"class":362},"sHdIc"," $pinia",[82,365,366],{"class":169}," })",[82,368,369],{"class":161}," =>",[82,371,372],{"class":169}," {\n",[82,374,376,379,381,383,385,388,391,394,396],{"class":84,"line":375},7,[82,377,378],{"class":161},"  const",[82,380,224],{"class":169},[82,382,234],{"class":165},[82,384,327],{"class":169},[82,386,387],{"class":169}," =",[82,389,390],{"class":204}," useRuntimeConfig",[82,392,393],{"class":217},"()",[82,395,176],{"class":169},[82,397,398],{"class":165},"public\n",[82,400,402,405,407,410,412,415,417,420,422,424,427,429,431,434,436,438,441,444,447,449],{"class":84,"line":401},8,[82,403,404],{"class":165},"  $pinia",[82,406,176],{"class":169},[82,408,409],{"class":204},"use",[82,411,208],{"class":217},[82,413,414],{"class":204},"createPersistedState",[82,416,208],{"class":217},[82,418,419],{"class":169},"{",[82,421,257],{"class":204},[82,423,221],{"class":169},[82,425,426],{"class":362}," id",[82,428,369],{"class":161},[82,430,262],{"class":169},[82,432,433],{"class":165},"organizationCode",[82,435,241],{"class":169},[82,437,221],{"class":92},[82,439,440],{"class":169},"${",[82,442,443],{"class":165},"id",[82,445,446],{"class":169},"}`",[82,448,327],{"class":169},[82,450,451],{"class":217},"))\n",[82,453,455,457],{"class":84,"line":454},9,[82,456,241],{"class":169},[82,458,283],{"class":165},[460,461,462],"style",{},"html pre.shiki code .sBMFI, html code.shiki .sBMFI{--shiki-light:#E2931D;--shiki-default:#FFCB6B;--shiki-dark:#FFCB6B}html pre.shiki code .sfazB, html code.shiki .sfazB{--shiki-light:#91B859;--shiki-default:#C3E88D;--shiki-dark:#C3E88D}html .light .shiki span {color: var(--shiki-light);background: var(--shiki-light-bg);font-style: var(--shiki-light-font-style);font-weight: var(--shiki-light-font-weight);text-decoration: var(--shiki-light-text-decoration);}html.light .shiki span {color: var(--shiki-light);background: var(--shiki-light-bg);font-style: var(--shiki-light-font-style);font-weight: var(--shiki-light-font-weight);text-decoration: var(--shiki-light-text-decoration);}html .default .shiki span {color: var(--shiki-default);background: var(--shiki-default-bg);font-style: var(--shiki-default-font-style);font-weight: var(--shiki-default-font-weight);text-decoration: var(--shiki-default-text-decoration);}html .shiki span {color: var(--shiki-default);background: var(--shiki-default-bg);font-style: var(--shiki-default-font-style);font-weight: var(--shiki-default-font-weight);text-decoration: var(--shiki-default-text-decoration);}html .dark .shiki span {color: var(--shiki-dark);background: var(--shiki-dark-bg);font-style: var(--shiki-dark-font-style);font-weight: var(--shiki-dark-font-weight);text-decoration: var(--shiki-dark-text-decoration);}html.dark .shiki span {color: var(--shiki-dark);background: var(--shiki-dark-bg);font-style: var(--shiki-dark-font-style);font-weight: var(--shiki-dark-font-weight);text-decoration: var(--shiki-dark-text-decoration);}html pre.shiki code .spNyl, html code.shiki .spNyl{--shiki-light:#9C3EDA;--shiki-default:#C792EA;--shiki-dark:#C792EA}html pre.shiki code .sTEyZ, html code.shiki .sTEyZ{--shiki-light:#90A4AE;--shiki-default:#EEFFFF;--shiki-dark:#BABED8}html pre.shiki code .sMK4o, html code.shiki .sMK4o{--shiki-light:#39ADB5;--shiki-default:#89DDFF;--shiki-dark:#89DDFF}html pre.shiki code .s7zQu, html code.shiki .s7zQu{--shiki-light:#39ADB5;--shiki-light-font-style:italic;--shiki-default:#89DDFF;--shiki-default-font-style:italic;--shiki-dark:#89DDFF;--shiki-dark-font-style:italic}html pre.shiki code .s2Zo4, html code.shiki .s2Zo4{--shiki-light:#6182B8;--shiki-default:#82AAFF;--shiki-dark:#82AAFF}html pre.shiki code .swJcz, html code.shiki .swJcz{--shiki-light:#E53935;--shiki-default:#F07178;--shiki-dark:#F07178}html pre.shiki code .sHwdD, html code.shiki .sHwdD{--shiki-light:#90A4AE;--shiki-light-font-style:italic;--shiki-default:#546E7A;--shiki-default-font-style:italic;--shiki-dark:#676E95;--shiki-dark-font-style:italic}html pre.shiki code .sHdIc, html code.shiki .sHdIc{--shiki-light:#90A4AE;--shiki-light-font-style:italic;--shiki-default:#EEFFFF;--shiki-default-font-style:italic;--shiki-dark:#BABED8;--shiki-dark-font-style:italic}",{"title":77,"searchDepth":187,"depth":187,"links":464},[465,466,467,468,469],{"id":69,"depth":187,"text":70},{"id":105,"depth":187,"text":106},{"id":113,"depth":187,"text":114},{"id":124,"depth":187,"text":125},{"id":140,"depth":187,"text":141,"children":470},[471],{"id":145,"depth":194,"text":146},"Finds nuxt.config options outside runtimeConfig whose value comes from a NUXT_ or NITRO_ environment variable that also overrides a declared runtimeConfig key.",[58],"md","nuxt",{},{"title":478},"Build-time env","\u002Fnuxt\u002Frules\u002Fconfig\u002Fno-runtime-env-in-build-options","Read the value from useRuntimeConfig() where it is used, or set the variable in the build environment when the option has to be fixed at build time.",{"title":50,"description":472},"nuxt\u002Frules\u002Fconfig\u002Fno-runtime-env-in-build-options","sI0MVJPrEySq-3PRuzrKbKdn_sBLkfLZLOOdI758-S4",1795268801058]