# Lumi Documentation

> Set up Lumi, a Ghost theme for agencies, portfolios, and blogs. Customize the homepage manifesto, post-card image shapes, and site-wide calls to action.

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

---

**Lumi** is a clean, minimal Ghost theme for creative projects, agencies, portfolios, and blogs. This documentation covers installation, theme settings, memberships, and common file changes.

The guides assume that you can access Ghost Admin and are familiar with posts, pages, and publication settings. If you are new to Ghost, start with the [Ghost Help Center](https://ghost.org/help/).

---

## Navigation

### General

- [Changelog](https://ektothemes.com/docs/lumi/changelog.md): Review the theme’s release history, including dated entries for new features, design updates, fixes, and Ghost compatibility changes.

### Getting Started

- [Installation](https://ektothemes.com/docs/lumi/getting-started/installation.md): Install a Ghost theme from a ZIP file. Follow the steps to upload and activate it in Ghost Admin and check custom theme support on Ghost(Pro).
- [Routes](https://ektothemes.com/docs/lumi/getting-started/routes.md): Use the theme with Ghost’s default routes, or download and upload the provided routes.yaml file to restore the default configuration.

### Basic Settings

- [Branding](https://ektothemes.com/docs/lumi/basic-settings/branding.md): Set your publication’s accent color, icon, logo, cover image, and fonts in Ghost. See how the theme uses each branding setting.
- [Navigation](https://ektothemes.com/docs/lumi/basic-settings/navigation.md): Manage header and footer links in Ghost. Add a desktop dropdown to the primary navigation and see how its links appear on mobile.
- [Social links](https://ektothemes.com/docs/lumi/basic-settings/social-links.md): Add social profiles to your footer through secondary navigation in Ghost. Find the supported networks and the exact labels for their links.
- [Announcement bar](https://ektothemes.com/docs/lumi/basic-settings/announcement-bar.md): Add an announcement above your publication header in Ghost. Set the message, link, background color, and audience.

### Customization

- [Site-wide](https://ektothemes.com/docs/lumi/customization/site-wide.md): Set publication-wide colors and fonts, upload a secondary logo, and configure the call to action, footer text, and dark mode.
- [Color scheme](https://ektothemes.com/docs/lumi/customization/site-wide/color-scheme.md): Choose a built-in palette for backgrounds, text, buttons, and links, and see which color schemes can use the Dark mode setting.
- [Accent color](https://ektothemes.com/docs/lumi/customization/site-wide/accent-color.md): Choose between the theme’s accent and the Ghost accent for buttons, links, and highlights. Find where to change the Ghost accent color.
- [Typography](https://ektothemes.com/docs/lumi/customization/site-wide/typography.md): Choose fonts for headings and body text. Set Ghost’s fonts to Theme default to use the selected bundled or system fonts.
- [Secondary logo](https://ektothemes.com/docs/lumi/customization/site-wide/secondary-logo.md): Upload a secondary publication logo for dark backgrounds. See where it appears and how the theme uses the main logo as a fallback.
- [CTA](https://ektothemes.com/docs/lumi/customization/site-wide/cta.md): Set a custom CTA link and button label across the theme, or customize Portal signup text in the homepage Hero and footer.
- [Footer title](https://ektothemes.com/docs/lumi/customization/site-wide/footer-title.md): Edit the heading above the footer action, or leave the field empty to show the default signup invitation with your publication name.
- [Footer copyright](https://ektothemes.com/docs/lumi/customization/site-wide/footer-copyright.md): Use custom text or simple HTML links in the footer credit. The default includes the year, publication name, Ghost, and the theme.
- [Dark mode](https://ektothemes.com/docs/lumi/customization/site-wide/dark-mode.md): Enable an alternate dark palette and a visitor switch. Learn how the theme follows the device preference and remembers a manual choice.
- [Homepage](https://ektothemes.com/docs/lumi/customization/homepage.md): Customize the homepage hero and manifesto, and choose portrait or landscape images for post cards across your publication.
- [Hero](https://ektothemes.com/docs/lumi/customization/homepage/hero.md): Set the homepage hero title and choose a layout. Use the global CTA settings to customize the button link or Portal signup text.
- [Thumbnail style](https://ektothemes.com/docs/lumi/customization/homepage/thumbnail-style.md): Choose portrait or landscape images for post cards across your publication, including related posts. See how cards handle missing images.
- [Manifesto](https://ektothemes.com/docs/lumi/customization/homepage/manifesto.md): Add a manifesto below the homepage feed. Set an optional heading and write the statement with plain text or simple HTML links.
- [Post](https://ektothemes.com/docs/lumi/customization/post.md): Configure post layouts, metadata, reading text size, footer tags and sharing, related posts, and drop caps in Ghost.
- [Template](https://ektothemes.com/docs/lumi/customization/post/template.md): Set the default post layout in Ghost and see how each template handles the feature image. Override the layout for an individual post or page.
- [Metadata](https://ektothemes.com/docs/lumi/customization/post/metadata.md): Choose which author, publication date, and reading time details appear in the post header, or hide the metadata.
- [Font size](https://ektothemes.com/docs/lumi/customization/post/font-size.md): Choose Base, Medium, or Large to adjust the reading text size for full posts, public previews, and pages in the theme.
- [Footer](https://ektothemes.com/docs/lumi/customization/post/footer.md): Choose which tags and sharing actions appear below a post. See which sharing services are available and when the footer shows them.
- [Related posts](https://ektothemes.com/docs/lumi/customization/post/related-posts.md): Choose related posts by the current post’s primary tag, show the latest posts, or hide the section below the article.
- [Drop caps](https://ektothemes.com/docs/lumi/customization/post/drop-caps.md): Enable or disable the enlarged first letter that appears when a post or public preview starts with a paragraph.

### Membership

- [Portal](https://ektothemes.com/docs/lumi/membership/portal.md): Set up Ghost Portal for signup, paid plans, and member accounts, and choose whether to show the floating Portal button.
- [Upgrade CTA](https://ektothemes.com/docs/lumi/membership/upgrade-cta.md): See how the Upgrade CTA guides visitors to sign up, sign in, or upgrade when a Ghost post requires a membership or paid plan.
- [Comments](https://ektothemes.com/docs/lumi/membership/comments.md): Enable Ghost’s native comments, choose which members can comment, and see when comments appear on posts with restricted access.
- [Recommendations](https://ektothemes.com/docs/lumi/membership/recommendations.md): Add recommended publications in Ghost and create a navigation link that opens the recommendations list in Portal.

### Advanced

- [Edit theme](https://ektothemes.com/docs/lumi/advanced/edit-theme.md): Edit theme files in Ghost Admin or use EktoKit locally to preview changes, build assets, validate the theme, and package a ZIP.
- [Translate](https://ektothemes.com/docs/lumi/advanced/translate.md): Translate theme interface text in the Ghost code editor or edit the locale files locally. Learn how to add a new language.
- [Posts per page](https://ektothemes.com/docs/lumi/advanced/posts-per-page.md): Change how many posts load on the homepage, archive, author, and tag feeds by editing package.json in Ghost Admin or locally.
- [Update theme](https://ektothemes.com/docs/lumi/advanced/update-theme.md): Download the latest theme ZIP, install it in Ghost Admin, and back up any edits you want to reapply after the update.
- [Support](https://ektothemes.com/docs/lumi/advanced/support.md): Contact Ekto for theme support, bug reports, or documentation feedback. Find out what details to include so we can reproduce the issue.
