Creator — Building a Ghost Theme (Work Log)
Back to projectBuilding 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