Start

Hugo site for theweightof.github.io.

Prerequisites

You will need to install:

1. Git — required to clone the repo (VS Code uses the system git)
2. Hugo (extended) — static site generator
3. just — command runner used to start the dev server
4. VS Code — recommended editor
5. Claude CLI — optional, for AI-assisted editing

---

Windows

Install winget (bundled with Windows 11; otherwise install from the Microsoft Store as "App Installer").

Then in PowerShell:

winget install Git.Git
winget install Hugo.Hugo.Extended
winget install Casey.Just
winget install Microsoft.VisualStudioCode
winget install Anthropic.ClaudeCode

Restart your terminal so the new commands are on PATH, then verify:

git --version
hugo version
just --version
code --version
claude --version

---

macOS

Install Homebrew first if you don't have it:

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

Then install everything:

brew install hugo just
brew install --cask visual-studio-code
brew install --cask claude-code

git is included with the Xcode Command Line Tools on macOS — Homebrew installs them automatically, and the first run of git will prompt you if anything is still missing.

Verify:

git --version
hugo version
just --version
code --version
claude --version

---

Clone the repo

You can clone directly from VS Code — no terminal needed:

1. Launch VS Code.
2. Open the Command Palette: Cmd+Shift+P (macOS) or Ctrl+Shift+P (Windows).
3. Run Git: Clone.
4. Paste the repo URL:

   https://github.com/TheWeightOf/TheWeightOf.github.io.git
   

5. Pick a folder to clone into.
6. When prompted, click Open to load the project.

If you'd rather use the terminal:

git clone https://github.com/TheWeightOf/TheWeightOf.github.io.git
cd TheWeightOf.github.io

Commands

All workflows run through just. From the project root:

Command	What it does
just	Show the help (same as just help).
just help	List every available recipe with its description.
just start	Start the Hugo dev server in the background on port 1313. Logs to .hugo.log.
just stop	Stop the Hugo dev server if it's running.
just write	Open the project in VS Code (code .).
just code	Open the project in Claude Code in yolo mode — skips all permission prompts.

The site is served at http://localhost:1313.

Typical flow

just start    # serve the site (returns immediately)
just write    # edit in VS Code
# ...or...
just code     # edit with Claude Code
just stop     # shut down the server when you're done

Content lives in content/, theme overrides in layouts/, site config in hugo.toml.