Docs » Quick start

Webhook is a rapid development tool built with Node, Grunt and Firebase that excels at building complex, content editable web sites. It is loosely aimed at HTML / CSS capable Designers that are comfortable with template logic but don't have the time or the want to code and host a custom backend.

Five steps to a live, editable website

1. Install the Webhook App or Command Line Tools

Webhook can be installed either as an application, or as a set of command line tools to run in your terminal. For new users unfamiliar with the command line, we recommend using our App.

Download the App

Webhook for Mac OSX Webhook for Windows

Once installed, load up the app, create a new account and then create a new site. If it doesn't do so automatically click the "Run local server" option to get started with the tools. Move ahead to step 2 below.


Or Install the command line tools

For advanced users, Webhook can also be installed and run on the command line. If this stuff looks unfamiliar, check out our installation guide for instructions on installing Node.

# If you're using linux, you might need to sudo
npm install -g grunt-cli wh

Once installed, create a new site somewhere on your local machine. At this point it will ask you to create a new account. Just give it your email / password combo.

wh create sitename          # Your site will live at sitename.webhook.org until you apply your own domain.

cd into the directory that was created and run a local runserver.

wh serve

2. Design your CMS

You now have a local site running, pop into the CMS, either choose a theme or start from scratch. Use the form builder to create your CMS forms. Remember, you can make forms for anything from a full blog system to a single editable field for your analytics code.

3. Edit your templates

When you are finished creating your forms, Webhook will automatically create scaffolding templates in sitename/templates. You're now free to call data from the CMS on any page using our template rules and filters.

4. Deploy your site live

When you're done editing you can deploy your website live onto the Internet by clicking the "Deploy local changes" button, or if you're using the command line, running wh deploy in your site directory.

Your site will temporarily live at sitename.webhook.org until you attach a custom domain.

5. Add team members, start editing the live site

Your site now exists at http://sitename.webhook.org and your CMS is available at http://sitename.webhook.org/cms/. If you haven't yet already, invite your friends into the CMS. They'll now be able to login to the CMS and add content to your site. As you make changes to the live CMS, we'll rebuild the site automatically.

You can also apply apply a custom domain and set up version control.