generator-sppp
🐾 SP Pull-n-Push - Yeoman generator for SharePoint client-side applications
Last updated
Was this helpful?
🐾 SP Pull-n-Push - Yeoman generator for SharePoint client-side applications
Last updated
Was this helpful?
Yeoman generator for SharePoint - lets you quickly set up a project with sensible defaults for pulling and pushing files between SharePoint asset library and local projects sources.
Generated project allows immediately start developing SharePoint client-side solutions in Visual Studio Code or any other editor with instant publishing changes to SharePoint web site and downloading specific assets from SP Document library folder to local project assets which can be enforced with Git Diff algorithm for tracking changes.
SPPP generated projects suite perfectly for SPA development scenarious having local serve workbench with SharePoint API proxy server intergated from OOTB. Starting a local server your app refreshes instantly on changes using hot reload and incremental build at the same time the app is fully powered with real data from the API without any extra configuration.
React, PnPjs, Office UI Fabric, TypeScript, SCSS, Linting rules, polyfills, Webpack bundling, Live server, SharePoint interactive connection, , all of these just work from the start. The batteries are included, but maybe you need congifuration changes? No problem, just override or provide yours, or extend a task, this is a part of the design.
Don't need React or Office UI Fabric? Don't worry, these guys are installed as a presets only when you decided to.
Webparts developement
classic CEWPs
SPA applications
Branding
masterpages
page layouts development
Custom actions (ScriptLink User Custom Action)
Custom scripts and portal libraries
Custom styles
Direct edit assets with Git backup (like in SPD days, or but using CLI)
SharePoint Online
SharePoint On-Prem (2019/2016/2013)
SharePoint 2010 (limited support)
Create and navigane to project folder then run:
NPM v6 is required.
Install
Alter Node.js and NPM are staffed, install Gulp
, Yeoman
and generator-sppp
globally in your Node.js environment.
gulp-cli
global installation can be omitted while using NPM tasks.
Generate
Make a new directory or clone a blank Git project of your own and navigate to the created folder.
Inside project directory execulte:
Then follow the the Yeoman wizard instructions:
Package managers switch
With --package-manager
(or --pm
), a package manager can be selected. Possible managers are: pnpm
, yarm
and npm
. npm
is used by default and also as a fallback option.
Use yarn
:
Use pnpm
:
It will deliver all files from assets folder from SharePoint to local directory.
Run npm watch task before starting editing files:
For publishing files from ./dist
folder the publish
task can be used:
Available tasks list:
Watch changes of the assets with live reload
To use Yeoman, one need to has Node.js and NPM installed on the computer. Basic installation process description can be found in .
Now you can run gulp task:
On files change they are uploaded and published to SharePoint with use of .
Check more information.
Please check a reference in .
SPPP is powered with sp-build-tasks
, build configs can be found in a of the project.
library is used for downloading files from SharePoint
library is used for saving files to SharePoint
and are in charge for low level communication with SharePoint
library is used for instantaneous page reload
authentication config wizard
build tasks tool-belt
Communication layer settings are stored in ./config/private.json
, parameters settings description can be found .
Checkout .