dev-setup icon indicating copy to clipboard operation
dev-setup copied to clipboard

Setup Your Mac!

Open nelsonic opened this issue 1 year ago • 19 comments

@davcsj please read through this repo and confirm you are able to setup your MacBook with the editor etc. If you would like to add a brief section on GitHub Desktop https://github.com/apps/desktop please go ahead.

Your objective is:

  • [x] Install a text/code editor e.g. VSCode / VSCodium #37
  • [x] Setup 2 Factor auth for your GitHub account to ensure it is secured.
  • [x] Install the PostgresApp: https://postgresapp.com/downloads.html so you can run PostgreSQL (this will be later, but you can get ahead now!)
  • [x] Install Node.js: https://nodejs.org/en because you will use it on a few projects. https://stackoverflow.com/a/12570971/1148249
  • [ ] Use the terminal or GitHub Desktop to clone a repository to your Mac e.g: https://github.com/dwyl/learn-tdd -> git clone [email protected]:dwyl/learn-tdd.git
  • [ ] Follow the instructions in the cloned repo. (i.e. do the "Learn Test Driven Development" tutorial).

When you hit a "wall" (i.e. an obstacle you cannot overcome) the first thing you should do is comment on this issue describing the problem. With a screenshot where relevant. https://www.take-a-screenshot.org/mac.html 🍏 📷 Once you have commented, you can practice your Google skills attempting to solve it. 🔍 If you are still stuck after 10 minutes, drop another comment "I searched for X, but didn't find the solution". 🤷‍♂️ Then you can tap @MikeRund on the shoulder and ask him for help. 🙏 If after 10 mins You + Mike cannot overcome the obstacle, comment again: "@MikeRund and I couldn't not figure out X ..." Then you can ask me and I'll be very glad to help! 🧑‍💻 🥷

The point of this exercise is independent learning and problem solving but with a "Safety Net". 🕸️ The more you comment, the more questions you ask, the faster you will learn. 🏁

nelsonic avatar Oct 08 '24 08:10 nelsonic

I am looking at this repo now, thank you.

davcsj avatar Oct 08 '24 13:10 davcsj

My obsticle is that I don't know how to install Vscode/Vscodium. I am using google to find a solution.

davcsj avatar Oct 08 '24 14:10 davcsj

Please confirm if VSCode is compatible with your version of macOS. See: https://support.apple.com/en-us/109033 (Share the version in a comment here and then ask Google)

nelsonic avatar Oct 08 '24 14:10 nelsonic

My issue is that I am not sure from where I can download/install VSCode/Vscodium. I clicked the "download latest version" button on the website: vscodium.com, however it opens a GitHub page where I see many links and I am not sure which one to use. I am curious to know how to install it and what it will look like once installed, so I am using google to find out how.

davcsj avatar Oct 08 '24 15:10 davcsj

Did you try: https://code.visualstudio.com/download ? 💭

nelsonic avatar Oct 08 '24 15:10 nelsonic

Thanks for the reminder that we need to update the Text Editor section in the README.md: https://github.com/dwyl/dev-setup/blob/a3ef632dd90906be5dcab5c509633364ac79160a/readme.md#text-editor It currently recommends Atom but sadly, MSFT have discontinued it ... 🤦‍♂️

nelsonic avatar Oct 08 '24 15:10 nelsonic

As @MikeRund correctly says, just Googling for "how to install X" will usually give you decent instructions. Often ones I have written: https://stackoverflow.com/questions/10075990/upgrading-node-js-to-the-latest-version/12570971#12570971 😉

nelsonic avatar Oct 08 '24 15:10 nelsonic

@davcsj please please please capture what you learn along the way by sharing the links to the videos you watch and articles you read as comments in this issue. 🙏

nelsonic avatar Oct 08 '24 16:10 nelsonic

I have downloaded TOTP Authenticator to my phone in order to scan the QR code for the 2 Factor Authentication

davcsj avatar Oct 08 '24 16:10 davcsj

In the past we've used Google Authenticator on Android: https://play.google.com/store/apps/details?id=com.google.android.apps.authenticator2&hl=en&pli=1 image

TOTP looks good: https://play.google.com/store/search?q=totp+authenticator&c=apps&hl=en image

However ... not sure who binaryboot are ... 🤷‍♂️ Don't know if I would trust them with my 2FA ... 💭 https://www.binaryboot.com/totp-authenticator image

Perhaps we need to specify in this doc which App we recommend people to use. Even if it has worse reviews.

On iOS we typically use Authy: https://apps.apple.com/us/app/twilio-authy/id494168017 image

It's available on Android too: https://play.google.com/store/apps/details?id=com.authy.authy&hl=en image

It appears as though the audience of people on Android are more harsh on Authy in their Play Store reviews ... 💭

nelsonic avatar Oct 08 '24 16:10 nelsonic

I am new to the terminal so reading through this list of useful commands: https://www.codecademy.com/article/command-line-commands

davcsj avatar Oct 09 '24 09:10 davcsj

I am new to Test Driven Development (TDD) so reading through this tutorial https://github.com/dwyl/learn-tdd

davcsj avatar Oct 09 '24 14:10 davcsj

@davcsj please LMK if you get stuck. 👌

nelsonic avatar Oct 09 '24 14:10 nelsonic

I have watched this YT tutorial from 5:56 onwards as listed in the further resources in order to understand the concepts better https://www.youtube.com/watch?v=UZy1Dj9JIg4&t=356s

davcsj avatar Oct 09 '24 14:10 davcsj

Watching this tutorial listed on the resources inside learn TDD https://www.youtube.com/watch?v=qMkV_TDdDeA&t=52s

davcsj avatar Oct 09 '24 15:10 davcsj

My guess is because Authy was involved recently in a security breach [ref. 1].

I've used Google Authenticator before and then migrated to Authy after I lost my phone and couldn't get my 2FA tokens from Google Authenticator because they didn't backup your configs. Yes, Google Authenticator don't backup your configs to your Google account (like they do with any other user data on the phone, but I digress) they also don't support exporting your existing codes, so you have to manually setup each provider again. I picked Authy next because they at least provided backup and sync (although requiring an account).

The most popular replacement for Authy people I know migrated to are 2FAS, Aegis Authenticator and Bitwarden Authenticator. I also migrated from Authy.

cristianofromagio avatar Oct 10 '24 02:10 cristianofromagio

generating a new SSH key: https://docs.github.com/en/authentication/connecting-to-github-with-ssh/generating-a-new-ssh-key-and-adding-it-to-the-ssh-agent

d4vcsj avatar Nov 19 '24 17:11 d4vcsj

Had to change GitHub Username as TOTP removed from Smartphone. This is my new username. I have followed all the steps in the OP and have my Mac setup. Have cloned the Todo List Tutorial and am following it now.

d4vcsj avatar Nov 19 '24 18:11 d4vcsj

@d4vcsj how are you getting on with the Todo List Tutorial? 🧑‍💻

nelsonic avatar Jan 22 '25 07:01 nelsonic