NationSync
NationSync is a Ruby client for synchronizing a NationBuilder theme with a local directory. It allows you to edit theme files locally and have your changes automatically sent to the server.
The core of NationSync is the theme tool API used internally by the NationBuilder Theme Sync for Mac. As such this may break with the whims of the developers at NationBuilder. NationSync also uses the Listen gem from Guard to monitor the file system for changes, so it's hopefully cross-platform.
Installation
It's easy:
gem install nationsync
Usage
Make sure you are in the directory that you'll be syncing your theme into when running these commands!
1. Account setup
Next run nationsync init
; this will prompt you for your domain, email, and password. It then authenticates with NationBuilder and saves its access token and session in .nbconfig1
.
2. Theme setup
Run nationsync pick_theme
; it will fetch a list of themes and allow you to pick one. Then run nationsync fetch
to fetch theme files into the current directory. To pull new files or updated files run nationsync fetch
again. (Running nationsync clean
will also remove all NationSync theme files from the current directory, however it will leave the config file so you can then fetch again.)
3. Watching
nationsync watch
will start watching the directory for changes and will upload any changed files to NationBuilder.
Contributing
Fork and pull-request!
License
Copyright 2013 Dirk Gadsden and released under a modified New BSD License. See LICENSE.txt for details.