CLAUDE.md — ambre-loiseau.fr

Project Overview

Personal website for ambre-loiseau.fr hosted on GitHub Pages using the Minimal Mistakes Jekyll theme (remote theme method).

• Repository: champost/ambre-loiseau.fr (project GitHub Pages site)
• Default branch: main
• Custom domain: www.ambre-loiseau.fr (primary), ambre-loiseau.fr (redirects to www)
• Redirect: loisambre.fr and www.loisambre.fr → 301 redirect to www.ambre-loiseau.fr
• Theme: Minimal Mistakes v4.28.0 via jekyll-remote-theme
• Aesthetic inspiration: Quinn Daedal’s site (https://quinndaedal.com/)

DNS & Domain (completed)

• 4 A records → GitHub Pages IPs (185.199.108–111.153) on ambre-loiseau.fr
• CNAME www → champost.github.io
• Domain verification TXT record (_github-pages-challenge-champost) in place
• Enforce HTTPS: enabled
• CNAME file contains www.ambre-loiseau.fr
• Old domain loisambre.fr 301-redirects via OVH Redirection

Architecture

GitHub Pages builds Jekyll on push — no GitHub Actions workflow needed. The remote theme method pulls Minimal Mistakes layouts/includes/assets at build time.

Key files

_config.yml              # Jekyll + Minimal Mistakes configuration
Gemfile                  # Ruby dependencies (github-pages gem)
index.html               # Home page (splash layout with feature_row)
CNAME                    # Custom domain pointer
dev.sh                   # Start local dev server via Podman
.gitignore               # Ignore _site, .sass-cache, Gemfile.lock
.devcontainer/
  Dockerfile             # Ruby 3.4 container with bundler + gems
  devcontainer.json      # VS Code Dev Container config
.vscode/
  settings.json          # Disable SCSS linting (Jekyll front matter incompatible)
_data/
  navigation.yml         # Top nav bar links (About, CV, Projects, Blog)
_pages/
  about.md               # About page
  cv.md                  # CV page (with table of contents)
  projects.md            # Projects listing (collection grid)
  blog.md                # Blog listing (paginated posts)
  404.md                 # Custom 404 page (French)
_posts/                  # Blog posts (YYYY-MM-DD-title.md)
_projects/               # Project collection items
assets/
  css/main.scss          # Custom SCSS overrides (logo size)
  images/                # Images (logo, header, teasers, etc.)

Site Structure (modeled after quinndaedal.com)

Navigation

About | CV | Projects | Blog

Home page (index.html)

• Splash layout with header image + tagline
• Feature row: 3 image cards linking to About, Projects, Blog
• Recent Posts list (latest 3)

Pages

• About — Single page bio
• CV — Detailed CV with sticky table of contents (Education, Work, Publications, Talks, Awards, Languages)
• Projects — Grid layout showing _projects collection items with teaser images
• Blog — Paginated list of _posts

Content to replace

All placeholder text is marked with [brackets]. Replace with your own:

• [Your tagline here] — in _config.yml (author.bio) and index.html (excerpt)
• [Write your bio here] — in _pages/about.md
• CV sections — in _pages/cv.md
• Project descriptions — in _projects/*.md
• Blog posts — in _posts/*.md

Images needed

assets/images/bio-photo.jpg          # Author avatar (used in sidebar if enabled)
assets/images/logo.jpg               # Nav bar logo
assets/images/header-home.jpg        # Home page splash header
assets/images/frontpage-about.jpg    # Feature row card: About
assets/images/frontpage-projects.jpg # Feature row card: Projects
assets/images/frontpage-blog.jpg     # Feature row card: Blog
assets/images/project-one-teaser.jpg # Project grid teaser
assets/images/project-two-teaser.jpg # Project grid teaser

Local Development

Only dependency: Podman (rootless). No Ruby/Node.js on the host.

bash dev.sh

• Builds container image from .devcontainer/Dockerfile (cached after first run)
• Gems are pre-installed in the image via COPY Gemfile + bundle install
• Jekyll serves on http://localhost:4000 with live reload (port 35729)
• _config.yml changes require restarting dev.sh
• If Gemfile changes, podman build detects the changed layer and re-runs bundle install

Dev workflow (single VS Code window)

1. Terminal: bash dev.sh — shows Jekyll build/serve log
2. Integrated browser: http://localhost:4000 — live preview
3. Editor: workspace files for manual edits
4. GitHub Copilot chat: AI-assisted changes

Alternative: VS Code Dev Container

Use “Reopen in Container” from Command Palette. Uses same .devcontainer/ config. Note: Copilot chat history does not carry over between host and container sessions.

Deployment

Push to main → GitHub Pages builds and deploys automatically.

Conventions

• Locale: fr-FR, timezone: Europe/Paris
• Author name: “Ambre Loiseau”
• Minimal Mistakes skin: default
• SCSS validation disabled in VS Code (Jekyll front matter is not valid SCSS)
• Keep README.md and CLAUDE.md updated when making structural changes

Useful References

• Minimal Mistakes docs: https://mmistakes.github.io/minimal-mistakes/docs/quick-start-guide/
• MM configuration: https://mmistakes.github.io/minimal-mistakes/docs/configuration/
• MM layouts: https://mmistakes.github.io/minimal-mistakes/docs/layouts/
• MM starter repo: https://github.com/mmistakes/mm-github-pages-starter
• GitHub Pages + Jekyll: https://docs.github.com/en/pages/setting-up-a-github-pages-site-with-jekyll