Posthaven Theme
The posthaven_theme gem provides command line tools for developing a Posthaven theme on your computer and pushing updates to Posthaven.
Requirements
Ruby
This gem requires Ruby 2.0 or above.
Posthaven API Key
Log in and get your Posthaven account API key here.
Installation
To install the posthaven_theme gem use 'gem install' (you might have use 'sudo gem install')
gem install posthaven_theme
to update to the latest version
gem update posthaven_theme
Usage
The gem installs the phtheme CLI program.
List available commands
phtheme help
Generate a configuration file. For your API key see above.
phtheme configure api-key
Upload all files
phtheme upload
Upload a single theme file
phtheme upload layouts/theme.liquid
Remove a theme file
phtheme remove assets/layout.liquid
Completely remove all old theme files and replace them with current local versions
phtheme replace
Watch the current theme directory and upload any files as they change
phtheme watch
Configuration
Running phtheme configure generates config.yml file in the base directory of your theme. If you are storing your theme in version control it is highly recommended that you DO NOT store this file in version control, e.g. in git add it to your .gitignore.
config.yml has the following options:
-
api_key– Your Posthaven API key -
theme_id– The ID of the theme to edit. The easiest way to populate the theme id is via theconfigurecommand above.
See the phtheme configure command above for one step setup of the config.yml file.
Thanks
A huge thanks to Shopify for their shopify_theme gem upon which this is based.