{"id":19335773,"url":"https://github.com/buttercms/java-starter-buttercms","last_synced_at":"2025-04-23T00:32:09.095Z","repository":{"id":38314101,"uuid":"490716184","full_name":"ButterCMS/java-starter-buttercms","owner":"ButterCMS","description":"Drop-in proof-of-concept Java + Spring app, fully integrated with your ButterCMS account","archived":false,"fork":false,"pushed_at":"2025-03-19T10:10:17.000Z","size":793,"stargazers_count":0,"open_issues_count":1,"forks_count":5,"subscribers_count":4,"default_branch":"master","last_synced_at":"2025-04-20T23:04:22.867Z","etag":null,"topics":["blog","blog-engine","butter","buttercms","cms","java","starter","starter-kit","starter-project"],"latest_commit_sha":null,"homepage":"https://java-starter-buttercms.herokuapp.com/","language":"CSS","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":null,"status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/ButterCMS.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":null,"code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null}},"created_at":"2022-05-10T13:46:58.000Z","updated_at":"2025-02-25T09:46:53.000Z","dependencies_parsed_at":"2023-01-22T09:00:59.482Z","dependency_job_id":null,"html_url":"https://github.com/ButterCMS/java-starter-buttercms","commit_stats":null,"previous_names":[],"tags_count":2,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ButterCMS%2Fjava-starter-buttercms","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ButterCMS%2Fjava-starter-buttercms/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ButterCMS%2Fjava-starter-buttercms/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ButterCMS%2Fjava-starter-buttercms/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/ButterCMS","download_url":"https://codeload.github.com/ButterCMS/java-starter-buttercms/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":250348329,"owners_count":21415894,"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":["blog","blog-engine","butter","buttercms","cms","java","starter","starter-kit","starter-project"],"created_at":"2024-11-10T03:08:47.349Z","updated_at":"2025-04-23T00:32:09.080Z","avatar_url":"https://github.com/ButterCMS.png","language":"CSS","funding_links":[],"categories":[],"sub_categories":[],"readme":"![Java version](https://img.shields.io/badge/Java-17-red) ![Version](https://img.shields.io/badge/Version-1.3.0-blue) ![Spring Boot](https://img.shields.io/badge/Spring%20Boot-3.2.3-green)\n\n# Java Spring Boot +  ButterCMS Starter Project\n\nThis Java + Spring Boot starter project fully integrates with dynamic sample \ncontent from your ButterCMS account, including main menu, pages, blog posts, \ncategories, and tags, all with a beautiful, custom theme with already-implemented \nsearch functionality. All of the included sample content is automatically created \nin your account dashboard when you sign up for a free trial of ButterCMS.\n\n[View our live demo hosted at Heroku](https://java-starter-buttercms.herokuapp.com/), or you can click a button below\nto deploy your own copy of our starter project to the provider of your  choice.\n\n[![Deploy](https://www.herokucdn.com/deploy/button.svg)](https://heroku.com/deploy?template=https://github.com/ButterCMS/java-starter-buttercms\u0026env%5BJAVA_BUTTER_CMS_API_KEY%5D=check%20https://buttercms.com/settings)\n\n\n## 1. Installation\n\n### Prerequisites\n\nThis project requires Java 17 and Maven. All other dependencies (Spring Boot, Java SDK for ButterCMS) are automatically managed by Maven.\n\n#### Installing Java 17 and Maven on Ubuntu\n```bash\n# Update package list and install OpenJDK 17\nsudo apt update \u0026\u0026 sudo apt install openjdk-17-jdk\n# Install Maven\nsudo apt install maven\n```\n\n#### Installing Java 17 and Maven on macOS\n```bash\n# Using Homebrew\nbrew install --cask temurin@17\n# Install Maven\nbrew install maven\n```\n\nTo get started, clone and cd into the repo.\n\n```bash\ngit clone https://github.com/ButterCMS/java-starter-buttercms.git\ncd java-starter-buttercms\n```\n\n### 2. Set API Token\n\nTo fetch your ButterCMS content, add your API token as an environment variable.\n\n```bash\n$ echo 'JAVA_BUTTER_CMS_API_KEY=\u003cYour API Token\u003e' \u003e\u003e .env\n```\n\n### 3. Build the project\n\nBuild the project with the following command\n\n```bash\n$ mvn install\n```\n\n### 4. Run the project\n\nTo view the app in the browser, you'll need to run the local development server:\n\n```bash\n$ mvn spring-boot:run\n```\nAlternatively, you can run it directly via the `java` command\n\n```bash\n$ java -jar target/spring-starter-buttercms-*.jar\n```\n\nwhere the file name `spring-starter-buttercms` will be appended by the value of the version tag `\u003cversion\u003e` in [pom.xml](pom.xml)\n\nCongratulations! Your starter project is now live. To view your project, \npoint your browser to [http://localhost:8080](http://localhost:8080).\n\n## 5. Deploy on Heroku\n\nDeploy your Spring Boot app using Heroku. With a single click, you'll create a \ncopy of our starter project in your Git provider account, instantly deploy it, \nand institute a full content workflow connected to your ButterCMS account. Smooth.\n\n[![Deploy](https://www.herokucdn.com/deploy/button.svg)](https://heroku.com/deploy?template=https://github.com/ButterCMS/java-starter-buttercms\u0026env%5BJAVA_BUTTER_CMS_API_KEY%5D=check%20https://buttercms.com/settings)\n\n\n### 6. Previewing Draft Changes\n\nBy default, your starter project is set up to allow previewing of draft changes \nsaved in your ButterCMS.com account. To disable this functionality, set the \nfollowing value in your .env file: `JAVA_BUTTER_CMS_PREVIEW=false`\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fbuttercms%2Fjava-starter-buttercms","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fbuttercms%2Fjava-starter-buttercms","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fbuttercms%2Fjava-starter-buttercms/lists"}