Mac Installations

Docker Desktop

Go to the docker installation site and scroll down to the Download Docker Desktop button. Select the version of docker that relates to your CPU (Silicon or Intel).

Once the DMG is installed drag the Docker.app into your applications.

Node.js

Here are the following commands you need to run in terminal.

# Download and install nvm:
curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.40.2/install.sh | bash

# in lieu of restarting the shell
\. "$HOME/.nvm/nvm.sh"

# Download and install Node.js:
nvm install 22

If you do not have a ~/.zshrc file create one use touch ~/.zshrc

Open this file open ~/.zshrc and add the following line to the bottom of your ~/.zshrc file and hit save command + s

# Path to your node
export PATH="$HOME/.npm-global/bin:$PATH"

Finally, run source ~/.zshrc

NestJS

To download NestJS run the following command in terminal. npm i -g @nestjs/cli the -g means that you are going to download this globally on your device

Xcode, IOS simulator (Optional YOU DO NOT NEED THIS)

In the app store, search for Xcode and hit install. During instillation, it will give you the option to also download IOS phone simulator. Agree to download this too.

Opening a simulator

Open the simulator application on your mac. (command + space, then search simulator)

In the navigation bar, follow File/New Simulator.

Press Create once filled in

Android Studio

Go to the Android Studio website on your browser. Press the button Download Android Studio Meerkat and agree to the terms and conditions. Be sure to download the correct version for your mac chip.

Drag and drop android studio.app into your applications

Open Android Studio app, press open despite the warning it is being downloaded from online.

In the Projects tab press the three vertical dots on the right of the search project and then click on Virtual Device Manager

In this screen press the + sign and select the phone you want to emulate. Hit Next and then rename the emulator to something you will remember and press finish.

Homebrew

Run this is a new terminal

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

Flutter

Lets download Flutter. This step is slightly more involved so be sure not to miss any steps.

If you are running on Apple silicon you need to instal rosetta. In your terminal run the following code.

sudo softwareupdate --install-rosetta --agree-to-license

We are going to use VS Code to install flutter

1. Launch VS Code. Make sure your VS Code version is ≥ 1.86

2. In the Extensions section, type flutter and install the extension.

3. To open the Command Palette, press Command + Shift + P.

4. In the Command Palette, type flutter.

5. Select Flutter: New Project.

6. VS Code prompts you to locate the Flutter SDK on your computer.

7. Click Download SDK.

   1. Download flutter into ~/development/ directory

Once the Flutter install is complete your output display panel will show:

Building flutter tool...
Running pub upgrade...
Resolving dependencies...
Got dependencies.
Downloading Material fonts...
Downloading Gradle Wrapper...
Downloading package sky_engine...
Downloading flutter_patched_sdk tools...
Downloading flutter_patched_sdk_product tools...
Downloading windows-x64 tools...
Downloading windows-x64/font-subset tools...

After this you should get an option to download the flutter SDK path, click view instructions and follow the steps. It will take you to this link, when downloading the flutter SDK it it says it does not know where to find the SDK set the flutter folder inside of development as your flutter SDK.

To do this:

open ~/.zshrc add the following line at the bottom of your file and replace () with the pathname to your flutter/bin directory.

export PATH="$PATH:()"

command + s and then run the line source ~/.zshrc

save this file

1. VS Code may display a Google Analytics notice.

   If you agree, click OK.

2. To enable flutter in all Terminal windows:

   1. Close, then reopen all Terminal windows.

   2. Restart VS Code.

Flutter doctor

When you run flutter doctor in terminal, flutter will give you a summary of all of the dependencies that have been set up correctly. It may look something like this:

Running flutter doctor...
Doctor summary (to see all details, run flutter doctor -v):
[✓] Flutter (Channel stable, 3.29.1, on macOS 14.4.0 23E214 darwin-arm64, locale en)
[!] Android toolchain - develop for Android devices
[!] Chrome - develop for the web
[✓] Xcode - develop for iOS and macOS (Xcode 16)
[!] Android Studio (not installed)
[✓] VS Code (version 1.96)
[✓] Connected device (1 available)
[✓] Network resources


! Doctor found issues in 3 categories.

At this point if you have a [!] in front of Android Studio, come to Jack for assistance.

Flutter for Xcode (optional)

First we need to install ruby:

# Installing Ruby 
brew install rbenv ruby-build

# Adding path in .zshrc
echo 'eval "$(rbenv init - bash)"' >> ~/.zshrc
source ~/.zshrc

# installing up to date ruby version
rbenv install 3.2.2

Run the open ~/.zshrc and then past the following lines of code at the bottom of your .zshrc file.

# rbenv setup
export PATH="$HOME/.rbenv/bin:$PATH"
eval "$(rbenv init -)"

Run the next lines of codes to complete installation.

# finalise up to date ruby for cocoapods
source ~/.zshrc
rbenv global 3.2.2
rbenv rehash

# install cocoapods
sudo gem install cocoapods

Now when running flutter doctor you will see that VS CODE has an up to date version.

You are ready to start up your project.