This is not a real donut store. This is a free template for subscription ecommerce sites and it's built on top of the APIs of SPHERE.IO, Pactas and Paymill.

Visit a live demo of SPHERE-DONUT store at iwantdonuts.com.

• Install Play 2.1.1.
• Clone sphere-donut project from GitHub.
• Run play run command in root project directory.
• Open your browser and point it to http://localhost:9000.

• Point to SPHERE Login or register a new account with SPHERE Signup.
• Go to Developers -> API Clients to retrieve your project data.
• To use your SPHERE.IO project, modify sphere.project, sphere.clientId and sphere.clientSecret in conf/application.conf.

More about the ecommerce PaaS SPHERE.IO at http://sphere.io.

• Login to the Pactas sandbox or create a new Pactas sandbox account.
• Go to Settings -> Pactas Apps -> My Apps and create a new OAuth client. Make sure to select "Confidential" for the client type.
• Copy the newly created client id and secret to pactas.clientId and pactas.clientSecret in conf/application.conf.

More about recurring billing with Pactas at http://www.pactas.com.

• Register at PAYMILL to get the (test) API keys.
• Go to PAYMILL Cockpit -> My account -> Settings -> API keys to retrieve your keys.
• In your Pactas backend, head to Settings -> Payments -> Payment Providers and edit the Paymill settings. Enter your public and private PAYMILL keys and hit 'Save'.

More information about doing payments with PAYMILL at http://www.paymill.com.

• Install Heroku Toolbelt (create account if needed).
• Run heroku create command in root project directory, will create a new remote for Git.
• Run git push heroku master to push the project to Heroku and deploy it.
• Run heroku open to open your deployed website in a browser.

More information about deploying a Play application to Heroku here.

• Install your favourite IDE (preferably IntelliJ, Eclipse or Netbeans).
• Generate configuration files for your chosen IDE, following these instructions.
• Run play command in root project directory.
• Inside Play Shell, type clean test for compiling and testing it.

This app is a Play Framework app and uses the SPHERE Play SDK.

Have fun!