Open-Sourcing Hugo PaperModest Theme

Objective Open source and document my custom Hugo theme PaperModest, ensuring it’s usable by others but clearly marked as not actively maintained. My primary goal remains focused on writing for my main site, but I’m sharing this theme as a way of giving back. ✅ Tasks 1. Finalize Git Submodule in Live Site Ensure my live site correctly includes the theme submodule. git add .gitmodules themes/hugo-papermodest git commit -m "Add papermodest theme as submodule" 2. Theme Naming & Folder Structure Repo name: hugo-papermodest Theme name: PaperModest Theme folder: themes/hugo-papermodest 3. Add theme.toml name = "PaperModest" license = "MIT" licenselink = "https://github.com/faisaldarbar/hugo-papermodest/blob/main/LICENSE" description = "A lightly customized fork of PaperMod for my personal site. Shared for others, but not actively maintained." homepage = "https://github.com/faisaldarbar/hugo-papermodest" tags = ["blog", "minimal", "fast", "responsive", "dark mode", "personal"] features = ["dark mode", "light mode", "optimized for reading"] min_version = "0.100.0" [author] name = "Faisal Darbar" homepage = "https://faisaldarbar.com" 4. Update License Prepend this notice to the existing MIT LICENSE file: ...

July 11, 2025 · 3 min · Faisal Darbar

Hugo Theme Design and Content Migration

🧭 What’s the Plan? This week, the mission is to cleanly separate the theme (design) from the site content, and bring both under proper version control so the site is maintainable, scalable, and dev-friendly moving forward. ✅ Current Setup Recap I’ve forked the PaperMod theme and started working on my own version: hugo-papermodest I created a demo/testing site using: hugo new site hugo-papermodest-demo --format yaml The forked theme is added as a git submodule to the demo using: ...

July 11, 2025 · 2 min · Faisal Darbar