CLAUDE.md

CLAUDE.md

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

What this is

Jekyll 4.3 static site for Lab42 (www.lab42.it), deployed to GitHub Pages via GitHub Actions on push to main.

Common commands

# Install dependencies
bundle install

# Serve locally with live reload
bundle exec jekyll serve --livereload

# Build for production
bundle exec jekyll build

# Build with drafts
bundle exec jekyll serve --drafts

There is no linter or test suite configured.

Testing without local Ruby/bundler

If bundle/jekyll aren’t installed on the host, build via the official Docker image instead of installing gems locally:

docker run --rm -v "$PWD":/srv/jekyll -w /srv/jekyll jekyll/jekyll:4.2.2 jekyll build

# or to serve with live reload:
docker run --rm -v "$PWD":/srv/jekyll -w /srv/jekyll -p 4000:4000 jekyll/jekyll:4.2.2 jekyll serve --livereload --host 0.0.0.0

Remove _site/ and .jekyll-cache/ afterward — they’re build artifacts, not checked in.

Architecture

Layouts and includes

  • _layouts/default.html — base HTML shell; loads Google Fonts (Inter, JetBrains Mono), includes header/footer, and injects assets/css/main.css + assets/js/main.js
  • _layouts/page.html — extends default; used by all unit pages (example42, puppet, devops, ai, media, about)
  • _includes/header.html — hardcoded nav links (not driven by site.nav from _config.yml)
  • _includes/footer.html — site-wide footer

Pages and routing

  • index.html — homepage with hero, stats, unit cards grid, CTA
  • example42.md — main infrastructure unit page at /example42/; covers Puppet consulting, DevOps, cloud infra, and the example42.com open-source community
  • puppet.md, devops.md — sub-pages under the example42 unit (nav marks them active under the example42 link)
  • ai.md, media.md, about.md — top-level section pages
  • 404.html — custom error page
  • Permalinks are set per-page via front matter (e.g. permalink: /example42/)

The header nav has four entries: example42, AI, Media, About. The example42 link is marked active when the URL contains /example42, /puppet, or /devops.

Per-unit theming

Pages set unit: example42|puppet|devops|ai|media in front matter. The default layout applies class="unit-" to <body>, enabling per-unit color overrides in CSS. Unit accent colors are:

  • example42 (and puppet): #FF6B00
  • devops: #0EA5E9
  • ai: #8B5CF6
  • media: #EF4444

Content patterns

Unit pages use inline HTML within Markdown for structured elements:

  • .feature-grid / .feature-card — service grids
  • .chip — technology tags
  • .project-highlight / .project-highlight--example42 — featured project blocks
  • .btn / .btn-primary / .btn-outline — CTA buttons
  • .consulting-grid / .consulting-card / .consulting-card--featured — consulting offer cards (ai.md)
  • .wlaudio-feature — “Active Project” hero block, reused for Wlaudio and Pabawi (ai.md)
  • .podcast-grid / .podcast-card — card grid, used for the two podcasts and the Abnormalia/Alvagante content projects (media.md)
  • .lang-badge — language indicator badge on podcast/content cards (media.md)

Deployment

.github/workflows/jekyll.yml builds with JEKYLL_ENV=production and deploys to GitHub Pages. Deploys only trigger from the main branch.

External projects referenced on this site

  • alvagante.com — curated AI/security/tech link directory; listed on media.md
  • abnormalia.com — experimental AI-generated narrative content; listed on media.md

Plugins

  • jekyll-feed — /feed.xml
  • jekyll-seo-tag — `
CLAUDE.md | Lab42

` in <head>

  • jekyll-sitemap — /sitemap.xml