# Edit theme

> Edit theme files in Ghost Admin or use EktoKit locally to preview changes, build assets, validate the theme, and package a ZIP.

Canonical URL: https://ektothemes.com/docs/lumi/advanced/edit-theme/
Published: 2026-11-11
Last Updated: 2026-11-11

---

Use Ghost’s integrated theme editor for quick file changes. For source development, the theme uses [EktoKit ↗](https://ektokit.org/) to compile Tailwind CSS, bundle JavaScript, run a live development server, and create the distributable ZIP.

## Make a quick edit in Ghost

1. In Ghost Admin, go to **Settings** → **Site** → **Theme**.
2. Open the **(⋯)** menu next to the active theme and select **Edit Code**.
3. Edit the required file.
4. 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.

1. Unzip the theme and open its folder in a terminal.

2. Install its dependencies:

   ```shell
   npm install
   ```

3. Start your local Ghost site at `http://localhost:2368`.

4. Start development mode:

   ```shell
   npm run dev
   ```

5. Open `http://localhost:3000` to preview the theme. Continue using `http://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

```shell
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.

---

## Navigation

- [Documentation Index](https://ektothemes.com/docs/lumi.md)
- [Previous: Recommendations](https://ektothemes.com/docs/lumi/membership/recommendations.md)
- [Next: Translate](https://ektothemes.com/docs/lumi/advanced/translate.md)
