salmanq.com

Personal website and blog built with Hugo and the hugo-blog-awesome theme. Deployed to GitHub Pages via GitHub Actions.

Prerequisites

• Hugo Extended v0.156.0+
• just

brew install hugo just

Commands

just run              # Start local dev server with drafts
just build            # Build for production
just new my-post      # Create a new blog post

Project Structure

├── assets/sass/        # Custom SCSS overrides (_custom.scss, _fonts.scss)
├── content/blog/       # Blog posts (Markdown)
├── layouts/            # Template overrides (header, footer, single, RSS)
├── static/fonts/       # Self-hosted Inter & JetBrains Mono
├── themes/             # hugo-blog-awesome (git submodule)
└── config.yaml         # Site configuration

Deployment

Pushes to main automatically build and deploy to GitHub Pages via the workflow in .github/workflows/main.yml.