CLAUDE.md

This file provides guidance to Claude Code (claude.ai/code) when working with code in this repository.

Project Overview

Personal portfolio, blog, and resume website hosted on GitHub Pages at luis-f-cerda-p.dev. Built with Jekyll 4.x and the Minimal Mistakes remote theme.

Development Commands

# Install dependencies
bundle install

# Local development server with live reload
bundle exec jekyll serve

# Production build
JEKYLL_ENV=production bundle exec jekyll build

The generated site outputs to _site/ (gitignored).

Architecture

Content Structure

Configuration & Data

Theme & Layouts

The site uses the mmistakes/minimal-mistakes remote theme. Custom overrides live in _includes/. Available layouts (defined by the theme): splash, single, archive, home.

Bilingual Support

The site is configured for English (root) and Spanish (/es/) versions. Front matter defaults in _config.yml set language per directory.

Plugins (GitHub Pages safe)

jekyll-paginate, jekyll-sitemap, jekyll-gist, jekyll-feed, jekyll-include-cache, jemoji

Content Front Matter Conventions

Posts and pages use front matter to set layout, title, tags, categories, author profile sidebar, and header images. Portfolio entries use layout: single with header.teaser for thumbnails.

Roadmap

ROADMAP.md tracks planned features across three stages: MVP core, personalization, and extras (GitHub API integration, PWA, skills matrix, etc.).