A minimal, responsive theme for Ghost.
CSS Handlebars JavaScript
Pull request Compare This branch is 46 commits ahead, 9 commits behind sethlilly:master.
Latest commit 38aae11 Aug 2, 2015 programster H3 also causes space before next h2
Failed to load latest commit information.
assets H3 also causes space before next h2 Aug 2, 2015
partials Update comments-disqus.hbs Jun 7, 2015
LICENSE Releasing 1.4 Apr 19, 2014
default.hbs adding google analytics May 9, 2015
index.hbs Updated the theme so that the listing of posts looks like someone pin… Jul 26, 2015
package.json merging vapor dark into master because I can't figure for the life of… Jun 7, 2015
page.hbs Releasing 1.4 Apr 19, 2014


Programster Vapor-dark

This is my own custom version of the Vapor theme, which can be seen on the Programster blog.

I have changed:

  • Changing the main text to be black rather than grey so that it's easier to read.
  • the background of inline code is also grey, not just the code blocks
  • both the code blocks and the inline code no longer use alpha, but a solid grey.
  • There is no wrapping in code blocks. If the code is too wide, then a horizontal scrollbar is added to the block.
  • Enabled the Google+ comment system.
  • Conversion to em over px in font sizes etc.
  • subtly rounded corners on code blocks.


Minimal and responsive with a focus on typography, Vapor is a theme that embodies the core concept of Ghost—it fades into the background, bringing the focus to your content.

Supports blog and user images; cover images, while supported in the Ghost admin, are not displayed in the theme due to theme's minimal nature and focus on typography.

Fonts embedded via Google Fonts, including Roboto Slab, Merriweather, and Open Sans Condensed.

The Ghost, Facebook, Twitter, and Google+ icons are trademarks of their respective owners and are from the Casper theme, copyright (c) 2013 Ghost Foundation and released under The MIT License.

Other icons provided by Font Awesome and released under SIL OFL 1.1.

See Vapor in action at Hipster Ghost.

What's New?

Hipster Ghost is always running the latest version of Vapor. You can preview all new features there.

New in 1.4: You may now use the {{> menu}} partial to display a custom menu on your pages. This is helpful for linking to certain posts or static pages. To activate this feature, simply remove the ! in {{!> menu}} in default.hbs. Also included are the {{> header-description}} and {{> footer-description}} partials for those using the menu. You can simply add the ! to {{> header-description}} in the header (now located in default.hbs for all posts and pages) to deactivate. Remove the ! from the {{!> footer-description}} partial call on the same page to activate display of the description in the footer. If you want to edit these partials (to add menu items or other content), you'll find them in the /partials directory. If you're using a self-hosted version of Ghost, you may need to restart or reload Ghost in order for the Handlebars partials to recompile after editing. There are also three new commenting options (Disqus, Facebook, and Google+) that follow the same conventions. You'll find these calls in post.hbs and page.hbs. I contend that Disqus is the best of these three options in terms of appearance and responsiveness; YMMV.

See the changelog for a full list of new features in 1.4.

New in 1.3: Blog logos and author images must be at least 100px in height and width, but do not need to be 1:1.

New in 1.2: A LESS file is included which contains variables allowing you to quickly change the theme's stylesheet. However, I've chosen to exclude less.js from the theme and I recommend using a desktop compiler like CodeKit to process your LESS file.


See the changelog for release details.

Version Release Date
1.4 2014-04-19
1.3 2014-01-12
1.2.1 2013-12-14
1.2 2013-11-10
1.1.2 2013-11-10
1.1.1 2013-10-30
1.1 2013-10-28
1.0 2013-10-18

Contributing and Forking

Vapor is open source and released under the MIT License, and contributions to the code base are welcome and encouraged. Find more information about contributing here.

Copyright & License

Copyright (c) 2013-2014 Seth Lilly - Released under The MIT License.

Are you using Vapor?

If you're using Vapor on a live site, I'd love if you'd send me a message with the URL. I enjoy seeing the customizations and implmentations taking place all over the world. Regardless, thanks for using Vapor!


Thanks to everyone who has installed, starred, forked, contributed to, or otherwise promoted Vapor. This is a labor of love, and it belongs to all of us.

Thanks to @JohnONolan for suggesting this project.

And of course, thanks to @JohnONolan, @ErisDS, and the Ghost team for creating this amazing platform.