Docs

Upload hicking-theme.zip from Ghost Admin under Design & branding, then activate it.

Customize the Ghost site logo, site title, logo mark, logo text, accent color, footer color, and homepage hero image from Design & branding.

If you upload a Ghost logo image, the header and footer both use it. If no logo image exists, the theme uses logo_mark and site_logo_text.

Add links such as Home, All Posts, Topics, Authors, Membership, Contact, and About from Ghost Admin under Navigation.

The homepage hero slider uses up to 5 featured posts. Add a feature image to a post and mark it as Featured to make it appear in the slider.

The Design & branding hero_image setting is used when no featured hero post image exists. It also powers the All Posts and Topics page hero backgrounds.

The homepage includes tag filters, a sortable post grid, side posts, pagination, and a configurable promo image and promo text.

Create a page with slug all-posts and assign the All Posts template. It includes topic filtering and sorting by newest, oldest, reading time, or title.

Create a page with slug topics and assign the Topics template. It lists tags as topic cards with images, descriptions, and post counts.

Each tag page uses the tag feature image when available. If no tag image exists, it falls back to the Design & branding hero_image.

Create a page with slug authors and assign the Authors template. It displays author cards with profile images, bios, and post counts.

Create a page with slug membership and assign the Membership template. It uses Ghost Portal links for signup, signin, and account management.

Create a page with slug contact and assign the Contact template. The included form uses mailto:; connect it to Formspree, Basin, Zapier, or your own endpoint for production submissions.

Post cards show feature images, primary tag labels, date, reading time, title, excerpt, and author. If no feature image exists, the theme displays a styled placeholder.

Single posts include a large image hero, primary tag, title, excerpt, author metadata, reading time, content area, and optional comments.

Comments are configurable from Design & branding. Choose Ghost native comments, Disqus, or None. For Disqus, add your disqus_shortname.

Use landscape images around 2000px wide for hero and post images, square images for authors, and optimized tag images for topic cards.

Important custom settings include logo_mark, site_logo_text, hero_image, hero_autoplay, show_tag_filters, sidebar_posts_count, promo_image, and promo_text.

The project includes a Dockerfile and custom entrypoint that installs the theme into Ghost at /var/lib/ghost/content/themes/hicking-theme.

The included .gitlab-ci.yml builds and pushes hodaifa/hicking-theme-ghost:latest, then deploys to a VPS using Docker Compose.

Run npm test or npx --yes gscan . before uploading. The theme is built for Ghost 6.x compatibility.

Upload a new ZIP from Design & branding. Your Ghost posts, pages, tags, authors, members, and theme settings stay saved in Ghost.