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:
- Zsh as your shell
Heroku tools:
- Heroku Toolbelt and Parity for interacting with the Heroku API
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:
Salesforce:
- Ant for leveraging the force.com migration tool
- Java JDK is required for ant to run
- Force.com Migration Tool is an ant-based tool to access Salesforce's metadata API
- Force.com CLI is a CLI developed by Salesforce for accessing Salesforce
- Salesforce Data Loader is Salesforce's official data loading application
IDE:
- Sublime Text for coding
- MavensMate as our IDE to interface Sublime Text with Salesforce
If you choose to allow this script to configure your Sublime Application, you will receieve the following plugins:
- Package Control For managing Sublime packages
- Apex Snippets for Apex Code snippets
- DocBlockr for code comments
- GitGutter for git diff capabilities in Sublime
- Material Theme as a default Sublime theme
- MavensMate to interact with the Mavensmate app
- SublimeGit git integration with Sublime
Utilities:
- Source Tree as a GUI for git
- Google Chrome as a web browser
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.