lattirance.github.io

L’Attirance setup

This file is the source of truth for getting the project running.
A person can follow it. An AI agent should follow it exactly.

Live site: lattirance.com (canonical). lattirance.co.za redirects to the .com.
Repo: jleroux1988/lattirance.github.io

Not technical? Start here

Install Cursor (only needed so you can ask an agent to do the rest).
Open this project folder in Cursor (lattirance).
In chat, say:

Set up this project
Approve installs when Cursor asks. If the Mac password prompt appears, type it there (it will not show as you type). That is normal.
Day-to-day editing is in IntelliJ IDEA. The agent will install it. After setup, open this folder there.

If you are an agent: skip the section above and run Agent playbook below. Talk in plain language. Do the work. Do not dump a wall of commands for the user to copy unless something needs their password or a browser click.

Agent playbook

Goal: leave a working local copy of L’Attirance on this machine, with Homebrew and IntelliJ ready.

Rules:

Assume the user may have no technical background.
Check before installing. Skip anything already present.
Homebrew does not ship with macOS. Install Homebrew before any brew install … step, and before Git-via-brew, IntelliJ, or Ruby.
Never change the root CNAME file. It must stay lattirance.com (canonical). lattirance.co.za redirects to the .com at the registrar — do not add .co.za to CNAME.
Do not commit, push, or publish unless the user asks.
Do not mix Obsidian vault notes into this repo.
If a step needs a password or GUI approval, pause and tell the user exactly what to do, then continue after they confirm.
This project targets macOS first. If the OS is not macOS, say so and adapt carefully.
The primary IDE is IntelliJ IDEA. Cursor is only an optional way to run this setup.

1. Homebrew (do this first)

macOS does not include Homebrew. Everything below that uses brew depends on this step.

brew --version

If that fails, install with the official script:

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

This often needs:

The Mac login password
Xcode Command Line Tools (a system popup or a long install)

Wait until those finish. Then put brew on PATH if it is not already (Apple Silicon is usually this):

eval "$(/opt/homebrew/bin/brew shellenv)"

If ~/.zprofile does not already contain that eval line, append it so new terminals find Homebrew.

Do not continue until brew --version works.

2. Git

git --version

If Git is missing: brew install git.

3. Confirm you are in the right folder

Expected path ends with lattirance.
Expected remote: git@github.com:jleroux1988/lattirance.github.io.git

If the folder is empty or not a git repo, clone:

git clone git@github.com:jleroux1988/lattirance.github.io.git .

If SSH clone fails, diagnose:

Git installed? (git --version)
SSH key exists? (ls ~/.ssh/id_ed25519.pub)
GitHub host key trusted? If known_hosts is missing github.com, add official keys with ssh-keyscan.
ssh -T git@github.com should greet jleroux1988 (or the user’s GitHub username).

If they have no SSH key, create one (ssh-keygen -t ed25519 -C "their-email"), show the public key, and wait while they add it at GitHub SSH keys.

4. IntelliJ IDEA

This is the IDE we work in. Check Applications (or Spotlight) for IntelliJ IDEA or IntelliJ IDEA CE.

If neither is installed:

brew install --cask intellij-idea-ce

That is the free Community Edition. If the user already has a JetBrains license and wants Ultimate instead, install intellij-idea (not -ce) and skip CE.

After install, they can open this lattirance folder from IntelliJ: File → Open.

5. Ruby and Bundler (local site preview)

This is a GitHub Pages site. Local preview uses Ruby + Bundler + Jekyll (via the github-pages gem).

macOS system Ruby is often locked down. Prefer Homebrew Ruby:

brew install ruby

Then ensure ruby and gem on PATH are the Homebrew ones, and install Bundler:

gem install bundler
bundle --version

6. Project gems

If a Gemfile exists:

bundle install

Gemfile.lock is gitignored on purpose (GitHub Pages uses its own gem versions). That is expected.

If there is no Gemfile yet:

Still finish tool install (Homebrew, Git, IntelliJ, Ruby, Bundler).
Tell the user the site content/tooling is not scaffolded, so there is nothing to preview locally yet.
Do not invent a full website. Only create a Gemfile / Jekyll scaffold if the user asks to start building the site.

7. Preview locally (only if the site can be built)

If Gemfile and site files exist:

bundle exec jekyll serve

Open http://127.0.0.1:4000.
The public site stays on lattirance.com via GitHub Pages after pushes to main. lattirance.co.za should keep redirecting there.

8. Report back

Give a short plain-language summary:

Item	Status
Homebrew	ok / installed / blocked
Git	ok / installed / blocked
GitHub SSH	ok / needs key / blocked
IntelliJ IDEA	ok / installed CE / installed Ultimate / blocked
Ruby + Bundler	ok / installed / blocked
`bundle install`	ok / skipped (no Gemfile) / failed
Local preview	running at http://127.0.0.1:4000 / not available yet

Then tell them the next useful sentence, for example: “Setup is done. Open this folder in IntelliJ when you want to start the homepage.” or “I need your Mac password to finish Homebrew.”

Manual cheat sheet

Same steps, compressed, if a person wants to do it themselves on a Mac:

# 1. Homebrew first (not included with macOS)
/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"
eval "$(/opt/homebrew/bin/brew shellenv)"

# 2. Tools
brew install git ruby
brew install --cask intellij-idea-ce
gem install bundler

# 3. Clone (from an empty project folder)
git clone git@github.com:jleroux1988/lattirance.github.io.git .

# 4. If a Gemfile exists
bundle install
bundle exec jekyll serve

Common problems

Homebrew not found: it is not part of macOS. Run step 1. On Apple Silicon, also run eval "$(/opt/homebrew/bin/brew shellenv)" in this terminal (and add it to ~/.zprofile).
SSH Host key verification failed: GitHub is not in ~/.ssh/known_hosts yet. Add it with ssh-keyscan, then retry.
Phone shows the site, Mac shows a GoDaddy placeholder: old DNS / GoDaddy forwarding. Local setup is unrelated; check GoDaddy A records and forwarding.
.co.za does not reach .com: the redirect is at the registrar, not in this repo. CNAME should still be lattirance.com only.
bundle / jekyll not found: Homebrew Ruby is not on PATH. Open a new terminal or add Homebrew Ruby’s bin directory to PATH.
Password prompt in Terminal: required for Homebrew or macOS developer tools. The agent cannot type it for you.
IntelliJ already installed but setup still offers CE: skip the cask. Ultimate and Community both count as done.