{"_id":"57a15312e80f940e00c46f27","parentDoc":null,"project":"55a6e72e8cc73e0d00096635","category":{"_id":"57e48a4000c8680e00fae6e7","version":"55a6e72f8cc73e0d00096638","__v":0,"project":"55a6e72e8cc73e0d00096635","sync":{"url":"","isSync":false},"reference":false,"createdAt":"2016-09-23T01:49:52.242Z","from_sync":false,"order":3,"slug":"advanced-installation-options","title":"Advanced Installation Options"},"__v":1,"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"},"user":"55a6caa022cfa321008e01d6","updates":[],"next":{"pages":[],"description":""},"createdAt":"2016-08-03T02:12:34.104Z","link_external":false,"link_url":"","githubsync":"","sync_unique":"","hidden":false,"api":{"settings":"","results":{"codes":[]},"auth":"required","params":[],"url":""},"isReference":false,"order":3,"body":"[block:callout]\n{\n  \"type\": \"info\",\n  \"title\": \"Optional Workflow\",\n  \"body\": \"The steps below are required only if you are downloading a refreshed copy of Stencil's default Cornerstone theme, or of the Diamond Classic or Queen theme, from the BigCommerce Theme Marketplace.\\n\\nIf you are downloading a _different_ Marketplace theme for customization, you must instead use the workflow outlined at <a href=\\\"/docs/downloading-and-customizing-marketplace-themes\\\">Downloading and Customizing Marketplace Themes</a>.\\n\\n(Cornerstone, Diamond Classic, and Queen use a simplified workflow that bypasses BitBucket requirements, and that replaces jspm with the <a href=\\\"https://webpack.github.io/docs/\\\">Webpack</a> build system. You can configure Webpack's watched folders, or substitute your own build system. For details, please see <a href=\\\"/docs/webpack-and-build-options\\\">Webpack and Build-System Options</a>.)\\n\\nTo keep any _custom or customized theme_ updated with the new features that BigCommerce adds to Cornerstone, please see our guidelines on [Theme Updates and Version Control](/docs/theme-updates-sync).\"\n}\n[/block]\n\n[block:html]\n{\n  \"html\": \"<!-- \\nIf you have just installed Cornerstone for the first time by [cloning the Stencil repo](/docs/adding-a-base-theme), skip both pages. Please proceed directly to installing the Stencil <a href=\\\"/docs/javascript-utilities\\\">JavaScript utilities</a> that are required to enable API access via Ajax.\\n-->\\n\\nThis entry covers:\\n<ul>\\n\\t<li><a href=\\\"#backup\\\">Back Up before Reinstalling</a>\\n  </li>\\n\\t<li><a href=\\\"#download_Cs\\\">Downloading the Cornerstone (or Queen) .zip</a>\\n\\t</li>\\n\\t<li><a href=\\\"#install_npm\\\">Reinstalling Dependencies and Relaunching</a>\\n\\t</li>\\n\\t<li><a href=\\\"#next\\\">Next Steps</a>\\n\\t</li>\\n</ul>\\n\\n<a name=\\\"backup\\\"></a>\"\n}\n[/block]\n\n[block:callout]\n{\n  \"type\": \"danger\",\n  \"title\": \"Back Up before Reinstalling\",\n  \"body\": \"If you are reinstalling over a base theme on which you have already begun development, first back up at least your theme's <span class=\\\"inline-code\\\">&lt;theme-name&gt;/.stencil</span> file. This file contains your store URL, your BigCommerce username and access tokens, and other basic settings. Preserving those settings will speed up initializing and launching the new version.\\n\\nTo allow complete rollback, back up your whole <span class=\\\"inline-code\\\">&lt;theme-name&gt;</span> directory. (In a current default installation, this directory is named <span class=\\\"inline-code\\\">.../cornerstone/</span>. Prior to March 2017, this directory's name defaulted to <span class=\\\"inline-code\\\">.../stencil/</span>.)\"\n}\n[/block]\n\n[block:html]\n{\n  \"html\": \"<h2> <A NAME=\\\"download_Cs\\\"></a> Downloading the Cornerstone (or Diamond Classic/Queen) .zip </h2>\\n\\nUse these steps to download a refreshed version of the Cornerstone, Diamond Classic, or Queen theme from the store control panel's <NOBR><span class=\\\"inline-code\\\">Storefront Design</span></nobr> area: \\n\\n<ol>\\n\\t<li>If you have not yet added Cornerstone (or Diamond Classic/Queen) to your store, start at <NOBR><span class=\\\"inline-code\\\">Storefront Design</span></nobr> &gt; <NOBR><span class=\\\"inline-code\\\">Themes Marketplace</span></nobr>, and add the theme.\\n    <p></p></li>\\n\\n    <ul> <!-- inner -->\\n      <li>Although Cornerstone is free to add, Diamond Classic and Queen require purchase.\\n      <p></p></li>\\n\\t\\t</ul> <!-- inner -->\\n    \\n\\t<li>Go to <NOBR><span class=\\\"inline-code\\\">Storefront Design</span></nobr> &gt; <NOBR><span class=\\\"inline-code\\\">My Themes</span></nobr>.\\n    <p></p></li> \\n  \\n\\t<li>Click the Cornerstone (or Diamond Classic or Queen) theme's thumbnail:\\n    \\n    <ul> <!-- inner -->\\n      <li>If Cornerstone (or Diamond Classic/Queen) is the store's currently active theme, click its image thumbnail at the top of the page, under the <NOBR><span class=\\\"inline-code\\\">Current Theme</span></nobr> heading.\\n      <p></p></li>\\n      <li>If Cornerstone (or Diamond Classic/Queen) is <em>not</em> the current theme, scroll down below the lower <NOBR><span class=\\\"inline-code\\\">My Themes</span></nobr> subheading, and find and click the Cornerstone (or Diamond Classic/Queen) thumbnail.\\n      <p></p></li>\\n\\t\\t</ul> <!-- inner -->\\n    \\n    The Cornerstone (or Diamond Classic/Queen) theme's description will zoom to full-page, and will display a <NOBR><span class=\\\"inline-code\\\">Theme Options</span></nobr> drop-down list at the <NOBR>upper right.</nobr>\\n    <p></p></li>\\n\\n\\t<li>From the <NOBR><span class=\\\"inline-code\\\">Theme Options</span></nobr> drop-down list, select <NOBR><span class=\\\"inline-code\\\">Download theme file</span></nobr> to download this Cornerstone (or Diamond Classic/Queen) release as it was refreshed on Theme Marketplace.\\n    <br><p></p>\\n\\t\\t<img src=\\\"https://files.readme.io/e59782a-DownloadMake-CopyCornerstone-Refreshhighlight.png\\\" alt=\\\"Theme Options &gt; Download option for freshest Cornerstone release\\\">\\n    <p></p></li>\\n\\n  <li>Unpack the zipped theme to a working directory.\\n    <p></p>\\n  (This can be the directory where you have been developing your theme, or a new directory.)<p></p></li>\\n</ol><p></p>\\n\\n<h2> <A NAME=\\\"install_npm\\\"></a> Reinstalling Dependencies and Relaunching </h2>\\n\\n<ol>  \\n  <li>Ensure that your theme includes all current dependencies, by repeating <a href=\\\"/docs/javascript-utilities\\\">JavaScript Utilities</a> installation.\\n  \\t<p></p></li>\\n  \\n  <li>Repeat the steps listed in the <a href=\\\"/docs/launching-stencil\\\">Launching Stencil subsection</a>.\\n  \\t<p></p></li>\\n</ol>\\n<p></p>\\n\\n\\n<!-- <h2> <A NAME=\\\"install_npm\\\"></a> Reinstalling Dependencies with npm </h2>\\n\\nNext, ensure that your theme includes all current dependencies by re-running npm, as follows:<p></p>\\n\\n<ol>\\n\\t<li>Navigate to your theme directory. This example assumes that this target directory has the default name <span class=\\\"inline-code\\\">stencil</span>:</li><p></p>\\n\\n<pre>\\ncd stencil</pre>\\n\\n\\t<li>Next, execute the following command inside of that directory:</li><p></p>\\n\\n<pre>\\nnpm install</pre>\\n</ol><p></p>\\nYou are now ready to resume development of your theme. Please proceed to <a href=\\\"/docs/launching-stencil\\\">Launching Stencil</a>. <p></p> -->\\n\\n<h2> <A NAME=\\\"next\\\"></a> Next Steps </h2>  \\n\\nLater, when you are ready to upload your customized theme to a store, you should follow the zipping and uploading instructions in <a href=\\\"https://stencil.bigcommerce.com/docs/bundling-submitting\\\">Bundling and Submitting a Theme</a> and <a href=\\\"/docs/uploading-a-custom-theme\\\">Troubleshooting Theme Uploads</a>.\"\n}\n[/block]","excerpt":"(Applies _only_ to reinstalling the Cornerstone, Diamond Classic, or Queen theme)","slug":"downloading-and-refreshing-cornerstone","type":"basic","title":"Downloading a Refreshed Cornerstone Copy"}

Downloading a Refreshed Cornerstone Copy

(Applies _only_ to reinstalling the Cornerstone, Diamond Classic, or Queen theme)

[block:callout] { "type": "info", "title": "Optional Workflow", "body": "The steps below are required only if you are downloading a refreshed copy of Stencil's default Cornerstone theme, or of the Diamond Classic or Queen theme, from the BigCommerce Theme Marketplace.\n\nIf you are downloading a _different_ Marketplace theme for customization, you must instead use the workflow outlined at <a href=\"/docs/downloading-and-customizing-marketplace-themes\">Downloading and Customizing Marketplace Themes</a>.\n\n(Cornerstone, Diamond Classic, and Queen use a simplified workflow that bypasses BitBucket requirements, and that replaces jspm with the <a href=\"https://webpack.github.io/docs/\">Webpack</a> build system. You can configure Webpack's watched folders, or substitute your own build system. For details, please see <a href=\"/docs/webpack-and-build-options\">Webpack and Build-System Options</a>.)\n\nTo keep any _custom or customized theme_ updated with the new features that BigCommerce adds to Cornerstone, please see our guidelines on [Theme Updates and Version Control](/docs/theme-updates-sync)." } [/block] [block:html] { "html": "<!-- \nIf you have just installed Cornerstone for the first time by [cloning the Stencil repo](/docs/adding-a-base-theme), skip both pages. Please proceed directly to installing the Stencil <a href=\"/docs/javascript-utilities\">JavaScript utilities</a> that are required to enable API access via Ajax.\n-->\n\nThis entry covers:\n<ul>\n\t<li><a href=\"#backup\">Back Up before Reinstalling</a>\n </li>\n\t<li><a href=\"#download_Cs\">Downloading the Cornerstone (or Queen) .zip</a>\n\t</li>\n\t<li><a href=\"#install_npm\">Reinstalling Dependencies and Relaunching</a>\n\t</li>\n\t<li><a href=\"#next\">Next Steps</a>\n\t</li>\n</ul>\n\n<a name=\"backup\"></a>" } [/block] [block:callout] { "type": "danger", "title": "Back Up before Reinstalling", "body": "If you are reinstalling over a base theme on which you have already begun development, first back up at least your theme's <span class=\"inline-code\">&lt;theme-name&gt;/.stencil</span> file. This file contains your store URL, your BigCommerce username and access tokens, and other basic settings. Preserving those settings will speed up initializing and launching the new version.\n\nTo allow complete rollback, back up your whole <span class=\"inline-code\">&lt;theme-name&gt;</span> directory. (In a current default installation, this directory is named <span class=\"inline-code\">.../cornerstone/</span>. Prior to March 2017, this directory's name defaulted to <span class=\"inline-code\">.../stencil/</span>.)" } [/block] [block:html] { "html": "<h2> <A NAME=\"download_Cs\"></a> Downloading the Cornerstone (or Diamond Classic/Queen) .zip </h2>\n\nUse these steps to download a refreshed version of the Cornerstone, Diamond Classic, or Queen theme from the store control panel's <NOBR><span class=\"inline-code\">Storefront Design</span></nobr> area: \n\n<ol>\n\t<li>If you have not yet added Cornerstone (or Diamond Classic/Queen) to your store, start at <NOBR><span class=\"inline-code\">Storefront Design</span></nobr> &gt; <NOBR><span class=\"inline-code\">Themes Marketplace</span></nobr>, and add the theme.\n <p></p></li>\n\n <ul> <!-- inner -->\n <li>Although Cornerstone is free to add, Diamond Classic and Queen require purchase.\n <p></p></li>\n\t\t</ul> <!-- inner -->\n \n\t<li>Go to <NOBR><span class=\"inline-code\">Storefront Design</span></nobr> &gt; <NOBR><span class=\"inline-code\">My Themes</span></nobr>.\n <p></p></li> \n \n\t<li>Click the Cornerstone (or Diamond Classic or Queen) theme's thumbnail:\n \n <ul> <!-- inner -->\n <li>If Cornerstone (or Diamond Classic/Queen) is the store's currently active theme, click its image thumbnail at the top of the page, under the <NOBR><span class=\"inline-code\">Current Theme</span></nobr> heading.\n <p></p></li>\n <li>If Cornerstone (or Diamond Classic/Queen) is <em>not</em> the current theme, scroll down below the lower <NOBR><span class=\"inline-code\">My Themes</span></nobr> subheading, and find and click the Cornerstone (or Diamond Classic/Queen) thumbnail.\n <p></p></li>\n\t\t</ul> <!-- inner -->\n \n The Cornerstone (or Diamond Classic/Queen) theme's description will zoom to full-page, and will display a <NOBR><span class=\"inline-code\">Theme Options</span></nobr> drop-down list at the <NOBR>upper right.</nobr>\n <p></p></li>\n\n\t<li>From the <NOBR><span class=\"inline-code\">Theme Options</span></nobr> drop-down list, select <NOBR><span class=\"inline-code\">Download theme file</span></nobr> to download this Cornerstone (or Diamond Classic/Queen) release as it was refreshed on Theme Marketplace.\n <br><p></p>\n\t\t<img src=\"https://files.readme.io/e59782a-DownloadMake-CopyCornerstone-Refreshhighlight.png\" alt=\"Theme Options &gt; Download option for freshest Cornerstone release\">\n <p></p></li>\n\n <li>Unpack the zipped theme to a working directory.\n <p></p>\n (This can be the directory where you have been developing your theme, or a new directory.)<p></p></li>\n</ol><p></p>\n\n<h2> <A NAME=\"install_npm\"></a> Reinstalling Dependencies and Relaunching </h2>\n\n<ol> \n <li>Ensure that your theme includes all current dependencies, by repeating <a href=\"/docs/javascript-utilities\">JavaScript Utilities</a> installation.\n \t<p></p></li>\n \n <li>Repeat the steps listed in the <a href=\"/docs/launching-stencil\">Launching Stencil subsection</a>.\n \t<p></p></li>\n</ol>\n<p></p>\n\n\n<!-- <h2> <A NAME=\"install_npm\"></a> Reinstalling Dependencies with npm </h2>\n\nNext, ensure that your theme includes all current dependencies by re-running npm, as follows:<p></p>\n\n<ol>\n\t<li>Navigate to your theme directory. This example assumes that this target directory has the default name <span class=\"inline-code\">stencil</span>:</li><p></p>\n\n<pre>\ncd stencil</pre>\n\n\t<li>Next, execute the following command inside of that directory:</li><p></p>\n\n<pre>\nnpm install</pre>\n</ol><p></p>\nYou are now ready to resume development of your theme. Please proceed to <a href=\"/docs/launching-stencil\">Launching Stencil</a>. <p></p> -->\n\n<h2> <A NAME=\"next\"></a> Next Steps </h2> \n\nLater, when you are ready to upload your customized theme to a store, you should follow the zipping and uploading instructions in <a href=\"https://stencil.bigcommerce.com/docs/bundling-submitting\">Bundling and Submitting a Theme</a> and <a href=\"/docs/uploading-a-custom-theme\">Troubleshooting Theme Uploads</a>." } [/block]