ref https://github.com/TryGhost/Ghost/pull/22127 The update to the Portal release process has now been tested on main, it would be good to get Search & Comments updated to the same process so that it's easier to reason about releasing all of them. |
||
---|---|---|
.. | ||
src | ||
test | ||
.env | ||
.eslintrc.js | ||
.yarnrc | ||
LICENSE | ||
package.json | ||
playwright.config.ts | ||
postcss.config.cjs | ||
README.md | ||
tailwind.config.js | ||
tsconfig.json | ||
tsconfig.node.json | ||
vite.config.ts |
Comments UI
Comments widget that is embedded at the bottom of posts in Ghost.
Development
Pre-requisites
- Run
yarn
in Ghost monorepo root
Running via Ghost yarn dev
in root folder
You can automatically start the comments dev server when developing Ghost by running Ghost (in root folder) via yarn dev --all
or yarn dev --comments
. This will host the comments JavaScript files, and makes sure that Ghost uses these locally hosted assets instead of the ones from the CDN.
Release
A patch release can be rolled out instantly in production, whereas a minor/major release requires the Ghost monorepo to be updated and released. In either case, you need sufficient permissions to release @tryghost
packages on NPM.
Patch release
- Run
yarn ship
and select a patch version when prompted - Merge the release commit to
main
Minor / major release
- Run
yarn ship
and select a minor or major version when prompted - Merge the release commit to
main
- Wait until a new version of Ghost is released
JsDelivr cache
If the CI doesn't clear JsDelivr cache to get the new version out instantly, you may want to do it yourself manually (docs). Typically, you'll need to open https://purge.jsdelivr.net/ghost/comments-ui@~${COMMENTS_UI_VERSION}/umd/comments-ui.min.js
and
https://purge.jsdelivr.net/ghost/comments-ui@~${COMMENTS_UI_VERSION}/umd/main.css
in your browser, where COMMENTS_UI_VERSION
is the latest minor version in ghost/core/core/shared/config/defaults.json
(code)
Copyright & License
Copyright (c) 2013-2025 Ghost Foundation - Released under the MIT license.