The new GitHub Deploy to Salesforce Button!

September 27, 2014 by Andrew Fawcett 14 Comments

UPDATE January 2020:
The button now supports Salesforce DX source format! See here for more details.

The GitHub Salesforce Deployment tool has been one of my most successful tools to date, i’m really pleased with it and how well it has been adopted. You can read more about the inspiration and background to the tool in my original blog post here.

I recently received a very nice submission to improve the visuals of the tool when invoking it from a GitHub Readme file, in the form of the Deploy to Salesforce button image! Big thanks to Karanrajs for creating it, it looks great! I have now integrated it into the main repository and given repository owners a nice utility feature to copy and paste the required HTML markup to embed in their README files.

To use it go to the main page of the here tool, enter your details and click the Show GitHub README button code checkbox, then copy paste the code into your README file, i usually place under the title then sit back and enjoy!

For example the README file for the Apex Metadata API repository now looks like this…

Apex Wrapper Salesforce Metadata API
====================================

<a href="https://githubsfdeploy.herokuapp.com?owner=financialforcedev&amp;repo=apex-mdapi">
  <img src="https://raw.githubusercontent.com/afawcett/githubsfdeploy/master/src/main/webapp/resources/img/deploy.png" alt="Deploy to Salesforce" />
</a>

When displayed on the repository main page, we now see a shiny new button!

14 thoughts on “The new GitHub Deploy to Salesforce Button!”

Pingback: Deploy direct from GitHub to Salesforce! | Andy in the Cloud
Shivanath (@shivanathd)
September 29, 2014 at 11:47 am

Andy .. Did I mention how awesome you are ? …. This is great ! … Love all that you do for our community !

- Andrew Fawcett
  September 30, 2014 at 5:53 am
  
  Thanks so much for the kind words, i really enjoy coding tools like this and contributing to the community, feedback like this is really motivating!
  
Pat Patterson (@metadaddy)
September 29, 2014 at 6:40 pm

You could do like the Heroku button does and resolve the repo originating a button click by inspecting the referer header, doing away with the owner and repo params – see https://blog.heroku.com/archives/2014/8/7/heroku-button

Andrew Fawcett
September 30, 2014 at 5:44 am

Thats an great idea! Thanks, added to the list!

Avinava Maiti (@AvinavaM)
January 27, 2015 at 7:43 am

This is really awesome !

- Andrew Fawcett
  January 28, 2015 at 8:49 am
  
  Thanks, glad you like it!
  
Pingback: How to deploy only part of object metadata? | DL-UAT
Mark D
August 4, 2016 at 3:53 pm

Hi Andy … I’m trying to install this package, but I am getting the authentication/ip error. I think it is because I have my domain enabled. I’ve tried in another Org with the same settings and it worked.

- Andrew Fawcett
  August 4, 2016 at 5:08 pm
  
  I am not aware of an issue with this tbh. It’s standard Salesforce platform functionality the package install flow, so if it’s broken it might be a Salesforce issue. What error are you seeing?
  
Pingback: Hidden Gems: Andy's Visual Workflow Discoveries - Cloud Co-Op
Igor Androsov
May 9, 2017 at 12:57 pm

Hi Andy can this tool (deploy button) be configured to use with private github repository? I did not see any instructions in readme or blogs on this topic

- Andrew Fawcett
  May 15, 2017 at 12:25 am
  
  Yes that’s supported
  
Pingback: Lightning Prototypes Repository