{"id":21655887,"url":"https://github.com/koltyakov/generator-sppp","last_synced_at":"2025-04-06T06:10:21.914Z","repository":{"id":10722966,"uuid":"66716306","full_name":"koltyakov/generator-sppp","owner":"koltyakov","description":"🐾 SP Pull-n-Push - Yeoman generator for SharePoint client-side applications","archived":false,"fork":false,"pushed_at":"2025-03-26T08:29:04.000Z","size":8972,"stargazers_count":65,"open_issues_count":21,"forks_count":12,"subscribers_count":10,"default_branch":"master","last_synced_at":"2025-03-30T03:05:16.197Z","etag":null,"topics":["assets","developer-tools","generator","pnpjs","react","scaffolding","sharepoint","sharepoint-online","typescript","webpack","yeoman-generator"],"latest_commit_sha":null,"homepage":"","language":"TypeScript","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/koltyakov.png","metadata":{"files":{"readme":"README.md","changelog":"CHANGELOG.md","contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null}},"created_at":"2016-08-27T13:40:19.000Z","updated_at":"2025-01-26T17:14:09.000Z","dependencies_parsed_at":"2024-04-29T20:52:49.740Z","dependency_job_id":"b825aa28-6d1d-4d80-b6e2-f1458aeba38f","html_url":"https://github.com/koltyakov/generator-sppp","commit_stats":{"total_commits":257,"total_committers":7,"mean_commits":"36.714285714285715","dds":0.5252918287937743,"last_synced_commit":"f73fe9afc002284209ffa9dd3117fee8a5af2f76"},"previous_names":[],"tags_count":0,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/koltyakov%2Fgenerator-sppp","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/koltyakov%2Fgenerator-sppp/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/koltyakov%2Fgenerator-sppp/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/koltyakov%2Fgenerator-sppp/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/koltyakov","download_url":"https://codeload.github.com/koltyakov/generator-sppp/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":247441053,"owners_count":20939239,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["assets","developer-tools","generator","pnpjs","react","scaffolding","sharepoint","sharepoint-online","typescript","webpack","yeoman-generator"],"created_at":"2024-11-25T08:37:38.919Z","updated_at":"2025-04-06T06:10:21.881Z","avatar_url":"https://github.com/koltyakov.png","language":"TypeScript","funding_links":[],"categories":[],"sub_categories":[],"readme":"# SPPP Generator\n\n\u003e [Yeoman](http://yeoman.io/) generator for SharePoint client-side applications\n\n[![NPM](https://nodei.co/npm/generator-sppp.png?mini=true\u0026downloads=true\u0026downloadRank=true\u0026stars=true)](https://nodei.co/npm/generator-sppp/)\n\n[![npm version](https://badge.fury.io/js/generator-sppp.svg)](https://badge.fury.io/js/generator-sppp)\n[![Downloads](https://img.shields.io/npm/dm/generator-sppp.svg)](https://www.npmjs.com/package/generator-sppp)\n![Build Status](https://dev.azure.com/koltyakov/SPNode/_apis/build/status/generator-sppp?branchName=master)\n[![FOSSA Status](https://app.fossa.io/api/projects/git%2Bgithub.com%2Fkoltyakov%2Fgenerator-sppp.svg?type=shield)](https://app.fossa.io/projects/git%2Bgithub.com%2Fkoltyakov%2Fgenerator-sppp?ref=badge_shield)\n[![Gitter chat](https://badges.gitter.im/gitterHQ/gitter.png)](https://gitter.im/sharepoint-node/Lobby)\n\nYeoman generator for SharePoint - lets you quickly set up a project with sensible defaults for pulling and pushing files between SharePoint asset library and local project's sources.\n\nThe 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.\n\nSPPP generated projects suite perfectly for SPA development scenarios having local serve workbench with SharePoint API proxy server integrated 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.\n\nReact, PnPjs, Office UI Fabric, TypeScript, SCSS, Linting rules, polyfills, Webpack bundling, Live server, SharePoint interactive connection, [pipeline tasks](https://github.com/koltyakov/sp-build-tasks), all of these just work from the start. The batteries are included, but maybe you need configuration changes? No problem, just override or provide yours, or extend a task, this is a part of the design.\n\nDon't need React or Office UI Fabric? Don't worry, these guys are installed as a presets only when you decided to.\n\n## Development scenarios\n\n- Web-parts development\n  - classic CEWPs\n  - SPA applications\n- Branding\n  - masterpages\n  - page layouts development\n- Custom actions (ScriptLink User Custom Action)\n- Custom scripts and portal libraries\n- Custom styles\n- Direct edit assets with Git backup (like in SPD days, or [SPGo](https://marketplace.visualstudio.com/items?itemName=SiteGo.spgo) but using CLI)\n\n## Supported SharePoint versions\n\n- SharePoint Online\n- SharePoint On-Prem (2019/2016/2013)\n- SharePoint 2010 (limited support)\n\n## How to use\n\n### Using NPX (without Yeoman and generator global installation)\n\nCreate and navigate to project folder then run:\n\n```bash\nnpx -p yo -p generator-sppp -c 'yo sppp'\n```\n\nNPM v6 is required.\n\n### Global install (classic approach)\n\n#### Install\n\nTo use Yeoman, one need to has Node.js and NPM installed on the computer. A basic installation process description can be found in [this blog post](https://www.linkedin.com/pulse/preparing-development-machine-client-side-sharepoint-mac-koltyakov?trk=pulse_spock-articles).\n\nAlter Node.js and NPM are staffed, install `Gulp`, `Yeoman` and `generator-sppp` globally in your Node.js environment.\n\n```bash\nnpm install -g gulp-cli yo generator-sppp\n```\n\n`gulp-cli` global installation can be omitted while using NPM tasks.\n\n#### Generate\n\nMake a new directory or clone a blank Git project of your own and navigate to the created folder.\n\nInside project directory execute:\n\n```bash\nyo sppp\n```\n\nThen follow the Yeoman wizard instructions:\n\n![Generator in action](./assets/sppp01.gif)\n\n#### Package managers switch\n\nWith `--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.\n\nUse `yarn`:\n\n```bash\nyo sppp --pm yarn\n```\n\nUse `pnpm`:\n\n```bash\nyo sppp --pm pnpm\n```\n\n### Define connection with SharePoint\n\n```bash\nnpm run connect\n```\n\n![Connect with SharePoint](./assets/sppp02.gif)\n\n### Dev Server \u0026 API Proxy\n\n```bash\nnpm run start\n```\n\n![Dev Server](./assets/sppp03.gif)\n\n### Sync with SharePoint\n\nNow you can run gulp [sppull](https://www.npmjs.com/package/sppull) task:\n\n```bash\ngulp pull\n```\n\n![SPPull in action](http://koltyakov.ru/images/generator-sppp-demo-2.gif)\n\nIt will deliver all files from the assets folder in SharePoint to the local directory.\n\nRun npm watch task before starting editing files:\n\n```bash\nnpm run watch\n```\n\nOn files change they are uploaded and published to SharePoint with use of [gulp-spsave](https://www.npmjs.com/package/gulp-spsave).\n\nFor publishing files from `./dist` folder the `publish` task can be used:\n\n```bash\nnpm run publish\n```\n\n### Additional Gulp tasks\n\nAvailable tasks list:\n\n```bash\ngulp --tasks\n```\n\n#### Watch changes of the assets with live reload\n\n```bash\ngulp live\n```\n\nCheck [sp-live-reload project page](https://github.com/koltyakov/sp-live-reload) more information.\n\n## Tasks detail information\n\nPlease check a reference in [this wiki page](https://github.com/koltyakov/sp-build-tasks/wiki/Tasks).\n\n## Build configuration details\n\nSPPP is powered with `sp-build-tasks`, build configs can be found in a [wiki section](https://github.com/koltyakov/sp-build-tasks/wiki/Build-options) of the project.\n\n![app.json settings](https://raw.githubusercontent.com/koltyakov/sp-build-tasks/master/docs/schema.gif)\n\n## Configuring CI/CD\n\nCheckout [this end-to-end sample](https://github.com/koltyakov/sppp-cicd-sample).\n\n## SharePoint communication layer\n\n- [sppull](https://github.com/koltyakov/sppull) library is used for downloading files from SharePoint\n- [gulp-spsave](https://github.com/s-KaiNet/gulp-spsave) library is used for saving files to SharePoint\n- [sp-request](https://github.com/s-KaiNet/sp-request) and [node-sp-auth](https://github.com/s-KaiNet/node-sp-auth) are in charge for low level communication with SharePoint\n- [sp-live-reload](https://github.com/koltyakov/sp-live-reload) library is used for instantaneous page reload\n- [node-so-auth-config](https://github.com/koltyakov/node-so-auth-config) authentication config wizard\n- [sp-build-tasks](https://github.com/koltyakov/sp-build-tasks) build tasks tool-belt\n\nCommunication layer settings are stored in `./config/private.json`, parameters settings description can be found [here](https://github.com/s-KaiNet/node-sp-auth/wiki).\n\n## License\n\n[![FOSSA Status](https://app.fossa.io/api/projects/git%2Bgithub.com%2Fkoltyakov%2Fgenerator-sppp.svg?type=large)](https://app.fossa.io/projects/git%2Bgithub.com%2Fkoltyakov%2Fgenerator-sppp?ref=badge_large)\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fkoltyakov%2Fgenerator-sppp","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fkoltyakov%2Fgenerator-sppp","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fkoltyakov%2Fgenerator-sppp/lists"}