/sfdc-dev-config

A shell script which turns your macOS laptop into an awesome Salesforce development machine.

Primary LanguageShellMIT LicenseMIT

SFDC Dev Config

SFDC Dev Config is a script to set up an macOS laptop for Salesforce.com development. It has been forked from the Laptop script (https://github.com/thoughtbot/laptop)

It can be run multiple times on the same machine safely. It installs, upgrades, or skips packages based on what is already installed on the machine.

Requirements

We support:

  • macOS Mavericks (10.9)
  • macOS Yosemite (10.10)
  • macOS El Capitan (10.11)
  • macOS Sierra (10.12)

Older versions may work but aren't regularly tested. Bug reports for older versions are welcome.

Install

Download, and execute the script:

curl -LOk https://github.com/dmgerow/sfdc-dev-config/archive/master.zip && unzip master.zip && cd sfdc-dev-config-master && sh mac 2>&1 | tee ~/sfdc-dev-setup.log

Debugging

Your last script run will be saved to ~/sfdc-dev-setup.log. Read through it to see if you can debug the issue yourself. If not, copy the lines where the script failed into a new GitHub Issue for us. Or, attach the whole log file as an attachment.

Getting this error?

chsh: /usr/local/bin/zsh: non-standard shell

Run

sudo vim /etc/shells

Add the following line to the end of your shells file:

/usr/local/bin/zsh

Or this error when trying to use rbenv?

 /usr/local/Cellar/rbenv/1.0.0/libexec/rbenv: No such file or directory

Find the solution here: https://coderwall.com/p/0o64yq/rbenv-issues-when-switching-to-zsh

What it sets up

macOS tools:

  • Homebrew for managing operating system libraries.

Unix tools:

  • Git for version control
  • OpenSSL for Transport Layer Security (TLS)
  • Zsh as your shell

Heroku tools:

GitHub tools:

  • Hub for interacting with the GitHub API

Programming languages and configuration:

  • Bundler for managing Ruby libraries
  • Node.js and NPM, for running apps and installing JavaScript packages
  • Rbenv for managing versions of Ruby
  • Ruby Build for installing Rubies
  • Ruby stable for writing general-purpose code

Databases:

  • Postgres for storing relational data
  • Redis for storing key-value data

Salesforce:

IDE:

If you choose to allow this script to configure your Sublime Application, you will receieve the following plugins:

Utilities:

It should take less than 15 minutes to install (depends on your machine).

Contributing

Fork, modify, and make a pull request.

License

It is free software that has been forked from https://github.com/thoughtbot/laptop, and may be redistributed under the terms specified in the LICENSE file.