[{"data":1,"prerenderedAt":450},["ShallowReactive",2],{"navigation_docs":3,"rule-content-\u002Fnuxt\u002Frules\u002Fssr\u002Frequire-init-on-mounted-storage":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":438,"diagnosticCodes":439,"docsUrl":59,"extension":440,"fix":60,"framework":441,"meta":442,"navigation":443,"pack":61,"path":445,"recommendedReplacement":446,"ruleId":62,"seo":447,"severity":63,"source":64,"sourceUrl":65,"stem":448,"why":110,"__hash__":449},"rules\u002Fnuxt\u002Frules\u002Fssr\u002Frequire-init-on-mounted-storage.md","Initialize VueUse browser storage on mount in SSR apps",{"type":52,"value":53,"toc":429},"minimark",[54,66,71,103,107,111,115,144,148,160,164,169,172,307,310,425],[55,56],"rule-metadata",{"category":57,"diagnosticCodes":58,"docsUrl":59,"fix":60,"pack":61,"ruleId":62,"severity":63,"source":64,"sourceUrl":65},"hydration","NUXT0085","https:\u002F\u002Fvueuse.org\u002Fcore\u002FuseStorage\u002F#initonmounted","suggestion","vite-doctor\u002Fnuxt","vueuse\u002Fssr\u002Frequire-init-on-mounted-storage","warn","src\u002Frule-packs\u002Fnuxt\u002Frules\u002Fvueuse-storage.ts","https:\u002F\u002Fgithub.com\u002Fonmax\u002Fvite-doctor\u002Fblob\u002Fmain\u002Fsrc\u002Frule-packs\u002Fnuxt\u002Frules\u002Fvueuse-storage.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 vueuse\u002Fssr\u002Frequire-init-on-mounted-storage\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}," vueuse\u002Fssr\u002Frequire-init-on-mounted-storage\n",[67,104,106],{"id":105},"why-it-matters","Why it matters",[108,109,110],"p",{},"VueUse reads browser storage synchronously when the composable runs. The server has no browser storage and renders the default value, so a stored value changes the first client render and Vue reports a hydration mismatch. Guarding the call with import.meta.client does not help, because the client branch still runs during hydration.",[67,112,114],{"id":113},"recommended-fix","Recommended fix",[108,116,117,118,121,122,125,126,129,130,133,134,137,138,140,141,143],{},"Pass { initOnMounted: true } so VueUse reads storage after the component mounts, or use ",[79,119,120],{},"useCookie()"," for state the server must render. A ",[79,123,124],{},"useStorage()"," call that passes localStorage or sessionStorage explicitly throws on the server before initOnMounted can help, so use ",[79,127,128],{},"useLocalStorage()"," or ",[79,131,132],{},"useSessionStorage()"," with { initOnMounted: true } instead. Doctor skips .client files, calls inside ",[79,135,136],{},"onMounted()",", apps with ssr: false, and refs that are only read in event handlers, watch callbacks, lifecycle hooks or unrendered computed values. With @vueuse\u002Fnuxt's ssrHandlers option, ",[79,139,124],{}," without a storage argument uses cookies; Doctor cannot see that option, so it only reports ",[79,142,124],{}," without a storage argument in apps without @vueuse\u002Fnuxt.",[67,145,147],{"id":146},"useful-links","Useful links",[149,150,151],"ul",{},[152,153,154],"li",{},[155,156,159],"a",{"href":59,"rel":157},[158],"nofollow","Rule reference",[67,161,163],{"id":162},"example","Example",[165,166,168],"h3",{"id":167},"read-stored-preferences-after-mount","Read stored preferences after mount",[108,170,171],{},"Before",[72,173,177],{"className":174,"code":175,"language":176,"meta":77,"style":77},"language-vue shiki shiki-themes material-theme-lighter material-theme material-theme-palenight","\u003Cscript setup lang=\"ts\">\nconst granularity = useSessionStorage('plan-granularity', 'month')\n\u003C\u002Fscript>\n\n\u003Ctemplate>\n  \u003Cspan>{{ granularity }}\u003C\u002Fspan>\n\u003C\u002Ftemplate>\n","vue",[79,178,179,210,251,261,268,278,298],{"__ignoreMap":77},[82,180,181,185,189,193,196,199,202,205,207],{"class":84,"line":85},[82,182,184],{"class":183},"sMK4o","\u003C",[82,186,188],{"class":187},"swJcz","script",[82,190,192],{"class":191},"spNyl"," setup",[82,194,195],{"class":191}," lang",[82,197,198],{"class":183},"=",[82,200,201],{"class":183},"\"",[82,203,204],{"class":92},"ts",[82,206,201],{"class":183},[82,208,209],{"class":183},">\n",[82,211,213,216,220,222,226,229,232,235,237,240,243,246,248],{"class":84,"line":212},2,[82,214,215],{"class":191},"const",[82,217,219],{"class":218},"sTEyZ"," granularity ",[82,221,198],{"class":183},[82,223,225],{"class":224},"s2Zo4"," useSessionStorage",[82,227,228],{"class":218},"(",[82,230,231],{"class":183},"'",[82,233,234],{"class":92},"plan-granularity",[82,236,231],{"class":183},[82,238,239],{"class":183},",",[82,241,242],{"class":183}," '",[82,244,245],{"class":92},"month",[82,247,231],{"class":183},[82,249,250],{"class":218},")\n",[82,252,254,257,259],{"class":84,"line":253},3,[82,255,256],{"class":183},"\u003C\u002F",[82,258,188],{"class":187},[82,260,209],{"class":183},[82,262,264],{"class":84,"line":263},4,[82,265,267],{"emptyLinePlaceholder":266},true,"\n",[82,269,271,273,276],{"class":84,"line":270},5,[82,272,184],{"class":183},[82,274,275],{"class":187},"template",[82,277,209],{"class":183},[82,279,281,284,286,289,292,294,296],{"class":84,"line":280},6,[82,282,283],{"class":183},"  \u003C",[82,285,82],{"class":187},[82,287,288],{"class":183},">",[82,290,291],{"class":218},"{{ granularity }}",[82,293,256],{"class":183},[82,295,82],{"class":187},[82,297,209],{"class":183},[82,299,301,303,305],{"class":84,"line":300},7,[82,302,256],{"class":183},[82,304,275],{"class":187},[82,306,209],{"class":183},[108,308,309],{},"After",[72,311,313],{"className":174,"code":312,"language":176,"meta":77,"style":77},"\u003Cscript setup lang=\"ts\">\nconst granularity = useSessionStorage('plan-granularity', 'month', { initOnMounted: true })\n\u003C\u002Fscript>\n\n\u003Ctemplate>\n  \u003Cspan>{{ granularity }}\u003C\u002Fspan>\n\u003C\u002Ftemplate>\n",[79,314,315,335,381,389,393,401,417],{"__ignoreMap":77},[82,316,317,319,321,323,325,327,329,331,333],{"class":84,"line":85},[82,318,184],{"class":183},[82,320,188],{"class":187},[82,322,192],{"class":191},[82,324,195],{"class":191},[82,326,198],{"class":183},[82,328,201],{"class":183},[82,330,204],{"class":92},[82,332,201],{"class":183},[82,334,209],{"class":183},[82,336,337,339,341,343,345,347,349,351,353,355,357,359,361,363,366,369,372,376,379],{"class":84,"line":212},[82,338,215],{"class":191},[82,340,219],{"class":218},[82,342,198],{"class":183},[82,344,225],{"class":224},[82,346,228],{"class":218},[82,348,231],{"class":183},[82,350,234],{"class":92},[82,352,231],{"class":183},[82,354,239],{"class":183},[82,356,242],{"class":183},[82,358,245],{"class":92},[82,360,231],{"class":183},[82,362,239],{"class":183},[82,364,365],{"class":183}," {",[82,367,368],{"class":187}," initOnMounted",[82,370,371],{"class":183},":",[82,373,375],{"class":374},"sfNiH"," true",[82,377,378],{"class":183}," }",[82,380,250],{"class":218},[82,382,383,385,387],{"class":84,"line":253},[82,384,256],{"class":183},[82,386,188],{"class":187},[82,388,209],{"class":183},[82,390,391],{"class":84,"line":263},[82,392,267],{"emptyLinePlaceholder":266},[82,394,395,397,399],{"class":84,"line":270},[82,396,184],{"class":183},[82,398,275],{"class":187},[82,400,209],{"class":183},[82,402,403,405,407,409,411,413,415],{"class":84,"line":280},[82,404,283],{"class":183},[82,406,82],{"class":187},[82,408,288],{"class":183},[82,410,291],{"class":218},[82,412,256],{"class":183},[82,414,82],{"class":187},[82,416,209],{"class":183},[82,418,419,421,423],{"class":84,"line":300},[82,420,256],{"class":183},[82,422,275],{"class":187},[82,424,209],{"class":183},[426,427,428],"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 .sMK4o, html code.shiki .sMK4o{--shiki-light:#39ADB5;--shiki-default:#89DDFF;--shiki-dark:#89DDFF}html pre.shiki code .swJcz, html code.shiki .swJcz{--shiki-light:#E53935;--shiki-default:#F07178;--shiki-dark:#F07178}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 .s2Zo4, html code.shiki .s2Zo4{--shiki-light:#6182B8;--shiki-default:#82AAFF;--shiki-dark:#82AAFF}html pre.shiki code .sfNiH, html code.shiki .sfNiH{--shiki-light:#FF5370;--shiki-default:#FF9CAC;--shiki-dark:#FF9CAC}",{"title":77,"searchDepth":212,"depth":212,"links":430},[431,432,433,434,435],{"id":69,"depth":212,"text":70},{"id":105,"depth":212,"text":106},{"id":113,"depth":212,"text":114},{"id":146,"depth":212,"text":147},{"id":162,"depth":212,"text":163,"children":436},[437],{"id":167,"depth":253,"text":168},"Finds VueUse useLocalStorage(), useSessionStorage() and browser-backed useStorage() calls in SSR Nuxt apps that read storage while the page hydrates.",[58],"md","nuxt",{},{"title":444},"Storage on mount","\u002Fnuxt\u002Frules\u002Fssr\u002Frequire-init-on-mounted-storage","Pass { initOnMounted: true } so VueUse reads storage after the component mounts, or use useCookie() for state the server must render. A useStorage() call that passes localStorage or sessionStorage explicitly throws on the server before initOnMounted can help, so use useLocalStorage() or useSessionStorage() with { initOnMounted: true } instead. Doctor skips .client files, calls inside onMounted(), apps with ssr: false, and refs that are only read in event handlers, watch callbacks, lifecycle hooks or unrendered computed values. With @vueuse\u002Fnuxt's ssrHandlers option, useStorage() without a storage argument uses cookies; Doctor cannot see that option, so it only reports useStorage() without a storage argument in apps without @vueuse\u002Fnuxt.",{"title":50,"description":438},"nuxt\u002Frules\u002Fssr\u002Frequire-init-on-mounted-storage","W-9NbwPEncjqlpu4fVJP_8_SFrL2bGKUe1xEGpVcIew",1795268806497]