Docs

Atelier Ink — Premium Ghost Editorial Theme

A refined, premium Ghost editorial theme crafted for writers, creators, newsletters, and modern independent magazines.
Designed with readability, elegance, and membership growth in mind, Atelier Ink combines a polished magazine-style layout with powerful Ghost-native features to create a professional publishing experience.

✨ Perfect For

Independent magazines
Creator newsletters
Editorial blogs
Personal brands
Paid-content publications
Niche digital publications

🚀 Core Features

Editorial Homepage Experience

Featured hero section for highlighted stories
Magazine-style article grids and list layouts
Responsive design optimized for all devices
Elegant typography focused on readability

Publishing & Content

Beautiful post and page templates
Author and topic archive pages
Responsive Ghost image support
Excerpt-ready article cards
Feature-image optimized layouts

Membership & Growth

Ghost Portal integration
Newsletter call-to-action sections
Paid-content ready structure
Membership-focused conversion areas

Theme Customization

Configurable typography
Multiple theme tones and color styles
Flexible homepage layouts
Custom hero content and labels
Newsletter CTA customization
Topic bar visibility options

📦 Installation

Upload the Theme

Zip the theme folder or run:

npm run zip

In Ghost Admin go to:

Settings → Design & branding → Change theme

Upload:

atelier-ink.zip

Activate the theme.

✅ Theme Validation

Install GScan globally:

npm install -g gscan

Run the validation:

npm test

🎨 Customization

Open:

Settings → Design & branding → Theme

Available customization options include:

Typography
Theme tone
Header style
Feed layout
Homepage hero style
Hero labels and titles
Newsletter CTA content
Topic bar visibility
Hero panel image and text

For the best presentation:

Add a publication cover image
Set an accent color
Upload a logo
Feature one strong article for the homepage hero

📄 SuggestedPages

Ghost Admin → Pages → New page

Create these essential pages to complete your publication experience.

Page Recommended URL

About

Introduce your publication, mission, and team.

/about/

Archive

Use the All posts custom template for advanced browsing with tag and author filtering.

/archive/

Contact

Add a contact form, email address, or social links.

/contact/

Membership

Promote memberships, subscriptions, and premium access.

/membership/

Privacy

Display your privacy policy and data usage information.

/privacy/

Terms

Publish your terms of service and publication rules.

/terms/

✍️ Publishing Best Practices

For the best visual experience:

Add feature images to important posts
Use excerpts for cleaner cards
Organize content with tags
Feature one key article
Add author bios and profile images

Primary Navigation

Main Menu

Label URL

Home /

About /about/

Membership /membership/

Contact /contact/

Secondary Navigation

Footer Menu

Label URL

About /about/

Contact /contact/

Membership /membership/

Privacy /privacy/

Terms /terms/

The theme automatically supports:

X / Twitter
Facebook
RSS

Simply add your social profiles from:

Settings → Design & branding → Brand

🐳 GitLab CI & Docker Deployment

The repository includes a full Docker + GitLab CI workflow for automated deployments.

Default Deployment Path

/var/lib/ghost/content/themes/magazin

Required GitLab Variables

DOCKERHUB_USERNAME
DOCKERHUB_PASSWORD
SSH_HOST
SSH_USER
SSH_PRIVATE_KEY
MYSQL_ROOT_PASSWORD

Optional:

GHOST_PUBLIC_URL

🎭 Dynamic Domain-Based Theme Tones

Atelier Ink can automatically switch visual tones depending on the domain.

Example configuration:

  const domainToneMap = {    "blog.ghostheme.com": "tone-pearl",
                             "blog-midnight.ghostheme.com": 
                             "tone-midnight",    
                             "blog-sage.ghostheme.com": "tone-sage",    
                             "blog-paper.ghostheme.com": "tone-paper"
                        };

Available tones:

tone-midnight
tone-sage
tone-paper
tone-pearl