{"_id":"5660d2bee163310d006b19c1","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":26,"project":"55a6e72e8cc73e0d00096635","user":"55a6caa022cfa321008e01d6","category":{"_id":"5605f2bba4574a0d00811365","__v":26,"pages":["5608e4d6c5cff70d007d00d5","5608e4e7c5cff70d007d00d8","5608e4fbc5cff70d007d00da","5608e5096d8c440d000c79f3","5608e5156d8c440d000c79f6","5608e52331beb60d001b6558","5608e8248aedf50d0004cf98","5608e87e8aedf50d0004cf9b","5609bf4f9f85a70d00908530","562822dd5cfea90d00ddc5d7","562831c40653060d00a2f750","563d2732260dde0d00c5eab1","5660d2bee163310d006b19c1","567bb35b93919f0d00c97b1c","567bba643241c20d00b730de","567bbc14b56bac0d0019d933","567bc0473241c20d00b730e5","568b6bd8fe6fcc0d006dc8f7","56a427125fb2530d00421b67","56a42a5194ec0a0d00b3a012","56a42aaa545bc50d000e3ada","56ddff97bea78e20003a778f","56de00ab26744429006648ba","56de12a33168720e00c11b02","56e37f388b32a10e00f79755","56e73362e622c90e00dc55b3"],"project":"55a6e72e8cc73e0d00096635","version":"55a6e72f8cc73e0d00096638","sync":{"url":"","isSync":false},"reference":false,"createdAt":"2015-09-26T01:19:55.795Z","from_sync":false,"order":2,"slug":"installation-and-launch","title":"Installation and Launch"},"parentDoc":null,"updates":[],"next":{"pages":[],"description":""},"createdAt":"2015-12-03T23:39:42.700Z","link_external":false,"link_url":"","githubsync":"","sync_unique":"","hidden":false,"api":{"settings":"","results":{"codes":[]},"auth":"required","params":[],"url":""},"isReference":false,"order":6,"body":"[block:html]\n{\n  \"html\": \"<A NAME=\\\"CloneBaseTheme\\\"></a>Now that the Stencil CLI is installed, we will add a base theme to your local Stencil environment.<br>\"\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 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>. Use these substitutions throughout this page.)\"\n}\n[/block]\n\n[block:html]\n{\n  \"html\": \"To add the base theme:<br>\\n\\n<ol>\\n  <li>Navigate to a directory where you have appropriate write permissions, and in which you want to install a subdirectory for your theme. \\n  </li><p></p>\\n\\n<li>Execute the following command, to clone the base Stencil theme into a new subdirectory named <span class=\\\"inline-code\\\">.../cornerstone/</span>:<p></p>\\n\\n<pre>git clone https://github.com/bigcommerce/cornerstone.git</pre>\\n  \\n  If the above command fails, and you are accessing GitHub anonymously, give the URL this alternate prefix:<p></p>\\n\\n<pre>git clone git://github.com/bigcommerce/cornerstone.git</pre>\\n  </li>\\n</ol>\\n\\n<!-- Add a note here: If downloading a marketplace theme, must install jspm, register your jspm instance, and set up BitBucket access...  -->\\n\\n<br><!-- If you are installing Stencil for the first time, then in--> In the next step, you will install Stencil <a href=\\\"/docs/javascript-utilities\\\">JavaScript utilities</a> to enable API access via Ajax.\"\n}\n[/block]","excerpt":"","slug":"adding-a-base-theme","type":"basic","title":"Adding a Base Theme"}

Adding a Base Theme


[block:html] { "html": "<A NAME=\"CloneBaseTheme\"></a>Now that the Stencil CLI is installed, we will add a base theme to your local Stencil environment.<br>" } [/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 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>. Use these substitutions throughout this page.)" } [/block] [block:html] { "html": "To add the base theme:<br>\n\n<ol>\n <li>Navigate to a directory where you have appropriate write permissions, and in which you want to install a subdirectory for your theme. \n </li><p></p>\n\n<li>Execute the following command, to clone the base Stencil theme into a new subdirectory named <span class=\"inline-code\">.../cornerstone/</span>:<p></p>\n\n<pre>git clone https://github.com/bigcommerce/cornerstone.git</pre>\n \n If the above command fails, and you are accessing GitHub anonymously, give the URL this alternate prefix:<p></p>\n\n<pre>git clone git://github.com/bigcommerce/cornerstone.git</pre>\n </li>\n</ol>\n\n<!-- Add a note here: If downloading a marketplace theme, must install jspm, register your jspm instance, and set up BitBucket access... -->\n\n<br><!-- If you are installing Stencil for the first time, then in--> In the next step, you will install Stencil <a href=\"/docs/javascript-utilities\">JavaScript utilities</a> to enable API access via Ajax." } [/block]