Creator — Building a Ghost Theme (Work Log)

Back to project

Building Creator, a free open-source multipurpose Ghost theme — documented step by step, in the open.

Build log 04 Jul 2026 1 min read

Part 4 — Understanding Ghost theme structure

Mapped every file and folder so I know what I'm editing and why.

Core files

  • package.json — theme metadata + config (navigation, custom settings).
  • default.hbs — the outer HTML shell every page inherits.
  • index.hbs — the default post-list template.
  • post.hbs / page.hbs — single post / page.
  • tag.hbs / author.hbs — archive pages.

Folders

  • partials/ — reusable chunks pulled in with {{> name}}.
  • assets/ — CSS, JS, images; served via {{asset}}.
  • routes.yaml — custom routing & collections.

The mental model

Ghost picks a template by context (home, post, tag…), renders it inside default.hbs. Learn the template hierarchy and everything else follows.

Advertisement