IAndreaGiuseppe - Technical Leader

Appearance

CLAUDE.md ​

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

Project Overview ​

Personal portfolio/blog website for Andrea Giuseppe (andreagiuseppe.com), built with VitePress (Vue-powered static site generator). All content is written in Italian (lang: it-IT).

Commands ​

bash
npm run docs:dev       # Dev server with hot reload
npm run docs:build     # Build to .vitepress/dist/
npm run docs:preview   # Preview production build

Architecture ​

  • Root .md files: Content pages — index.md (homepage with home layout), cv.md, blog posts
  • .vitepress/config.mjs: Site config — nav, sidebar, SEO meta tags (Open Graph, Twitter), sitemap
  • .vitepress/theme/: Custom theme extending VitePress default
    • index.js: Theme entry with layout slots
    • style.css: CSS variable overrides (indigo brand palette, button/hero/block styling)
  • public/: Static assets (robots.txt)
  • Nav bar: Home, CV
  • Sidebar: Blog posts organized by category (Webdev, Native, IaC sections — some still empty)

Content Conventions ​

  • All pages use YAML frontmatter. Homepage uses VitePress home layout with hero + feature cards.
  • All user-facing text must be in Italian.