UPDATE 8/18/2016 - Microsoft announced SharePoint Framework Developer Release.
SPOILER: at the end of this post you'll be able to run a web app that is provided by Yeoman generator for SharePoint. But as of now (6/2/16) it's a simple web app based on Grunt for build and Mocha/PhantomJS to run. So you won't see Client Web Part deployed to SharePoint Workbench (I think that Microsoft should update the generator soon). Still this post may be useful for people who didn't work with Node.js and front-end stacks.
Here I want to provide all the steps you need to run build and run your first SharePoint Framework project on Windows machine (it's really easier on Mac).
- Install node.js from here
- Install Ruby using RubyInstaller. Select "Add Ruby executables to your PATH"
- Install Visual Studio Code or any other IDE
- Restart your computer (VM)
- Update Ruby (here and further provided the commands for cmd):
gem update --system
- Install Compass:
gem install compass
- Install Yeoman:
npm install -global yo
- Install Gulp(everywhere is said that SharePoint Framework will use Gulp to build projects but now it's using Grunt so see next step):
npm install -global gulp
- Install Grunt:
npm install -global grunt
- Install SharePoint Generator:
npm install -global generator-sharepoint
- Install generator for Mocha app:
npm install -global generator-mocha
- Install Bower:
npm install -global bower
- Create a folder where you want to work with your project
- Scaffold your SharePoint project:
yo sharepoint
(I selected Yes to Sass and RequireJS and BDD for type of project) - Open your folder in Visual Studio Code
- Uninstall grunt-requirejs module and install grunt-contrib-requirejs module:
npm uninstall grunt-requirejs --save-dev
npm install grunt-contrib-requirejs --save-dev - Reinstall grunt-mocha module:
npm uninstall grunt-mocha --save-dev
npm install grunt-mocha --save-dev - Finally install all the modules with:
npm install
- Run
gulp server
I will try to update this post if something new appears.
Comments