Use Ghost’s integrated theme editor for quick file changes. For source development, the theme uses EktoKit ↗ to compile Tailwind CSS, bundle JavaScript, run a live development server, and create the distributable ZIP.
Make a quick edit in Ghost
- In Ghost Admin, go to Settings → Site → Theme.
- Open the (⋯) menu next to the active theme and select Edit Code.
- Edit the required file.
- Click Save, then Replace theme to apply the changes.
The editor works well for templates, package.json, and translation files. Use Ghost Code Injection for small CSS overrides so they remain separate from theme updates.
Set up the project
Local development requires Node.js 22 or later and a local Ghost installation. Use this workflow for source CSS, JavaScript, or any change that requires compilation.
-
Unzip the theme and open its folder in a terminal.
-
Install its dependencies:
npm install -
Start your local Ghost site at
http://localhost:2368. -
Start development mode:
npm run dev -
Open
http://localhost:3000to preview the theme. Continue usinghttp://localhost:2368/ghost/to access Ghost Admin.
EktoKit proxies the local Ghost site at http://localhost:2368 through the preview URL and reloads it when source files change.
Commands
npm run dev # Start development mode
npm run build # Compile production CSS and JavaScript
npm run test # Validate the theme with GScan
npm run zip # Build and package the theme ZIP
npm run dev:host # Expose the preview on the local network
Source styles and scripts are under assets/css/ and assets/js/. Compiled files are written to assets/built/; do not edit those generated files directly.
Editing package.json or translation JSON files does not require a build. When working locally, create a new ZIP and upload it to apply those changes.