Skip to content

Latest commit

 

History

History
309 lines (206 loc) · 12.3 KB

README.md

File metadata and controls

309 lines (206 loc) · 12.3 KB

Config

Config is a basic checklist I follow to set up a new Mac's development environment. It gets me up to speed with Git, Ruby, GitHub, Jekyll, and more so I can more quickly get back to coding.

Hello world!

File Description
.bash_profile Customizes the Terminal.app prompt and echoes the currently checked out Git branch.
.gitconfig Global Git configuration to specify my name and email, shortcuts, colors, and more.
.gitignore The ignore file from twbs/bootstrap that I use everywhere.

1. Prep OS X

Be sure to open Xcode and agree to the terms of use.

2. Prep Terminal.app

Both overlap in some functionalities, the more concise may be the Udacity configs.

MDO configs

Udacity configs

Can also follow along setup for Udacity's terminal configuration used in the learning version control course. See the udacity-terminal-config directory

3. Secure GitHub access

4. GitHub development setup

Go to 6. Additional dependencies section below before reading this section.

Download git via Homebrew brew install git, or see git docs for alternative installation guides.

Install GitHub Desktop

5. Setup Ruby

Installing and managing Ruby with rbenv allows us to specify versions of Ruby on a per-project basis. It also means we can avoid running sudo commands for installing gems and more as it's not affecting OS X's system Ruby.

Having trouble with nokogiri? See https://stackoverflow.com/a/41491487.

6. Additional dependencies

7. Setup Sublime Text 4

Enable Command Line Tool subl for Sublime Text

Sublime Text includes a command line tool, subl, to work with files on the command line. This can be used to open files and projects in Sublime Text, as well working as an EDITOR for unix tools, such as git and subversion. from ST3 Docs

Enable subl terminal commands, by entering in the terminal:

sudo ln -s "/Applications/Sublime Text.app/Contents/SharedSupport/bin/subl" /usr/local/bin/subl;

Install Sublime Merge

Add support for smerge command in .bash_profile

PATH="/Applications/Sublime Merge.app/Contents/SharedSupport/bin:{$PATH}"
export PATH

Add Source Code Pro font

Download here: https://fonts.google.com/specimen/Source+Code+Pro

Update User Settings:

"font_face": "Source Code Pro",
"font_size": 12,

Use Sublime as the default editor for git

Allows the use of ST3 to pop up when composing git commit messages, the advantage is that ST3 has a spell checker.

git config --global core.editor "subl -n -w"

Setup Package Control & Packages

Can CMD + Shift + P > Install Package > type in the below plugins

User Preferences

Add my user preferences. Check file

Set up language servers

A Language Server Protocol (LSP) is a specification about the communication protocols for use between text editors or IDEs and language servers - tools which provide language-specific features like auto-complete, go to definition, or documentation on hover.

Install Shopify theme-check LSP server. Guide for Sublime text here

Resources:

ESLINT

ToDo Directions for setting up ESLINT.

Add right click to open ST3 and Sublime Merge Options

Follow tutorial here

  1. Open Automator and create a new service
  2. Select "files or folder" option for "Services receives selected" option
  3. Left pane, select "Open Finder Items" and drag to the right pane.
  4. New in "Open with" action, select Sublime Text 3
  5. Save the new service (i.e. "Open with Sublime Text 3")
  6. Try it in Finder!

Repeat steps to add Sublime Merge as well.

8. Customize things

  • Disable LCD font smoothing
  • Configure Security & Privacy settings
    • Require password immediately
    • Show a message when screen is locked > Set Lock Message > Add Name & Phone Number
  • Hide desktop icons with defaults write com.apple.finder CreateDesktop false; killall Finder
  • Set sidebar icons to Small
  • Type faster by going to Keyboard and moving Key Repeat all the way to Fast and Delay until repeat all the way to Short.
  • Bump up the contrast, go to Accessibility and check Reduce Motion, Increase Contrast.
  • Get 24-Hour time by going to Language and Region and checking the Time Format check box.
  • Add CMD + SHIFT + . shortcut key to show/hide hidden files in Finder.app
  • Add Source Code Pro

How to Enable Tab Key for Navigating Mac Dialog Boxes & Buttons

Original article by osxdaily found here.

Quick guide:

  1. Launch System Preferences from the  Apple menu
  2. Click on the “Keyboards” preference panel
  3. Select the “Shortcuts” tab (sometimes called “Keyboard Shortcuts” in older versions of OS X)
  4. Look near the bottom of the window for a mention of “Full Keyboard Access: In windows and dialogs, press Tab to move keyboard focus between:” and click to select the radio button next to “All controls”*
  5. Close System Preferences

9. Security

10. Install GitHub Desktop App

Install GitHub Desktop App

11. Install Theme Kit Shopify CLI

View guide: https://shopify.github.io/themekit/#installation.

Download Shopify CLI which has mostly replaced Theme Kit tool.

Download via Homebrew

brew tap shopify/shopify
brew install shopify-cli

Verify

shopify version

Full guide: https://shopify.dev/themes/tools/cli/installation

12. Install Chrome Apps

13. GitHub CLI

Checkout full guide: https://cli.github.com/manual/

Install via Homebrew

brew install gh

Configure preferred text editor

gh config set editor "subl -n -w"

$ git config --global core.editor "subl -n -w"

14. VisualStudio Code

TODO: Add here.

Add GitHub commit template

See here. Just ask Gemini how to install it locally. Run the code.

git config --local commit.template .git_commit_template.txt

Use it yourself

Fork this repo, or just copy-paste things you need, and make it your own. Please be sure to change your .gitconfig name and email address though!

Supplementary Material

Works on my machine

Yup, it does. Hopefully it does on yours as well, but please don't hate me if it doesn't.

<3