add step-by-step mac tutorial

Author: lee2sman

docs/assets/tutorials/mac/install-mac1.webp

@@ -52,6 +52,8 @@ In the Terminal, you can run `love path/to/main.lua`. Or if you are in the folde
 
 ### Mac
 
+**[There is a step-by-step Mac installation tutorial](tutorials/install-mac.md)**
+
 Drag and drop the folder holding L5.lua and your main.lua onto the Love application, being sure to add `printToScreen()` to your setup function to be able to see `print()` output.
 
 OR

docs/assets/tutorials/mac/install-mac2.webp

@@ -0,0 +1,24 @@
+# Installation on Mac
+
+This tutorial walks you through installing Love (Love2d) and the L5 Starter project on your Macintosh computer.
+
+1. Go to the [Love website](https://love2d.org) and click to download the 64-bit zipped Mac program.
+![Love2d website with downloads](/assets/tutorials/mac/install-mac1.webp "Love2d website with downloads")
+2. Click **"Allow"** when it asks 'Do you want to allow downloads on "love2d.org"?' It will download to your *Downloads* folder by default.
+![Alert box asking permission to download Love2d](/assets/tutorials/mac/install-mac2.webp "Alert box asking permission to install Love2d")
+3. From the L5lua.org Download page, [download the L5 Starter project](/L5-starter.zip).
+![L5 website download page with L5 Starter](/assets/tutorials/mac/install-mac3.webp "L5 website download page with L5 Starter")
+4. Click **"Allow"** when it asks 'Do you want to allow downloads on "l5lua.org"?'
+![Alert box asking permission to download L5-Starter](/assets/tutorials/mac/install-mac4.webp "Alert box asking permission to download L5 Starter")
+5. Return to your *Downloads* folder on your computer. **Right click with two fingers** on the Love application icon. Choose "Open".
+![Folder with love application and L5 Starter folder](/assets/tutorials/mac/install-mac5.webp "Folder with love application and L5 Starter folder")
+6. A warning popup box opens with the title 'macOS cannot verify the developer of "love". Are you sure you want to open it?'. Click **Open.**
+![Alert box stating macOS cannot verify the developer of love. The correct option is Open.](/assets/tutorials/mac/install-mac6.webp "Alert box stating macOS cannot verify the developer of love. The correct option is Open")
+7. You should see a window open with a flying bird-shaped balloon and clouds, verifying that Love is now properly installed on your computer. Close the window.
+![A flying bird-shaped balloon and cartoon clouds](/assets/tutorials/mac/install-mac7.webp "A flying bird-shaped balloon and cartoon clouds")
+8. Back in your downloads folder, **drag the L5-starter folder onto the Love application**. It should now launch and you should see a new window open with your code sketch.
+![A yellow background window appearing on top of folder holding L5 Starter and love application](/assets/tutorials/mac/install-mac8.webp "A yellow background window appearing on top of folder holding L5 Starter and love application")
+
+### Next Steps
+
+Congratulations. You've installed Love and have L5 on your computer and verified you can run your own programs. Inside the L5-Starter folder you can open the `main.lua` file in a text editor to edit the program. Save your modifications, then again drag and drop the L5 Starter folder on the love application to see it run. Check out the [tutorials](index.md) page to learn more.