Onboarding

Mac Development Environment Setup Guide

Welcome to the team! This guide will help you set up your MacBook for development. Follow these steps to install the necessary tools and software.

1. Install Homebrew

Homebrew is a package manager for macOS. Install it by running this command in Terminal:

/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"

2. Install Git

Git is essential for version control. Install it using Homebrew:

brew install git

3. Install NVM (Node Version Manager)

NVM allows you to manage multiple Node.js versions. Install it using this command:

brew install nvm

After installation, close and reopen your terminal, then run:

nvm install --lts

This installs the latest LTS version of Node.js.

4. Install Laravel Herd

Laravel Herd is a native macOS application that provides a complete PHP development environment. To install:

  1. Visit the Laravel Herd website (opens in a new tab)
  2. Download the latest version
  3. Open the downloaded .dmg file and drag Laravel Herd to your Applications folder
  4. Launch Laravel Herd from your Applications folder

5. Install Visual Studio Code

VS Code is a popular code editor. Download it from the official website (opens in a new tab) or install it using Homebrew:

brew install --cask visual-studio-code

5.1 VS Code Plugins

Our recommendations for optimal settings:

{
  "editor.formatOnSave": true,
  "[javascript]": {
    "editor.defaultFormatter": "esbenp.prettier-vscode"
  },
  "emmet.includeLanguages": {
    "javascript": "javascriptreact"
  },
  "editor.codeActionsOnSave": {
    "source.fixAll.eslint": true
  }
}

5.2 Recommended Extensions

6. Configure Git

Set up your Git identity:

git config --global user.name "Your Name"
git config --global user.email "your.email@example.com"

7. Install Discord

We use Discord to stay in sync with our projects and work. You can download (opens in a new tab) and install it as any other Mac app.

Ask the Lucky Media PM for an Invite to our server

Optional Applications

Next Steps

  1. Clone the project repositories you'll be working on
  2. Set up your SSH keys for GitHub/GitLab
  3. Install any project-specific dependencies
  4. Familiarize yourself with our coding standards and workflows

If you encounter any issues during setup, don't hesitate to ask for help from your team lead or colleagues.

Happy coding!

IntroductionFrontend