Sage 11 theme for hummelwp.com — portfolio, services, and journal for a WordPress / full-stack developer in Gettysburg, PA.
No page builders. Visitor copy lives in wp-admin (Page content (theme)), not hardcoded in Blade. Front end is Blade + Tailwind + a few small JS modules. PHP does the heavy lifting; Vite ships the assets.
| Live site | hummelwp.com (Hostinger) |
| Version | 3.5.16 · CHANGELOG · public changelog |
| Stack | Sage 11.2.1 · PHP 8.3 · Acorn 6 · Blade · Tailwind v4 · Vite 8 · WordPress 6.6+ |
| Release | theme-latest (CI zip for Appearance → Update Theme) |
| License | MIT |
Recent ship log — useful if you’re cloning, reviewing a PR, or picking up where CI left off. Full history: CHANGELOG.md · live list: hummelwp.com/changelog.
● 2026-09-06 3.1.78 Acreline product page: setup wizard copy (1.3.0)
● 2026-09-06 3.1.77 Acreline legacy SEO URLs → live product
● 2026-09-06 3.1.76 Acreline Real estate live + catalog cleanup
● 2026-09-04 3.1.75 Acreline labeled Real estate (not Land & farms)
● 2026-09-04 3.1.73 Acreline product page synced from wp-acreline 1.2.3 (Gutenberg blocks)
● 2026-08-31 3.1.32 Buy theme + Get help on Work; public brand is Matt Hummel
● 2026-08-31 3.1.31 Marketplace files + audit: screenshot, readme.txt, CREDITS; submit Acreline
● 2026-08-31 3.1.30 Project singles at /projects/{slug}/; hero screenshot; buyer docs
● 2026-08-31 3.1.29 WooCommerce Blade shop/product templates and classic Cart/Checkout pages
● 2026-08-31 3.1.27 Contact and /start/ forms POST to the n8n CRM webhook
● 2026-08-29 3.1.26 Concept pages honor Rank Math / Yoast title and meta description
● 2026-08-28 3.1.25 Projects admin: Generate featured image (DALL·E → Media → Work card)
● 2026-08-28 3.1.24 Concept custom fields + On site toggles, filters, newest-first Work grid
● 2026-08-28 3.1.23 On-site concept pages at /concept/{slug}/ (non-live stay 404)
● 2026-08-28 3.1.22 Projects CPT: Ridges & Valleys concepts, Show on site / Hide from site
● 2026-08-27 3.1.21 Post editor: Generate featured image (shared OpenAI key with DEV.to)
● 2026-08-27 3.1.20 Journal CTA + author bio: WordPress platforms + full-stack web apps
● 2026-08-27 3.1.18 Social share (Bluesky / LinkedIn / Facebook / Reddit) + DEV.to helpers
| Watch this | Why |
|---|---|
| CHANGELOG.md | Semver release notes (source of truth in git) |
| docs/ERRORS.md | Debug log, Vite/manifest fatals, SQLite, deploy gotchas |
| docs/FEATURES.md | What ships where (templates, CPT, WP-CLI map) |
| Actions | Build → zip → theme-latest |
Commits on main |
PR-sized diffs |
Stuck on a white screen or missing CSS? Start in the error cheatsheet — enable WP_DEBUG_LOG, then tail -f ~/wp-site/wp-content/debug.log.
| Audience | What they get |
|---|---|
| Shops and local businesses | Example projects, plain-language WordPress options, a clear way to start a project |
| Agencies and developers | Stack, open-source code, overflow / hire paths |
| Recruiters | Experience, GitHub, availability |
- Named Blade page templates (Home, About, Services, Hire, Work, Code, Contact, Now, Uses, …)
- Projects CPT with on-site project pages at
/projects/{slug}/ - Plugin-free contact + project brief forms (nonce, honeypot)
- GitHub API showcase (profile, contribs, activity, repos) via transients
- Journal with share intents, comments, and DEV.to / Bluesky helpers
- Appearance → Update Theme installs the
theme-latestGitHub Release zip
Deep feature list: docs/FEATURES.md. Architecture deep-dive: docs/THEME.md.
Day-to-day links a full-stack WordPress / Sage developer actually opens.
| Resource | Use it when |
|---|---|
| CHANGELOG.md | You need exact version notes before updating live |
| hummelwp.com/changelog | Public-facing “what changed” |
theme-latest release |
Grab the built zip CI publishes |
| GitHub Actions | CI failed, or you want the last green build |
| Resource | Use it when |
|---|---|
| docs/ERRORS.md | Manifest missing, Blade cache stale, PHP version, SQLite bootstrap |
| WordPress debugging | Official WP_DEBUG / WP_DEBUG_LOG reference |
~/wp-site/wp-content/debug.log |
Local runtime errors (Cloud / SQLite setup) |
| Hostinger hPanel error log | Production PHP fatals (not exposed by the Hostinger API) |
| Layer | Official | In this repo |
|---|---|---|
| Sage 11 | roots.io/sage/docs | docs/sage/ |
| Theme templates | Theme templates | docs/sage/theme-templates.md |
| Compiling assets | Compiling assets | npm run build / npm run dev |
| Deployment | Sage deployment | docs/sage/deployment.md · docs/INSTALL.md |
| Acorn | roots.io/acorn | wp acorn view:clear |
| Tailwind v4 | tailwindcss.com | resources/css/app.css @theme |
| Vite | vite.dev | vite.config.js (base = /wp-content/themes/matthummel/public/build/) |
| WordPress | developer.wordpress.org | Template hierarchy still applies |
| Blade | Laravel Blade | resources/views/ |
| Roots community | discourse.roots.io | Ask Sage / Acorn questions |
| URL | Why open it |
|---|---|
| hummelwp.com/code | Live GitHub panel this theme powers |
| hummelwp.com/uses | Stack and tools list |
| hummelwp.com/changelog | Public release notes |
| hummelwp.com/accessibility | WCAG / 508 statement |
composer install && npm install && npm run build
# Symlink into WordPress (folder name must be matthummel)
ln -sfn /path/to/this/repo ~/wp-site/wp-content/themes/matthummel
cd ~/wp-site
wp theme activate matthummel
wp acorn view:clear
wp rewrite structure '/%postname%/'
wp server --host=0.0.0.0 --port=8080Site: http://localhost:8080 · Admin: admin / password
| Command | Purpose |
|---|---|
npm run build |
Compile assets to public/build/ (required; gitignored) |
npm run dev |
Vite HMR |
vendor/bin/pint |
Fix PHP style |
wp acorn view:clear |
Clear Blade cache after template edits |
wp mh theme-update |
Install theme-latest zip on a WordPress install |
wp mh theme-build |
Dispatch CI to rebuild the release zip |
wp mh db-pull |
Pull production DB over SSH → local (see FEATURES) |
Full local / Cloud setup: AGENTS.md. Hit a snag: docs/ERRORS.md.
Push or merge to main runs GitHub Actions:
- Composer +
npm run build - Publish Release
theme-latest - Install on Hostinger (
hummelwp.com) via Appearance → Update Theme orwp mh theme-update
Live theme path: wp-content/themes/matthummel/. Purge LiteSpeed after install.
Details: docs/INSTALL.md · docs/sage/deployment.md · workflow.
app/ PHP (fields, contact, GitHub, updater, …)
resources/views/ Blade templates, sections, partials
resources/css/ Tailwind @theme + portfolio styles
resources/js/ Small front-end modules
public/build/ Vite output (CI only — never commit)
.github/workflows/ Deploy pipeline
docs/ Feature log, errors, install, theme deep-dive, Sage notes
Architecture, page map, SEO, a11y, and security notes: docs/THEME.md.
| Doc | Contents |
|---|---|
| docs/MARKETPLACE.md | ThemeForest / WordPress.org: do not upload this theme; submit Acreline |
| docs/THEME.md | Full theme documentation (architecture, SEO, a11y, security) |
| docs/FEATURES.md | Feature log and WP-CLI reference |
| docs/INSTALL.md | Activate after deploy |
| docs/ERRORS.md | Error / debug cheatsheet |
| docs/sage/ | Local Sage template + deploy notes |
| CHANGELOG.md | Version history |
| AGENTS.md | Cursor Cloud environment |
MIT. Built on Sage (MIT).