{"id":19622250,"url":"https://github.com/commercetools/commercetools-donut","last_synced_at":"2025-12-18T00:03:21.293Z","repository":{"id":11842953,"uuid":"14399855","full_name":"commercetools/commercetools-donut","owner":"commercetools","description":"Store template for subscription based ecommerce business model","archived":false,"fork":false,"pushed_at":"2017-04-11T11:18:16.000Z","size":3277,"stargazers_count":11,"open_issues_count":16,"forks_count":8,"subscribers_count":97,"default_branch":"master","last_synced_at":"2025-04-20T15:17:54.669Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":null,"language":"Java","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"other","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/commercetools.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE.md","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null}},"created_at":"2013-11-14T16:06:14.000Z","updated_at":"2017-09-29T20:36:29.000Z","dependencies_parsed_at":"2022-08-29T08:50:45.339Z","dependency_job_id":null,"html_url":"https://github.com/commercetools/commercetools-donut","commit_stats":null,"previous_names":[],"tags_count":0,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/commercetools%2Fcommercetools-donut","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/commercetools%2Fcommercetools-donut/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/commercetools%2Fcommercetools-donut/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/commercetools%2Fcommercetools-donut/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/commercetools","download_url":"https://codeload.github.com/commercetools/commercetools-donut/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":251246394,"owners_count":21558762,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":[],"created_at":"2024-11-11T11:26:54.562Z","updated_at":"2025-12-18T00:03:16.206Z","avatar_url":"https://github.com/commercetools.png","language":"Java","funding_links":[],"categories":[],"sub_categories":[],"readme":"commercetools Donut Store\n=====================\n\n[![Build Status](https://travis-ci.org/commercetools/commercetools-donut.svg?branch=master)](https://travis-ci.org/commercetools/commercetools-donut)\n[![Heroku](http://heroku-badge.herokuapp.com/?app=ct-donut-prod\u0026style=flat\u0026svg=1)](https://ct-donut-prod.herokuapp.com/)\n\nThis 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 [commercetools platform](http://commercetools.com), [Pactas](http://www.pactas.com) and [Paymill](https://www.paymill.com).\n\nThis template is based on the [SPHERE JVM SDK](https://github.com/commercetools/commercetools-jvm-sdk).\nIf you are looking for a regular web-shop template using the SPHERE JVM SDK, please have a look at [Sunrise](https://github.com/commercetools/commercetools-sunrise-java) instead.\n\n## Live demo\nVisit a live demo of SPHERE-DONUT store at [iwantdonuts.com](http://www.iwantdonuts.com).\n\n## Getting started\n\n### Set it up\n- Install [Play 2.4.3](http://www.playframework.com/documentation/2.4.x/Installing).\n- [Clone](http://git-scm.com/book/en/Git-Basics-Getting-a-Git-Repository#Cloning-an-Existing-Repository) sphere-donut project from GitHub, or download it as [zip file](https://github.com/commercetools/commercetools-donut/archive/master.zip).\n- Run `sbt run` command in root project directory.\n- Open your browser and point it to [http://localhost:9000](http://localhost:9000).\n\n### Product import\n\nThere is a flag named `fixtures.import.enabled` in the configuration file `conf/application.conf`, which allows an initial import of the required JSON-based product model\ninto the commercetools-platform. After a successful initial import, this flag can be set to `false` to improve the startup time of the application.\n\nIf you don't perform an initial import, you have to provide the product model (see `conf/data`) in your platform project, or the application will raise a `ProductNotFoundException` on application startup.\n\n### Configure it\n\n#### SPHERE.IO data\n- Point to [SPHERE Login](https://admin.sphere.io/login) or register a new account with [SPHERE Signup](https://admin.sphere.io/signup).\n- Go to `Developers -\u003e API Clients` to retrieve your project data.\n![API Backend](https://raw.github.com/commercetools/commercetools-donut/master/public/images/mc_api.png)\n- To use your SPHERE.IO project, modify `sphere.project`, `sphere.clientId` and `sphere.clientSecret` in `conf/application.conf`.\n\nMore about the ecommerce PaaS SPHERE.IO at [http://sphere.io](http://sphere.io).\n\n#### Pactas keys\n- [Login to the Pactas sandbox](https://sandbox.pactas.com) or [create a new Pactas sandbox account](https://sandbox.pactas.com/#/signup).\n- Go to `Settings -\u003e Pactas Apps -\u003e My Apps` and create a new OAuth client. Make sure to select \"Confidential\" for the client type.\n![PactasAppRegister](https://raw.github.com/commercetools/commercetools-donut/master/public/images/pactas-register-app.png)\n- Copy the newly created client id and secret to `pactas.clientId` and `pactas.clientSecret` in `conf/application.conf`.\n\nMore about recurring billing with Pactas at http://www.pactas.com.\n\n#### PAYMILL keys\n- [Register at PAYMILL](https://app.paymill.com/en-gb/auth/register) to get the (test) API keys.\n- Go to `PAYMILL Dashboard -\u003e Development -\u003e API keys` to retrieve your keys.\n- In your Pactas backend, head to `Settings -\u003e Payment Settings -\u003e Payment Providers` and edit the Paymill settings. Enter your public and private PAYMILL keys and hit 'Save'.\n![PactasPaymill](https://raw.github.com/commercetools/sphere-donut/master/public/images/pactas-paymill.png)\n\nMore information about doing payments with PAYMILL at http://www.paymill.com.\n\n### Deploy it\n\n#### heroku\n\nTo run this SPHERE.IO example web shop on [heroku](https://www.heroku.com) just click the button:\n\n\u003ca href=\"https://heroku.com/deploy?template=https://github.com/commercetools/sphere-donut\"\u003e\u003cimg src=\"https://www.herokucdn.com/deploy/button.png\" alt=\"Deploy\"\u003e\u003c/a\u003e\n\n### Develop it\n\n- Install your favourite IDE (preferably IntelliJ, Eclipse or Netbeans).\n- Import the project into your chosen IDE, following [these instructions](http://www.playframework.com/documentation/2.4.x/IDE).\n- Run `sbt clean test` command in root project directory for compiling and testing it.\n\n\u003e This app is a [Play Framework](http://www.playframework.com/documentation/2.4.x/Home) app and uses the [SPHERE JVM SDK](https://github.com/commercetools/commercetools-jvm-sdk).\n\nHave fun!\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fcommercetools%2Fcommercetools-donut","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fcommercetools%2Fcommercetools-donut","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fcommercetools%2Fcommercetools-donut/lists"}