SPGo for Visual Studio Code
SPGo allows you and your team to develop SharePoint web solutions from your local PC using the power of Visual Studio Code. Now you can build SharePoint sites and customizations source-control first with all of the power of a top-tier IDE. Produce cleaner code, deliver faster.
- Publish files on save
- Use VSCode compare tools to diff local changes against the server
- Pull down remote folders to your local workspace
- No more editors messing with your markup
- Support for: Windows, OSX, and Unix
- Keep all project configuration in Source Control for easy team integration
Learn More
You can view additional documentation on our documentation site.
Feedback
We love feedback! Please take a minute to complete our 2-question Survey and help make SPGo better!
Features
All of the great code authoring and management features of Visual Studio Code, plus the ability to...
- Check out files from SharePoint
- Check out current file using command
>SPGo: Check Out the current file
- Check out current file with the hotkey combo:
Alt+Shift+C
- Publish files to SharePoint
- Save|publish|check-in automatically on Save
- Force publish using command
>SPGo: Publish the current file
- Publish a major version with the hotkey combo:
Alt+Shift+p
- Publish a minor version with the hotkey combo:
Alt+p
- Discard checkout using command
SPGo: Discard check out
- Specify an optional publishing message
- Retrieve the contents of a specified folder from SharePoint
- Download individual folders using the command
>SPGo: Retrieve folder
- Optionally provide glob patterns to download only specific files
- Retrieve the contents of multiple folders from SharePoint (Synchronize)
- Specify a glob pattern array of site-relative folders in the
remoteFolders configuration node (See Additional Configuration Options below)
- Download all subfolders automatically by using command
>SPGo: Populate workspace
- Glob Support
- All bulk download and upload functionality supports Glob formatting
- note: individual file wildcard support for bulk downloads is still in progress.
>SPGo: Publish local workspace supports all Glob patterns
- Manage multiple configurations
- Configuration data is stored within the project directory and can be stored in source control
- Global Access
- Support for Germany, China, and the US Government's private Office 365 deployments
- Support for SharePoint Online and 2016 + 2013 on-premise
Configuration and Getting Started
To get started using SPGo, press Ctrl+Shift+p (Windows) Cmd+Shift+p (Mac) or open the Command Pallet and type >SPGo: Configure Workspace to bring up the SPGo Configuration Wizard. Upon successful configuration, a new file will be created in the root of your project folder called spgo.json. From there, all files and folders created under the src folder in your local workspace will be deployed to their corresponding site-relative path your SharePoint site upon save.
SPGo.json Configuration Files
If configuration was successful, you should see a file similar to below:
{
"sourceDirectory": "src",
"sharePointSiteUrl": "https://tenant.sharepoint.com/sites/MyProject",
"publishingScope": "SaveOnly",
"authenticationType": "Digest"
}
Additional Configuration Options
Glob support for Publishing Workspace
Entering a Glob pattern into a node called publishWorkspaceGlobPattern will cause SPGo to publish only files which match this glob pattern. For example, if you use another VSCode plugin to minify files on save, you can configure the >SPGo: Publish local workspace command to publish all minified files in the workspace with the format <file>.min.<ext> by setting the publishWorkspaceGlobPattern property to /**/*.min.*.
Populating Remote Files
When you specify an array of remote folders in a node called remoteFolders, SPGo will recursively download the remote folder contents to your local workspace when you issue the Synchronize Files command >SPGo: Populate Workspace. Note: This WILL overwrite all local files.
Example Config json
{
"authenticationType": "Digest",
"checkInMessage" : "Your custom Check-in message here",
"sourceDirectory": "src",
"sharePointSiteUrl": "https://tenant.sharepoint.com/sites/MyProject",
"publishingScope": "SaveOnly",
"publishWorkspaceGlobPattern": "**/*.min.*",
"remoteFolders": [
"/SiteAssets/**/*",
"/_catalogs/wp/",
"/_catalogs/masterpage/"
]
}
Use
SPGo will automatically launch when you run the Configure Workspace command >SPGo: Configure workspace or any time the SPGO Configuration file spgo.json is detected in the root of the current workspace.
Security and Authentication Support
Credentials are stored in VSCode memory only. SPGo will only ask you for credentials the first time you sync with SharePoint each session. SPGo currently supports the following authentication modes:
Digest (Office365)
ADFS with username/password (Office365)
Addin-Only
App Password
NTLM v1 (most on-premise installations)
NTLM v1 + wwwAuth
NTLM v2
ADFS
A note for ADFS Authentication: You will need to add the following JSON node to the root of your your SPGo.json file:
"authenticationDetails": {
"relyingParty": "[relying party]",
"adfsUrl": "[ADFS Url]"
}
How to get in touch
Write an email, create an issue on git, @ us on twitter or request support via Stack Overflow. Any way you choose, we embrace feedback and want to hear from you. Here's how to get a hold of us:
Issues
Please submit any issues or feature requests to https://github.com/chrishasz/SPGo/issues or, better yet, author a pull request.
Open Source
This project is offered under the MIT open source license. Collaboration, contribution, and feedback is welcomed and encouraged!
Thank You
I want to thank the following developers for inspiration and source packages:
