Run the Odin Recipes Site Locally by Scott MichaelRun the Odin Recipes Site Locally by Scott Michael

Run the Odin Recipes Site Locally

Portfolio project
Scott Michael
Self-directed technical documentation sample
A beginner-friendly Mac setup guide for my Odin Recipes website, built while learning HTML through The Odin Project.

Why I made this

I built Odin Recipes while learning HTML through The Odin Project. For this documentation sample, I focused on a separate task: helping a first-time reader get a local copy running without having to infer the steps between downloading the files and opening the site.

What I focused on

I put prerequisites before commands, gave each step an observable result, and explained how to recognize a local preview. The guide also includes one troubleshooting case tied to the actual file structure: a missing Pancakes image.

How I checked it

I reviewed the instructions against the repository and completed a guided fresh-clone walkthrough on my Mac. The clone succeeded, Safari opened the local homepage, and all three recipe pages displayed their images and returned Home correctly. The walkthrough identified a useful addition: an explicit command to open the site in Safari.
This is a self-directed sample based on my own learning project. It does not represent client work or a usability study.

Run the Odin Recipes Site Locally on a Mac

Download a copy of the recipe website and open it in Safari. By the end, you will be able to view Lasagna, Scrambled Eggs, and Pancakes and return to the homepage from each recipe.

Before you start

You need:
A Mac with Safari and Terminal.
Git installed and available in Terminal.
An internet connection to download the repository.
The site contains HTML pages and JPEG images. You do not need Node.js, a package installation, a build command, or a local server. After the download, keep the project folder together so its links and images continue to work.

1. Check Git

Open Terminal from Applications → Utilities. Run:
git --version
You should see a Git version number. If Git is unavailable or an installation prompt appears, finish setting up Git before continuing.

2. Create a separate folder

Run each command below on its own line, pressing Return after each one:
cd ~ mkdir odin-recipes-preview cd odin-recipes-preview
The first command moves to your home folder. The next two create and enter a separate folder for this preview.
If Terminal says the folder already exists, choose an unused name and use that same name in both the mkdir and cd commands. Continue only after you have entered the new folder successfully.

3. Clone the repository

Cloning downloads the project files and their Git history. Run:
git clone https://github.com/Scotty723/odin-recipes.git
Wait for the command to finish. You should see a new folder named odin-recipes inside your preview folder. It contains index.html, README.md, and a recipes folder.
If cloning fails, stop here. Do not run the next commands until the clone succeeds.

4. Open the homepage in Safari

Run these commands one at a time:
cd odin-recipes open -a Safari index.html
The first command enters the downloaded project. The second opens its homepage in Safari.
You should see the heading Odin Recipes and links for Lasagna, Scrambled Eggs, and Pancakes. You are viewing a local file, rather than a page on GitHub. The page uses basic browser formatting, so a plain appearance is expected.

5. Check the recipes

Select Lasagna. Confirm that its picture and the Description, Ingredients, and Steps sections appear.
Select Home. Confirm that you return to Odin Recipes.
Repeat these checks for Scrambled Eggs and Pancakes.
You are finished when all three recipes open with their pictures and every Home link returns to the homepage. The downloaded pages can be browsed without an internet connection.

Troubleshooting: the Pancakes image is missing

What you might see: The recipe text appears, but its picture is missing or the browser shows alternative text or a broken-image icon.
Check the files: In Finder, open your home folder, then odin-recipes-preview → odin-recipes → recipes → images. If you chose a different preview folder name, use that folder instead. Confirm that pancakes.jpeg is present. Check the exact spelling, capitalization, and .jpeg extension; .jpg is a different filename.
The page recipes/pancakes.html refers to its image as ./images/pancakes.jpeg. This means the images folder must remain inside recipes, beside the recipe HTML files.
Restore the complete project: If you moved, renamed, or omitted files, repeat the cloning steps in a new preview folder. Keep any copy containing your own edits separate. Open the new copy's index.html, then select Pancakes.
Confirm the fix: Check that the picture appears and that Home returns to the homepage.

0 likes · 0 views · Nov 22, 2026

Self-directed Mac setup guide covering Git, Safari, expected results, and troubleshooting. Verified with a fresh-clone walkthrough.

Tags