[{"data":1,"prerenderedAt":518},["ShallowReactive",2],{"navigation_docs":3,"-docs-assets-usage-best-practices":214,"-docs-assets-usage-best-practices-surround":513},[4,74,96,130],{"title":5,"path":6,"stem":7,"children":8},"Assets API","\u002Fdocs\u002Fassets","docs\u002Fassets\u002Findex",[9,10,32,57],{"title":5,"path":6,"stem":7},{"title":11,"path":12,"stem":13,"children":14,"page":31},"Getting Started","\u002Fdocs\u002Fassets\u002Fgetting-started","docs\u002Fassets\u002F1.getting-started",[15,19,23,27],{"title":16,"path":17,"stem":18},"Base URL","\u002Fdocs\u002Fassets\u002Fgetting-started\u002Fbase-url","docs\u002Fassets\u002F1.getting-started\u002F1.base-url",{"title":20,"path":21,"stem":22},"Important Notes","\u002Fdocs\u002Fassets\u002Fgetting-started\u002Fimportant-notes","docs\u002Fassets\u002F1.getting-started\u002F2.important-notes",{"title":24,"path":25,"stem":26},"URL Format","\u002Fdocs\u002Fassets\u002Fgetting-started\u002Furl-format","docs\u002Fassets\u002F1.getting-started\u002F3.url-format",{"title":28,"path":29,"stem":30},"Custom Domains","\u002Fdocs\u002Fassets\u002Fgetting-started\u002Fcustom-domains","docs\u002Fassets\u002F1.getting-started\u002F4.custom-domains",false,{"title":33,"path":34,"stem":35,"children":36,"page":31},"Usage","\u002Fdocs\u002Fassets\u002Fusage","docs\u002Fassets\u002F2.usage",[37,41,45,49,53],{"title":38,"path":39,"stem":40},"Transforms","\u002Fdocs\u002Fassets\u002Fusage\u002Ftransforms","docs\u002Fassets\u002F2.usage\u002F1.transforms",{"title":42,"path":43,"stem":44},"Caching","\u002Fdocs\u002Fassets\u002Fusage\u002Fcaching","docs\u002Fassets\u002F2.usage\u002F2.caching",{"title":46,"path":47,"stem":48},"Recipes","\u002Fdocs\u002Fassets\u002Fusage\u002Frecipes","docs\u002Fassets\u002F2.usage\u002F3.recipes",{"title":50,"path":51,"stem":52},"Best Practices","\u002Fdocs\u002Fassets\u002Fusage\u002Fbest-practices","docs\u002Fassets\u002F2.usage\u002F4.best-practices",{"title":54,"path":55,"stem":56},"Reference","\u002Fdocs\u002Fassets\u002Fusage\u002Freference","docs\u002Fassets\u002F2.usage\u002F5.reference",{"title":58,"path":59,"stem":60,"children":61,"page":31},"Integration","\u002Fdocs\u002Fassets\u002Fintegration","docs\u002Fassets\u002F3.integration",[62,66,70],{"title":63,"path":64,"stem":65},"Nuxt","\u002Fdocs\u002Fassets\u002Fintegration\u002Fnuxt","docs\u002Fassets\u002F3.integration\u002F1.nuxt",{"title":67,"path":68,"stem":69},"Next.js","\u002Fdocs\u002Fassets\u002Fintegration\u002Fnextjs","docs\u002Fassets\u002F3.integration\u002F2.nextjs",{"title":71,"path":72,"stem":73},"Plain HTML","\u002Fdocs\u002Fassets\u002Fintegration\u002Fhtml","docs\u002Fassets\u002F3.integration\u002F3.html",{"title":75,"path":76,"stem":77,"children":78},"Events API","\u002Fdocs\u002Fevents","docs\u002Fevents\u002Findex",[79,80],{"title":75,"path":76,"stem":77},{"title":11,"path":81,"stem":82,"children":83,"page":31},"\u002Fdocs\u002Fevents\u002Fgetting-started","docs\u002Fevents\u002F1.getting-started",[84,88,92],{"title":85,"path":86,"stem":87},"Subscribing","\u002Fdocs\u002Fevents\u002Fgetting-started\u002Fsubscribing","docs\u002Fevents\u002F1.getting-started\u002F1.subscribing",{"title":89,"path":90,"stem":91},"Event Delivery","\u002Fdocs\u002Fevents\u002Fgetting-started\u002Fevent-delivery","docs\u002Fevents\u002F1.getting-started\u002F2.event-delivery",{"title":93,"path":94,"stem":95},"Event Reference","\u002Fdocs\u002Fevents\u002Fgetting-started\u002Fevent-reference","docs\u002Fevents\u002F1.getting-started\u002F3.event-reference",{"title":97,"path":98,"stem":99,"children":100},"Integrations API","\u002Fdocs\u002Fintegrations","docs\u002Fintegrations\u002Findex",[101,102],{"title":97,"path":98,"stem":99},{"title":11,"path":103,"stem":104,"children":105,"page":31},"\u002Fdocs\u002Fintegrations\u002Fgetting-started","docs\u002Fintegrations\u002F1.getting-started",[106,110,114,118,122,126],{"title":107,"path":108,"stem":109},"Why Use It?","\u002Fdocs\u002Fintegrations\u002Fgetting-started\u002Fwhy-integrations-api","docs\u002Fintegrations\u002F1.getting-started\u002F1.why-integrations-api",{"title":111,"path":112,"stem":113},"Use Cases","\u002Fdocs\u002Fintegrations\u002Fgetting-started\u002Fwho-is-it-for","docs\u002Fintegrations\u002F1.getting-started\u002F2.who-is-it-for",{"title":115,"path":116,"stem":117},"Pre-built Connectors","\u002Fdocs\u002Fintegrations\u002Fgetting-started\u002Fpre-built-integrations","docs\u002Fintegrations\u002F1.getting-started\u002F3.pre-built-integrations",{"title":119,"path":120,"stem":121},"Custom Inbound","\u002Fdocs\u002Fintegrations\u002Fgetting-started\u002Fcustom-inbound-api","docs\u002Fintegrations\u002F1.getting-started\u002F4.custom-inbound-api",{"title":123,"path":124,"stem":125},"Event Lifecycle","\u002Fdocs\u002Fintegrations\u002Fgetting-started\u002Fevent-lifecycle","docs\u002Fintegrations\u002F1.getting-started\u002F5.event-lifecycle",{"title":127,"path":128,"stem":129},"API Endpoints","\u002Fdocs\u002Fintegrations\u002Fgetting-started\u002Fmanagement-api-endpoints","docs\u002Fintegrations\u002F1.getting-started\u002F6.management-api-endpoints",{"title":131,"path":132,"stem":133,"children":134,"redirect":136},"MCP Server","\u002Fdocs\u002Fmcp","docs\u002Fmcp\u002Findex",[135,137,156,189],{"title":131,"path":132,"stem":133,"redirect":136},"\u002Fdocs\u002Fmcp\u002Fgetting-started\u002Fvscode",{"title":11,"path":138,"stem":139,"children":140,"page":31},"\u002Fdocs\u002Fmcp\u002Fgetting-started","docs\u002Fmcp\u002F1.getting-started",[141,144,148,152],{"title":142,"path":136,"stem":143},"VS Code","docs\u002Fmcp\u002F1.getting-started\u002F1.vscode",{"title":145,"path":146,"stem":147},"Claude Desktop","\u002Fdocs\u002Fmcp\u002Fgetting-started\u002Fclaude-desktop","docs\u002Fmcp\u002F1.getting-started\u002F2.claude-desktop",{"title":149,"path":150,"stem":151},"Cursor","\u002Fdocs\u002Fmcp\u002Fgetting-started\u002Fcursor","docs\u002Fmcp\u002F1.getting-started\u002F3.cursor",{"title":153,"path":154,"stem":155},"Verify Connection","\u002Fdocs\u002Fmcp\u002Fgetting-started\u002Fverify","docs\u002Fmcp\u002F1.getting-started\u002F4.verify",{"title":157,"path":158,"stem":159,"children":160,"page":31},"Tools","\u002Fdocs\u002Fmcp\u002Ftools","docs\u002Fmcp\u002F2.tools",[161,165,169,173,177,181,185],{"title":162,"path":163,"stem":164},"list_endpoints","\u002Fdocs\u002Fmcp\u002Ftools\u002Flist-endpoints","docs\u002Fmcp\u002F2.tools\u002F1.list-endpoints",{"title":166,"path":167,"stem":168},"get_endpoint","\u002Fdocs\u002Fmcp\u002Ftools\u002Fget-endpoint","docs\u002Fmcp\u002F2.tools\u002F2.get-endpoint",{"title":170,"path":171,"stem":172},"get_schema","\u002Fdocs\u002Fmcp\u002Ftools\u002Fget-schema","docs\u002Fmcp\u002F2.tools\u002F3.get-schema",{"title":174,"path":175,"stem":176},"list_schemas","\u002Fdocs\u002Fmcp\u002Ftools\u002Flist-schemas","docs\u002Fmcp\u002F2.tools\u002F4.list-schemas",{"title":178,"path":179,"stem":180},"search_docs","\u002Fdocs\u002Fmcp\u002Ftools\u002Fsearch-docs","docs\u002Fmcp\u002F2.tools\u002F5.search-docs",{"title":182,"path":183,"stem":184},"get_api_overview","\u002Fdocs\u002Fmcp\u002Ftools\u002Fget-api-overview","docs\u002Fmcp\u002F2.tools\u002F6.get-api-overview",{"title":186,"path":187,"stem":188},"get_description","\u002Fdocs\u002Fmcp\u002Ftools\u002Fget-description","docs\u002Fmcp\u002F2.tools\u002F7.get-description",{"title":190,"path":191,"stem":192,"children":193,"page":31},"Examples","\u002Fdocs\u002Fmcp\u002Fexamples","docs\u002Fmcp\u002F3.examples",[194,198,202,206,210],{"title":195,"path":196,"stem":197},"Exploring an API","\u002Fdocs\u002Fmcp\u002Fexamples\u002Fexploring-an-api","docs\u002Fmcp\u002F3.examples\u002F1.exploring-an-api",{"title":199,"path":200,"stem":201},"Building a Feature","\u002Fdocs\u002Fmcp\u002Fexamples\u002Fbuilding-a-feature","docs\u002Fmcp\u002F3.examples\u002F2.building-a-feature",{"title":203,"path":204,"stem":205},"Understanding Models","\u002Fdocs\u002Fmcp\u002Fexamples\u002Funderstanding-models","docs\u002Fmcp\u002F3.examples\u002F3.understanding-models",{"title":207,"path":208,"stem":209},"Code Review","\u002Fdocs\u002Fmcp\u002Fexamples\u002Fcode-review","docs\u002Fmcp\u002F3.examples\u002F4.code-review",{"title":211,"path":212,"stem":213},"Tips","\u002Fdocs\u002Fmcp\u002Fexamples\u002Ftips","docs\u002Fmcp\u002F3.examples\u002F5.tips",{"id":215,"title":50,"body":216,"description":507,"extension":508,"links":509,"meta":510,"navigation":305,"path":51,"seo":511,"stem":52,"__hash__":512},"docs\u002Fdocs\u002Fassets\u002F2.usage\u002F4.best-practices.md",{"type":217,"value":218,"toc":493},"minimark",[219,223,233,240,392,396,399,407,415,421,427,434,437,443,447,457,461,472,476,486,489],[220,221,50],"h2",{"id":222},"best-practices",[224,225,227,228,232],"h3",{"id":226},"use-responsive-width-parameters","Use responsive ",[229,230,231],"code",{},"width"," parameters",[234,235,236,237,239],"p",{},"Always specify a ",[229,238,231],{}," that matches the rendered size on screen. Don't serve a 2000px image for a 200px thumbnail.",[241,242,247],"pre",{"className":243,"code":244,"language":245,"meta":246,"style":246},"language-html shiki shiki-themes material-theme-lighter material-theme material-theme-palenight","\u003C!-- Good: sized to actual display -->\n\u003Cimg src=\"https:\u002F\u002Fassets.avvyr.com\u002Fassets\u002Fsofa.jpg?width=400&height=400&fm=webp\" width=\"400\" \u002F>\n\n\u003C!-- Responsive with srcset -->\n\u003Cimg\n  srcset=\"\n    https:\u002F\u002Fassets.avvyr.com\u002Fassets\u002Fsofa.jpg?width=400&height=400&fm=webp    400w,\n    https:\u002F\u002Fassets.avvyr.com\u002Fassets\u002Fsofa.jpg?width=800&height=800&fm=webp    800w,\n    https:\u002F\u002Fassets.avvyr.com\u002Fassets\u002Fsofa.jpg?width=1200&height=1200&fm=webp 1200w\n  \"\n  sizes=\"(max-width: 768px) 100vw, 50vw\"\n  src=\"https:\u002F\u002Fassets.avvyr.com\u002Fassets\u002Fsofa.jpg?width=800&height=800&fm=webp\"\n\u002F>\n","html","",[229,248,249,258,300,307,313,321,332,338,344,350,356,371,386],{"__ignoreMap":246},[250,251,254],"span",{"class":252,"line":253},"line",1,[250,255,257],{"class":256},"sHwdD","\u003C!-- Good: sized to actual display -->\n",[250,259,261,265,269,273,276,279,283,285,288,290,292,295,297],{"class":252,"line":260},2,[250,262,264],{"class":263},"sMK4o","\u003C",[250,266,268],{"class":267},"swJcz","img",[250,270,272],{"class":271},"spNyl"," src",[250,274,275],{"class":263},"=",[250,277,278],{"class":263},"\"",[250,280,282],{"class":281},"sfazB","https:\u002F\u002Fassets.avvyr.com\u002Fassets\u002Fsofa.jpg?width=400&height=400&fm=webp",[250,284,278],{"class":263},[250,286,287],{"class":271}," width",[250,289,275],{"class":263},[250,291,278],{"class":263},[250,293,294],{"class":281},"400",[250,296,278],{"class":263},[250,298,299],{"class":263}," \u002F>\n",[250,301,303],{"class":252,"line":302},3,[250,304,306],{"emptyLinePlaceholder":305},true,"\n",[250,308,310],{"class":252,"line":309},4,[250,311,312],{"class":256},"\u003C!-- Responsive with srcset -->\n",[250,314,316,318],{"class":252,"line":315},5,[250,317,264],{"class":263},[250,319,320],{"class":267},"img\n",[250,322,324,327,329],{"class":252,"line":323},6,[250,325,326],{"class":271},"  srcset",[250,328,275],{"class":263},[250,330,331],{"class":263},"\"\n",[250,333,335],{"class":252,"line":334},7,[250,336,337],{"class":281},"    https:\u002F\u002Fassets.avvyr.com\u002Fassets\u002Fsofa.jpg?width=400&height=400&fm=webp    400w,\n",[250,339,341],{"class":252,"line":340},8,[250,342,343],{"class":281},"    https:\u002F\u002Fassets.avvyr.com\u002Fassets\u002Fsofa.jpg?width=800&height=800&fm=webp    800w,\n",[250,345,347],{"class":252,"line":346},9,[250,348,349],{"class":281},"    https:\u002F\u002Fassets.avvyr.com\u002Fassets\u002Fsofa.jpg?width=1200&height=1200&fm=webp 1200w\n",[250,351,353],{"class":252,"line":352},10,[250,354,355],{"class":263},"  \"\n",[250,357,359,362,364,366,369],{"class":252,"line":358},11,[250,360,361],{"class":271},"  sizes",[250,363,275],{"class":263},[250,365,278],{"class":263},[250,367,368],{"class":281},"(max-width: 768px) 100vw, 50vw",[250,370,331],{"class":263},[250,372,374,377,379,381,384],{"class":252,"line":373},12,[250,375,376],{"class":271},"  src",[250,378,275],{"class":263},[250,380,278],{"class":263},[250,382,383],{"class":281},"https:\u002F\u002Fassets.avvyr.com\u002Fassets\u002Fsofa.jpg?width=800&height=800&fm=webp",[250,385,331],{"class":263},[250,387,389],{"class":252,"line":388},13,[250,390,391],{"class":263},"\u002F>\n",[224,393,395],{"id":394},"use-webp-format","Use WebP format",[234,397,398],{},"WebP gives 25-35% smaller files than JPEG at the same visual quality. All modern browsers support it.",[241,400,405],{"className":401,"code":403,"language":404},[402],"language-text","?width=800&height=800&fm=webp&q=80\n","text",[229,406,403],{"__ignoreMap":246},[224,408,410,411,414],{"id":409},"use-fitfill-for-uniform-grid-layouts","Use ",[229,412,413],{},"fit=fill"," for uniform grid layouts",[234,416,417,418,420],{},"Product grids look best when all images have identical dimensions. Use ",[229,419,413],{}," with a white background:",[241,422,425],{"className":423,"code":424,"language":404},[402],"?width=600&height=600&fit=fill&fill=solid&fill-color=ffffff&fm=webp\n",[229,426,424],{"__ignoreMap":246},[224,428,410,430,433],{"id":429},"use-trim-for-inconsistent-product-images",[229,431,432],{},"trim"," for inconsistent product images",[234,435,436],{},"Supplier images often have random whitespace. Trim it, then apply uniform padding:",[241,438,441],{"className":439,"code":440,"language":404},[402],"?trim&width=600&height=600&fit=fill&fill=solid&fill-color=ffffff&pad=20&fm=webp\n",[229,442,440],{"__ignoreMap":246},[224,444,446],{"id":445},"avoid-cache-busting","Avoid cache-busting",[234,448,449,450,453,454,456],{},"Do not use the ",[229,451,452],{},"c"," parameter unless absolutely necessary. Each unique ",[229,455,452],{}," value bypasses the disk cache and triggers a new billable transformation. If you need to update an image, re-upload it so it gets a new storage path — this is free and instant across all cache layers.",[224,458,460],{"id":459},"specify-quality-intentionally","Specify quality intentionally",[234,462,463,464,467,468,471],{},"Don't use ",[229,465,466],{},"q=100"," by default — the file size increase is significant with no visible benefit on screen. Use ",[229,469,470],{},"q=80"," (the default) for most cases.",[224,473,475],{"id":474},"dont-transform-svgs","Don't transform SVGs",[234,477,478,479,481,482,485],{},"SVGs are vector and scale infinitely. Passing ",[229,480,231],{},"\u002F",[229,483,484],{},"height"," to SVG URLs has no effect. Resize SVGs with CSS instead.",[487,488],"hr",{},[490,491,492],"style",{},"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 .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 .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);}",{"title":246,"searchDepth":260,"depth":260,"links":494},[495],{"id":222,"depth":260,"text":50,"children":496},[497,499,500,502,504,505,506],{"id":226,"depth":302,"text":498},"Use responsive width parameters",{"id":394,"depth":302,"text":395},{"id":409,"depth":302,"text":501},"Use fit=fill for uniform grid layouts",{"id":429,"depth":302,"text":503},"Use trim for inconsistent product images",{"id":445,"depth":302,"text":446},{"id":459,"depth":302,"text":460},{"id":474,"depth":302,"text":475},"Performance tips, responsive images, and quality guidelines","md",null,{},{"title":50,"description":507},"b1-KMPLSrIEUfHZGOSk6_wy06ZEi8FvJd22fDGqND1I",[514,516],{"title":46,"path":47,"stem":48,"description":515,"children":-1},"Ready-to-use parameter combinations for common use cases",{"title":54,"path":55,"stem":56,"description":517,"children":-1},"Supported formats, error codes, and quick lookup tables",1775725941614]