Getting Started

#Introduction Welcome to Sitecore Foundation, our development accelerator for Sitecore. Used on several large projects, this has a collection of common features that will solve many common requirements.

Sitecore Foundation has been completely refactored to leverage Helix Principles.

#Getting Started

Please note that the project assumes the following settings:

Source location: C:\sitecoreFoundation\
Website location: C:\websites\sf.dev.local\
Website URL: http://sf.dev.local/ StarterKit URL: http://starterKit.dev.local/

To change these settings see the "Configuring your settings" below

Prerequisites

Important!: Always run your Visual Studio or Command Line with elevated privileges or As Administrator

Please check the [Resources] page for the tools needed

To install:

1. Clone this repository to your local file system.
2. (optional) Configure your settings if you are using settings other than the defaults:
   • The default settings for Sitecore Foundation are
     • URL: http://sf.dev.local/
     • Location: *C:\Websites\sf.dev.local*
   • To change the standard location of the source files, website files and website URL, modify the following files:
     • Please be aware to include or omit trailing slashes - as per the default
     • /src/Project/StarterKit/code/App_Config/Include/Project.StarterKit/z.StarterKit.DevSettings.config
     • /gulp-config.js
     • /publishsettings.targets
3. Set up a clean Sitecore install with the settings from the previous step
   • We recommend using Sitecore Instance Manager for the install.
   • Please note that the Sitecore executable installer does not support periods in the domain name and therefore if you are installing using this, please change the default domain (see step 2).
   • SitecoreFoundation requires:
     • Sitecore Experience Platform 8.2 Update 4 in Experience Platform or Experience Management mode

Note that there are separate branches that support Sitecore 9 and Sitecore 9.1.

4. Restore Node.js modules: In an elevated privileges command prompt (started with Run as administrator), run 'npm install' in the root of repository. Notes:
   • Make sure you have version 4+ of node.js Download here
   • You may want to use the Node.JS command prompt instead of the regular command prompt so that paths to Note.JS and other concerns are already set
   • Also Run **'npm install -g windows-build-tools' (avoids python issue)
5. Build and publish the solution using either:
   • Open an command window with elevated privileges and run 'gulp' in the root of repository.
   • Use Visual Studio:

     • Open Visual Studio 2015 in administrator mode by right-clicking on its icon and selecting Run as administrator.

     • Open the SitecoreFoundation solution.

     • Configure the Sitecore Nuget Feed in your nuget package configuration (https://doc.sitecore.net/sitecore_experience_platform/developing/developing_with_sitecore/sitecore_public_nuget_packages_faq)

     • Open the Visual Studio 2015 Task Runner Explorer pane (View | Other Windows | Task Runner Explorer).

     • Switch to "Solution 'Habitat'"

     • Run the "default" task

Gulp

The project is configured to run Gulp through the command line or using the Task Runner Explorer pane in Visual Studio 2015.

In the initial installation running the default task will execute all the configuration and building tasks for the solution. If for some reason setup fails, it is possible to run the install tasks one by one:

• 01-Copy-Sitecore-Lib will copy the assemblies from the Sitecore website to the solution
• 02-Nuget-Restore restores the nuGet packages used by all projects in the solution
• 03-Publish-All-Projects builds and publishes all the Visual Studio projects to the Sitecore website in the right order
• 04-Apply-Xml-Transform makes the needed changes to the web.config in the Sitecore website
• 05-Sync-Unicorn runs a complete synchronization of Unicorn for all projects in the right order

Helper tasks

• The Auto-Publish-[...] tasks help by automatically publishing files when they are changed.
  • The Auto-Publish-Css automatically publishes .css files when changed (Configure Sass compilation in Visual Studio)
  • The Auto-Publish-Assemblies task publishes assemblies as they are built using the standard Visual Studio build process
  • The Auto-Publish-Views task publishes .cshtml files when they are changed.
• The Publish-[...] tasks helps you by manually publishing different types of files or project types to your website.