Skip to content

Perillion/perillion-theme

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

18 Commits
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Perillion Ghost Theme

GitHub release (latest by date) License Ghost Version Maintenance

A minimalist, dark-mode focused Ghost CMS theme designed for personal home server dashboards and portfolios.

Features

  • Dashboard Integration: Automatically detects protected pages ("Members only") and displays a secure login prompt.
  • Home Server Ready: Optimized for linking to self-hosted services (Nextcloud, Immich, etc.).
  • Dark Mode: Built from the ground up with a soothing dark color palette (#0f172a).
  • Responsive: Fully responsive grid layout for mobile and desktop.
  • Project Showcase: Custom card layout for showcasing projects or blog posts.

Installation

Option 1: Upload via Admin Panel (Recommended)

  1. Download the latest release or zip the repository content.
  2. Go to your Ghost Admin Panel (/ghost).
  3. Navigate to Settings -> Design & branding -> Change theme -> Advanced.
  4. Click Upload theme and select your zip file.
  5. Click Activate.

Option 2: Git Clone (For Developers)

SSH into your Ghost server and navigate to the themes directory:

cd /var/www/ghost/content/themes
sudo git clone https://github.com/Perillion/perillion-theme.git
sudo chown -R ghost:ghost perillion-theme
ghost restart

Customization

Navigation

Configure your menu links in Settings -> Navigation. The theme automatically renders them in the top navbar.

Profile Picture

To set your profile picture on the "About" page:

  1. Create a page named "About".
  2. Upload a Feature Image in the page settings.
  3. This image will be displayed as the circular profile avatar.

Contributing

Contributions are welcome! Please feel free to submit a Pull Request.

  1. Fork the repository
  2. Create your feature branch (git checkout -b feature/AmazingFeature)
  3. Commit your changes (git commit -m 'Add some AmazingFeature')
  4. Push to the branch (git push origin feature/AmazingFeature)
  5. Open a Pull Request

License

Distributed under the MIT License. See LICENSE for more information.