[{"data":1,"prerenderedAt":423},["ShallowReactive",2],{"docs-\u002Fdocs\u002Fsite-kit\u002Fupdates":3,"docs-navigation":273,"docs-surround-\u002Fdocs\u002Fsite-kit\u002Fupdates":420},{"id":4,"title":5,"body":6,"description":265,"extension":266,"icon":267,"meta":268,"navigation":267,"path":269,"seo":270,"stem":271,"__hash__":272},"docs\u002Fdocs\u002F4.site-kit\u002F09.updates.md","Kit updates",{"type":7,"value":8,"toc":260},"minimark",[9,13,38,43,54,167,173,197,201,229,232,236,248,256],[10,11,5],"h1",{"id":12},"kit-updates",[14,15,16,17,21,22,25,26,29,30,33,34,37],"p",{},"A site takes a kit release with ",[18,19,20],"code",{},"npm install",", on a branch that deploys to the preview site. An update changes no file of the site except ",[18,23,24],{},"package.json",", ",[18,27,28],{},"package-lock.json"," and two generated files: the CMS config, ",[18,31,32],{},"public\u002Fadmin\u002Fconfig.yml",", and the description of the site's content, ",[18,35,36],{},".hostsmith\u002Fschema.json",".",[39,40,42],"h2",{"id":41},"take-a-release","Take a release",[14,44,45,46,53],{},"The ",[47,48,52],"a",{"href":49,"rel":50},"https:\u002F\u002Fgithub.com\u002Fhostsmith\u002Fsite-kit-astro\u002Freleases",[51],"nofollow","releases"," list each release and its notes. To take v0.7.0:",[55,56,61],"pre",{"className":57,"code":58,"language":59,"meta":60,"style":60},"language-bash shiki shiki-themes github-dark","git switch -c kit-update\u002Fv0.7.0\nnpm install --save-exact @hostsmith\u002Fsite-kit-astro@0.7.0\nnpm run decap-config\nnpx site-kit schema\nnpm run check:styles\nnpm run build\nnpm run check:urls\nnpm run check:styles -- --built\n","bash","",[18,62,63,83,98,109,121,131,141,151],{"__ignoreMap":60},[64,65,68,72,76,80],"span",{"class":66,"line":67},"line",1,[64,69,71],{"class":70},"svObZ","git",[64,73,75],{"class":74},"sU2Wk"," switch",[64,77,79],{"class":78},"sDLfK"," -c",[64,81,82],{"class":74}," kit-update\u002Fv0.7.0\n",[64,84,86,89,92,95],{"class":66,"line":85},2,[64,87,88],{"class":70},"npm",[64,90,91],{"class":74}," install",[64,93,94],{"class":78}," --save-exact",[64,96,97],{"class":74}," @hostsmith\u002Fsite-kit-astro@0.7.0\n",[64,99,101,103,106],{"class":66,"line":100},3,[64,102,88],{"class":70},[64,104,105],{"class":74}," run",[64,107,108],{"class":74}," decap-config\n",[64,110,112,115,118],{"class":66,"line":111},4,[64,113,114],{"class":70},"npx",[64,116,117],{"class":74}," site-kit",[64,119,120],{"class":74}," schema\n",[64,122,124,126,128],{"class":66,"line":123},5,[64,125,88],{"class":70},[64,127,105],{"class":74},[64,129,130],{"class":74}," check:styles\n",[64,132,134,136,138],{"class":66,"line":133},6,[64,135,88],{"class":70},[64,137,105],{"class":74},[64,139,140],{"class":74}," build\n",[64,142,144,146,148],{"class":66,"line":143},7,[64,145,88],{"class":70},[64,147,105],{"class":74},[64,149,150],{"class":74}," check:urls\n",[64,152,154,156,158,161,164],{"class":66,"line":153},8,[64,155,88],{"class":70},[64,157,105],{"class":74},[64,159,160],{"class":74}," check:styles",[64,162,163],{"class":78}," --",[64,165,166],{"class":78}," --built\n",[14,168,169,170,37],{},"Then commit, push the branch, check the preview site, and merge the branch to ",[18,171,172],{},"main",[174,175,176,187],"ul",{},[177,178,179,180,183,184,186],"li",{},"If npm reports a conflict on ",[18,181,182],{},"astro",", the release notes name the ",[18,185,182],{}," version to install with the kit, in the same command.",[177,188,189,190,192,193,196],{},"A site without ",[18,191,36],{}," gains it at the first update that runs ",[18,194,195],{},"npx site-kit schema",": commit it too.",[39,198,200],{"id":199},"what-the-checks-report","What the checks report",[174,202,203,215,223],{},[177,204,205,211,212,37],{},[206,207,208],"strong",{},[18,209,210],{},"check:styles"," checks the site's theme against the new release's styling hooks. It fails on a hook the release no longer has, and warns about one it deprecates, naming the replacement. Rename the selector in the theme or ",[18,213,214],{},"site.css",[177,216,217,222],{},[206,218,219],{},[18,220,221],{},"check:styles -- --built"," warns about hooks the built pages carry that the theme doesn't style yet, such as a new variant. Style them in the theme.",[177,224,225,228],{},[206,226,227],{},"The build"," warns about content that a release deprecates, naming the replacement.",[14,230,231],{},"A hook is deprecated in one release before a later one removes it. A site that clears the warnings at each update takes the removal without surprises.",[39,233,235],{"id":234},"releases-that-change-a-sites-files","Releases that change a site's files",[14,237,238,239,244,245,247],{},"The kit is before 1.0, so a release can still change what a site's files hold, as 0.5 and 0.6 did. Such a release's notes give the steps, and the kit's README has a checklist for it, such as ",[47,240,243],{"href":241,"rel":242},"https:\u002F\u002Fgithub.com\u002Fhostsmith\u002Fsite-kit-astro\u002Fblob\u002Fmain\u002FREADME.md#from-05-to-06",[51],"From 0.5 to 0.6",". For a site that skipped the release that deprecated a hook, the notes of the release that removes it, and the errors from ",[18,246,210],{},", list what to change.",[14,249,250,251,255],{},"The README's ",[47,252,5],{"href":253,"rel":254},"https:\u002F\u002Fgithub.com\u002Fhostsmith\u002Fsite-kit-astro\u002Fblob\u002Fmain\u002FREADME.md#kit-updates",[51]," has the same commands.",[257,258,259],"style",{},"html pre.shiki code .svObZ, html code.shiki .svObZ{--shiki-default:#B392F0}html pre.shiki code .sU2Wk, html code.shiki .sU2Wk{--shiki-default:#9ECBFF}html pre.shiki code .sDLfK, html code.shiki .sDLfK{--shiki-default:#79B8FF}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);}",{"title":60,"searchDepth":85,"depth":85,"links":261},[262,263,264],{"id":41,"depth":85,"text":42},{"id":199,"depth":85,"text":200},{"id":234,"depth":85,"text":235},"Take a new site kit release on a branch, check it in a preview, and merge it - and what the checks report after an update.","md",null,{},"\u002Fdocs\u002Fsite-kit\u002Fupdates",{"title":5,"description":265},"docs\u002F4.site-kit\u002F09.updates","3O6-95m7ez0t_CIVgEXR9FDJpCpJUxWLkgs655eLQEI",[274],{"title":275,"path":276,"stem":277,"children":278,"page":419},"Docs","\u002Fdocs","docs",[279,306,318,353,401],{"title":280,"path":281,"stem":282,"children":283,"page":-1,"icon":285},"Getting Started","\u002Fdocs\u002Fgetting-started","docs\u002F1.getting-started\u002Findex",[284,286,290,294,298,302],{"title":280,"path":281,"stem":282,"icon":285},"solar:rocket-bold",{"title":287,"path":288,"stem":289},"Introduction","\u002Fdocs\u002Fgetting-started\u002Fintroduction","docs\u002F1.getting-started\u002F1.introduction",{"title":291,"path":292,"stem":293},"Quick Start","\u002Fdocs\u002Fgetting-started\u002Fquick-start","docs\u002F1.getting-started\u002F2.quick-start",{"title":295,"path":296,"stem":297},"Sites","\u002Fdocs\u002Fgetting-started\u002Fsites","docs\u002F1.getting-started\u002F3.sites",{"title":299,"path":300,"stem":301},"Custom Domains","\u002Fdocs\u002Fgetting-started\u002Fcustom-domains","docs\u002F1.getting-started\u002F4.custom-domains",{"title":303,"path":304,"stem":305},"Support","\u002Fdocs\u002Fgetting-started\u002Fsupport","docs\u002F1.getting-started\u002F5.support",{"title":307,"path":308,"stem":309,"children":310,"page":-1,"icon":312},"Integrations","\u002Fdocs\u002Fintegrations","docs\u002F2.integrations\u002Findex",[311,313],{"title":307,"path":308,"stem":309,"icon":312},"ph:usb-bold",{"title":314,"path":315,"stem":316,"icon":317},"n8n","\u002Fdocs\u002Fintegrations\u002Fn8n","docs\u002F2.integrations\u002F1.n8n","simple-icons:n8n",{"title":319,"path":320,"stem":321,"children":322,"page":-1,"icon":324},"MCP","\u002Fdocs\u002Fmcp","docs\u002F3.mcp\u002Findex",[323,325,329,333,337,341,345,349],{"title":319,"path":320,"stem":321,"icon":324},"solar:plug-circle-bold",{"title":326,"path":327,"stem":328},"Quick start","\u002Fdocs\u002Fmcp\u002Fquick-start","docs\u002F3.mcp\u002F1.quick-start",{"title":330,"path":331,"stem":332},"Clients","\u002Fdocs\u002Fmcp\u002Fclients","docs\u002F3.mcp\u002F2.clients",{"title":334,"path":335,"stem":336},"Authentication","\u002Fdocs\u002Fmcp\u002Fauthentication","docs\u002F3.mcp\u002F3.authentication",{"title":338,"path":339,"stem":340},"Tools","\u002Fdocs\u002Fmcp\u002Ftools","docs\u002F3.mcp\u002F4.tools",{"title":342,"path":343,"stem":344},"Recipes","\u002Fdocs\u002Fmcp\u002Frecipes","docs\u002F3.mcp\u002F5.recipes",{"title":346,"path":347,"stem":348},"Limits and errors","\u002Fdocs\u002Fmcp\u002Flimits-and-errors","docs\u002F3.mcp\u002F6.limits-and-errors",{"title":350,"path":351,"stem":352},"FAQ","\u002Fdocs\u002Fmcp\u002Ffaq","docs\u002F3.mcp\u002F7.faq",{"title":354,"path":355,"stem":356,"children":357,"page":-1,"icon":359},"Site kit","\u002Fdocs\u002Fsite-kit","docs\u002F4.site-kit\u002Findex",[358,360,364,368,372,376,380,384,388,392,393,397],{"title":354,"path":355,"stem":356,"icon":359},"solar:layers-bold",{"title":361,"path":362,"stem":363},"Overview","\u002Fdocs\u002Fsite-kit\u002Foverview","docs\u002F4.site-kit\u002F01.overview",{"title":365,"path":366,"stem":367},"Start a site","\u002Fdocs\u002Fsite-kit\u002Fstart-a-site","docs\u002F4.site-kit\u002F02.start-a-site",{"title":369,"path":370,"stem":371},"Content","\u002Fdocs\u002Fsite-kit\u002Fcontent","docs\u002F4.site-kit\u002F03.content",{"title":373,"path":374,"stem":375},"Design","\u002Fdocs\u002Fsite-kit\u002Fdesign","docs\u002F4.site-kit\u002F04.design",{"title":377,"path":378,"stem":379},"Languages","\u002Fdocs\u002Fsite-kit\u002Flanguages","docs\u002F4.site-kit\u002F05.languages",{"title":381,"path":382,"stem":383},"Deploy with Hostsmith","\u002Fdocs\u002Fsite-kit\u002Fdeploy","docs\u002F4.site-kit\u002F06.deploy",{"title":385,"path":386,"stem":387},"Keep old URLs","\u002Fdocs\u002Fsite-kit\u002Fold-urls","docs\u002F4.site-kit\u002F07.old-urls",{"title":389,"path":390,"stem":391},"Work with an AI agent","\u002Fdocs\u002Fsite-kit\u002Fai-agents","docs\u002F4.site-kit\u002F08.ai-agents",{"title":5,"path":269,"stem":271},{"title":394,"path":395,"stem":396},"Existing Astro sites","\u002Fdocs\u002Fsite-kit\u002Fexisting-astro-sites","docs\u002F4.site-kit\u002F10.existing-astro-sites",{"title":398,"path":399,"stem":400},"External CMS","\u002Fdocs\u002Fsite-kit\u002Fexternal-cms","docs\u002F4.site-kit\u002F11.external-cms",{"title":402,"path":403,"stem":404,"children":405,"page":-1,"icon":407},"Developers","\u002Fdocs\u002Fdevelopers","docs\u002F5.developers\u002Findex",[406,408,411,415],{"title":402,"path":403,"stem":404,"icon":407},"solar:code-bold",{"title":334,"path":409,"stem":410},"\u002Fdocs\u002Fdevelopers\u002Fauthentication","docs\u002F5.developers\u002F1.authentication",{"title":412,"path":413,"stem":414},"API Explorer","\u002Fdocs\u002Fdevelopers\u002Fapi-explorer","docs\u002F5.developers\u002F2.api-explorer",{"title":416,"path":417,"stem":418},"Node.js SDK","\u002Fdocs\u002Fdevelopers\u002Fsdk","docs\u002F5.developers\u002F3.sdk",false,[421,422],{"title":389,"path":390,"stem":391,"children":-1},{"title":394,"path":395,"stem":396,"children":-1},1792842402081]