# Koudoku
[](https://rubygems.org/gems/koudoku) [](https://codeclimate.com/github/andrewculver/koudoku) [](https://travis-ci.org/andrewculver/koudoku)
Robust subscription support for Ruby on Rails apps using [Stripe](https://stripe.com), including out-of-the-box pricing pages, payment pages, and subscription management for your customers. Also makes it easy to manage logic related to new subscriptions, upgrades, downgrades, cancellations, payment failures, and streamlines hooking up notifications, metrics logging, etc.
To see an example of Koudoku in action, please visit [Koudoku.org](http://koudoku.org/).
Koudoku is authored and maintained by [Andrew Culver](http://twitter.com/andrewculver) and [Christoph Engelhardt](https://twitter.com/itengelhardt). If you find it useful, consider checking out [Churn Buster](http://churnbuster.io). It's designed to help you handle the pain points you'll run into when doing payments at scale.
## Installation
Include the following in your `Gemfile`:
```ruby
gem 'koudoku'
```
After running `bundle install`, you can run a Rails generator to do the rest. Before installing, the model you'd like to have own subscriptions must already exist. (In many cases this will be `user`. It may also be something like `company`, etc.)
```ruby
rails g koudoku:install user
rake db:migrate
```
Add the following to `app/views/layouts/application.html.erb` before your `` tag closes:
```ruby
<%= yield :koudoku %>
```
(This allows us to inject a Stripe `