{"_id":"58411ad2652e5b0f0015a7d2","parentDoc":null,"user":"55a6caa022cfa321008e01d6","category":{"_id":"566a3e8503b4b20d00d02a4a","__v":2,"version":"55a6e72f8cc73e0d00096638","pages":["5678aacb07bf6a0d0083eded","56a55f47b26c040d00d99281"],"project":"55a6e72e8cc73e0d00096635","sync":{"url":"","isSync":false},"reference":false,"createdAt":"2015-12-11T03:09:57.119Z","from_sync":false,"order":7,"slug":"shipping-a-theme","title":"Shipping a Theme"},"project":"55a6e72e8cc73e0d00096635","version":{"_id":"55a6e72f8cc73e0d00096638","project":"55a6e72e8cc73e0d00096635","hasReference":false,"__v":29,"hasDoc":true,"createdAt":"2015-07-15T23:05:19.125Z","releaseDate":"2015-07-15T23:05:19.125Z","categories":["55a6e7308cc73e0d00096639","55b7ed07aea7c8190058badb","5604567c0c78b00d0039b191","5605e6f23a93940d002b3e4a","5605f2bba4574a0d00811365","5605f309a4574a0d00811366","5608e3b98aedf50d0004cf8f","5608e4318aedf50d0004cf90","5608e6b5a7cc2f0d00d9754d","5608e6d331beb60d001b6560","5608f879a7cc2f0d00d97580","560b097887b71d0d000d3bd9","560b13cbafa0990d00979545","560b5cbec341310d00de2a01","560b5cd0c341310d00de2a02","566a35b81e08750d00a0c49b","566a3e8503b4b20d00d02a4a","567889d307bf6a0d0083edc8","569c8b7c15bb390d00db6f9d","56b254dc65ddf50d0076ba8f","57a8ebc4cdeea20e001d2a63","57e48a4000c8680e00fae6e7","5808216773557d0f00a1e428","58105ad54a8aa50f00aa4cba","58105bf298aea40f00afa3ba","58105f548a4aed0f00d67536","581061b898aea40f00afa3be","584b3de7e5f3a42300df6ef7","596839a75965d400155bb750"],"is_deprecated":false,"is_hidden":false,"is_beta":false,"is_stable":true,"codename":"","version_clean":"1.0.0","version":"1.0"},"__v":0,"updates":[],"next":{"pages":[],"description":""},"createdAt":"2016-12-02T06:55:14.935Z","link_external":false,"link_url":"","githubsync":"","sync_unique":"","hidden":false,"api":{"results":{"codes":[]},"settings":"","auth":"required","params":[],"url":""},"isReference":false,"order":2,"body":"For themes that would otherwise exceed BigCommerce's 50 MB limit on uploads, delivering your theme's large static assets via a CDN (content delivery network) is an alternative to the simpler <a href=\"/docs/webdav-static-assets\">WebDAV</a> approach. \n\nThe advantage of this alternative is that all assets stay within your theme's directory, so your theme's local structure matches its deployed structure. The disadvantage is that the procedure outlined below requires the expense of a CDN.\n\n<h2> <a name=\"organize\"></a> Organizing Your Theme </h2> \n\nTo stage your theme for CDN delivery, you would locally store your large static assets within your theme's \n`<theme-name>/assets/cdn/` subdirectory. By design, the `stencil bundle` command omits this subdirectory's contents. So those contents do not count against the 50 MB limit on the resulting .zip file.\n\nThen, as you develop your theme, reference each of these assets using Stencil's `cdn` custom Handlebars helper, as explained [here](/docs/other-handlebars-helpers#cdn).\n\nWhen you are ready to upload your theme to BigCommerce, follow the procedure starting <a href=\"/docs/check-ready\">here</a>.","excerpt":"","slug":"cdn-dir","type":"basic","title":"Staging a Theme for CDN Delivery"}

Staging a Theme for CDN Delivery


For themes that would otherwise exceed BigCommerce's 50 MB limit on uploads, delivering your theme's large static assets via a CDN (content delivery network) is an alternative to the simpler <a href="/docs/webdav-static-assets">WebDAV</a> approach. The advantage of this alternative is that all assets stay within your theme's directory, so your theme's local structure matches its deployed structure. The disadvantage is that the procedure outlined below requires the expense of a CDN. <h2> <a name="organize"></a> Organizing Your Theme </h2> To stage your theme for CDN delivery, you would locally store your large static assets within your theme's `<theme-name>/assets/cdn/` subdirectory. By design, the `stencil bundle` command omits this subdirectory's contents. So those contents do not count against the 50 MB limit on the resulting .zip file. Then, as you develop your theme, reference each of these assets using Stencil's `cdn` custom Handlebars helper, as explained [here](/docs/other-handlebars-helpers#cdn). When you are ready to upload your theme to BigCommerce, follow the procedure starting <a href="/docs/check-ready">here</a>.