README.md

WebPutty: The Open Source Transmogrifier

What the what?

WebPutty is a simple CSS editing and hosting service that you can run on Google App Engine.

WebPutty gives you a syntax-highlighting CSS editor you can use from anywhere, the power of SCSS and Compass, a side-by-side preview pane, and instant publishing with minification, compression, and automatic cache control.

You can get started with just a pair of tags in your website's template and WebPutty will host and serve your published CSS minified and gzipped for super speed.

Intrigued? Read more about the motivation behind WebPutty, how it came to be, and how it ended up being open-source.

How to get WebPutty up and running on your very own sparkly Google App Engine account:

1. Download and install Python 2.7 and the Google App Engine SDK for Python

• Clone this repo

• Log into Google App Engine and create a new application

• Open up app.yaml in the root of this repo and update application to match the name of your newly created Google App Engine application

• Open up settings.py (also in the root of this repo) and update the following variables:

  • invite_sender_email
  • incoming_sender_email
  • forward_mail_to
  • secret_key

• Install pip

• pip install fabric

• fab deploy

• sip lemonade

Advanced Setup:

For page preview images:

• Go to http://url2png.com and sign up for an account
  • Add these settings to the url2png section in settings.py

To store WebPutty stylesheets using Google Cloud Storage (faster and cheaper than GAE):

• Sign up for Google Cloud Storage via Google's API console
  • Update google_bucket and use_google_cloud_storage in settings.py

Copyright

Copyright (c) 2011-2013 Fog Creek Software Inc.

Some of the icons, images, and sample HTML & CSS used by WebPutty are licensed under the following terms:

• Creative Commons Attribution License

  • FatCow Web Hosting, Farm-Fresh Web Icon Pack
  • design deck, IC Minimal Icon Set
  • Yusuke Kamiyamane, Fugue Icon Pack
  • Mark Pilgrim, Dive into HTML5

• Creative Commons Attribution-NoDerivs License

  • Double-J Design, Siena Icon Pack

• Creative Commons Attribution-Noncommercial-Share Alike License (with explicit permission for use in WebPutty)

  • Hayes Roberts, www.bluebison.net

License

WebPutty is licensed under the MIT license.