TryGhost / Themes

Ghost Themes A monorepo for Ghost official themes. Development You'll need Node, Yarn and Gulp installed globally. After that, from the project's root directory: Now you can edit files in or , which will be compiled to automatically. To run a theme locally, you need to symlink a theme to your local Ghost site. If you're running the Ghost monorepo: Or if you're running a Ghost instance via the CLI: Restart your Ghost instance and the theme will be listed in the settings. To create an installable theme zip file in : Publishing & CI This monorepo contains three types of packages, each with a different shipping mechanism: Themes (e.g. , , ...) Each theme has its own CI workflow ( ). On push to , the workflow runs tests, deploys the theme to its Ghost demo site via , and pushes to its standalone subtree repo (e.g. ). Themes are marked and are not published to npm. ( ) Shared CSS, JS, and Handlebars partials used by all themes. Published to npm so themes can pin a version via . • **Version bumps happen via **, which runs on . For minor or major bumps, run (or ) instead. • On push to , CI ( ) compares the local version against what's on npm. If the version is newer, it publishes to npm with provenance. If the version hasn't changed, CI skips publishing. • Renovate will later open PRs to bump the devDep in each theme. ( ) Translation files for all themes. Published to npm. • **Version bumps are automatic.** On every push to that touches , CI ( ) runs , publishes to npm, and commits the version bump back to the repo. • See for how to edit or contribute translations. Local commands Copyright & License Copyright (c) 2013-2026 Ghost Foundation - Released under the MIT license.