Project Handoff

potatosociety.uk Maintenance Guide

Purpose: Minimalist portfolio/digital garden showcasing AI engineering, cybersecurity, and satellite operations expertise.

Core Structure: Obsidian Vault (SOURCE): C:\VAULT\proxmox-vault\20 Projects\ProjectHome Quartz Install: C:\quartz-portfolio └─ content → [SYMLINK TO VAULT]

Critical Files:

1. quartz.config.yaml (Quartz root)

   • ONLY config file used (YAML format required for v5)
   • Sets: pageTitle, baseUrl: potatosociety.uk, B&W theme, ignorePatterns
   • DO NOT use quartz.config.ts/.js

2. sync.ps1 (Quartz root)

   • One-command synchronization: .\sync.ps1 # git pull → add . → commit “Sync: timestamp” → push

3. Content Location

   • All markdown files live in: C:\VAULT\proxmox-vault\20 Projects\ProjectHome
   • Access via symlink: C:\quartz-portfolio\content

Maintenance Workflow:

1. Edit files in Obsidian vault
2. From Quartz directory: .\sync.ps1
3. Cloudflare Pages auto-rebuilds on GitHub push (1-2 min)

Cloudflare Pages Settings:

• Build Command: npx quartz build —no-serve
• Output Directory: public
• Root Directory: EMPTY (critical!)
• Framework: None
• Domain: potatosociety.uk (auto-configured via Cloudflare DNS)

Troubleshooting First Steps:

• Site not updating? → Run .\sync.ps1 → Check GitHub → Check Cloudflare build logs
• Build failing? → Test locally: npx quartz build —no-serve
• Wrong content? → Check for rogue files in Obsidian vault (e.g. duplicate extensions)
• Not minimalist? → Disable unnecessary plugins in quartz.config.yaml

Access:

• Live: https://potatosociety.uk
• Local preview: cd C:\quartz-portfolio && npx quartz watch
• Source: GitHub repo linked to Cloudflare Pages

Update this guide if core mechanics change