Authors: Jamon Holmgren (@jamonholmgren), Ryan Linton (@ryanlntn), and the rest at ClearSight Studio (@clrsightstudio).

Provides a set of command line tools for setting up and developing Concrete5 websites.

Requirements: Designed for Ruby 2.0+ running on OS X Mavericks.

$ gem install pave

$ pave new mywebsite

This:

1. Downloads Concrete 5.6.2.1 (once) into ~/.pave
2. Unzips it into mywebsite
3. Removes extra folders and sets up folder permissions
4. Adds a .gitignore and .keeps
5. Attempts to create a virtual host mywebsite.site

$ pave deploy:setup

This sets up a Git-based deployment script to the remote server and deploys an initial version. SSH access is required. You may run it multiple times and setup as many deployment endpoints as you want.

$ pave deploy

Deploys the site using git. Files and databases are not deployed (see below for how to do that).

$ pave deploy staging feature-branch

Deploys feature-branch to staging remote.

$ pave db:create [mydatabase]

Creates a local MySQL database called mydatabase. Omitting the database name will create a database with the same name as the current directory.

$ pave db:push

Copies the local Concrete5 database to the remote database. Useful for deploying to staging sites.

$ pave db:pull

Copies the remote Concrete5 database into the local database. Useful for obtaining production data for testing.

$ pave db:dump

Creates a database dump file and places it in .db/YYYY-MM-DD_HH-MM-SS-<databasename>.sql.gz.

$ pave files:push

WARNING: be careful with this command! Pushes your local files/* to the remote server, completely replacing the remote server's version.

$ pave files:pull

Pulls the remote files/* folder and replaces your local version.

$ pave files:sync

TODO: Pulls newer remote files and pushes newer local files. Ignores cache and tmp files.

$ sudo pave vh:create [myhost.site]

Sets up an Apache virtual host in the current directory on myhost.site. Omitting the hostname argument will create a virtual host with the same name as the current directory (i.e. myapp.site if the current directory is myapp).

$ sudo pave vh:remove [myhost.site]

Removes myhost.site virtual host.

$ sudo pave vh:backup

Backs up your hosts file and vhost file.

$ sudo pave vh:restore

Restores your previously backed up virtual host file.

$ sudo pave vh:restart

Restarts Apache.

$ pave g:theme [mytheme]

Generates a theme in with the name mytheme in the theme directory. Omitting the theme name will create a theme with the same name as the current directory.

$ pave watch [browser] [mytheme]

Watches for changes in the mytheme directory. Compiles SASS and CoffeeScript files when they change and reloads the browser. The default the browser is Chrome but Safari and Firefox are also supported. A theme with the same name as the current directory is assumed unless a theme name is specified.

$ pave help

Outputs common tasks that pave can do.

$ pave update

0. Create an issue explaining what you'd like to do and get feedback
1. Fork it
2. Create your feature branch (git checkout -b my-new-feature)
3. Commit your changes (git commit -am 'Add some feature')
4. Push to the branch (git push origin my-new-feature)
5. Create new Pull Request

Copyright (c) 2013 Jamon Holmgren

Released under the MIT license.