Initial setup of java example app (#1)

Author: Laura

.env.sample

@@ -0,0 +1,3 @@
+## DevCycle SDK Key ##
+# This can be found in the DevCycle dashboard Settings under "Environments & Keys"
+DEVCYCLE_SERVER_SDK_KEY="<YOUR_SDK_KEY>"

.gitignore

@@ -1,24 +1,39 @@
-# Compiled class file
-*.class
+HELP.md
+.gradle
+build/
+!gradle/wrapper/gradle-wrapper.jar
+!**/src/main/**/build/
+!**/src/test/**/build/
 
-# Log file
-*.log
+### STS ###
+.apt_generated
+.classpath
+.factorypath
+.project
+.settings
+.springBeans
+.sts4-cache
+bin/
+!**/src/main/**/bin/
+!**/src/test/**/bin/
 
-# BlueJ files
-*.ctxt
+### IntelliJ IDEA ###
+.idea
+*.iws
+*.iml
+*.ipr
+out/
+!**/src/main/**/out/
+!**/src/test/**/out/
 
-# Mobile Tools for Java (J2ME)
-.mtj.tmp/
+### NetBeans ###
+/nbproject/private/
+/nbbuild/
+/dist/
+/nbdist/
+/.nb-gradle/
 
-# Package Files #
-*.jar
-*.war
-*.nar
-*.ear
-*.zip
-*.tar.gz
-*.rar
+### VS Code ###
+.vscode/
 
-# virtual machine crash logs, see http://www.java.com/en/download/help/error_hotspot.xml
-hs_err_pid*
-replay_pid*
+.env

README.md

@@ -1,2 +1,39 @@
-# example-java
-An example app built using the DevCycle Java SDK
+# DevCycle Java Server SDK Example App
+
+An example app built using the [DevCycle Java Server SDK](https://docs.devcycle.com/sdk/server-side-sdks/java/) with local bucketing
+
+## Requirements
+
+Java 17+
+
+## Creating a Demo Feature
+This example app requires that your project has a feature with the expected variables, as well as some simple targeting rules. 
+
+#### ⇨ [Click here](https://app.devcycle.com/r/create?resource=feature&key=hello-togglebot) to automatically create the feature in your project ⇦
+
+When you run the example app and switch your identity between users, you'll be able to see the feature's different variations.
+
+## Running the Example
+### Setup
+
+* Create a `.env` file and set `DEVCYCLE_SERVER_SDK_KEY` to your Environment's SDK Key.\
+You can find this under [Settings > Environments](https://app.devcycle.com/r/environments) on the DevCycle dashboard.
+[Learn more about environments](https://docs.devcycle.com/essentials/environments).
+
+### Development
+
+`./gradlew bootRun`
+
+Runs the app in the development mode.\
+Requests may be sent to [http://localhost:8080](http://localhost:8080).
+
+## Documentation
+For more information about using the DevCycle Java Server SDK, see [the documentation](https://docs.devcycle.com/sdk/server-side-sdks/java/)
+
+### Additional Links
+These additional references should also help you:
+
+* [Official Gradle documentation](https://docs.gradle.org)
+* [Spring Boot Gradle Plugin Reference Guide](https://docs.spring.io/spring-boot/docs/3.2.2/gradle-plugin/reference/html/)
+* [Create an OCI image](https://docs.spring.io/spring-boot/docs/3.2.2/gradle-plugin/reference/html/#build-image)
+* [Gradle Build Scans – insights for your project's build](https://scans.gradle.com#gradle)

build.gradle

@@ -0,0 +1,32 @@
+plugins {
+	id 'java'
+	id 'org.springframework.boot' version '3.2.2'
+	id 'io.spring.dependency-management' version '1.1.4'
+}
+
+group = 'com.hello_togglebot'
+version = '0.0.1-SNAPSHOT'
+
+java {
+	sourceCompatibility = '17'
+}
+
+repositories {
+	mavenCentral()
+}
+
+dependencies {
+	implementation 'com.devcycle:java-server-sdk:+'
+	implementation 'org.springframework.boot:spring-boot-starter-web'
+	testImplementation 'org.springframework.boot:spring-boot-starter-test'
+	implementation 'io.github.cdimascio:dotenv-java:3.0.0'
+}
+
+tasks.named('test') {
+	useJUnitPlatform()
+}
+
+apply plugin: 'application'
+
+mainClassName = 'com.hello_togglebot.HelloApplication'
+

gradle/wrapper/gradle-wrapper.jar

@@ -0,0 +1,7 @@
+distributionBase=GRADLE_USER_HOME
+distributionPath=wrapper/dists
+distributionUrl=https\://services.gradle.org/distributions/gradle-8.5-bin.zip
+networkTimeout=10000
+validateDistributionUrl=true
+zipStoreBase=GRADLE_USER_HOME
+zipStorePath=wrapper/dists