Fetching contributors…
Cannot retrieve contributors at this time
50 lines (35 sloc) 2.41 KB

Spring Social Showcase (Spring Boot)

This sample app demonstrates many of the capabilities of the Spring Social project, including:

  • Connect to Facebook, Twitter, and LinkedIn
  • Sign in using Facebook, Twitter, and Linked in using ProviderSignInController for provider-signin

Step 1: Register your application

Before you can run the application, you'll need to obtain application credentials from Facebook, Twitter, and LinkedIn by registering the application with each of the service providers:

Be sure to read each platform's usage policies carefully and understand how they impact your use of Spring Social with those platforms.

Step 2: Edit

Once you have registered the application, you'll need to edit src/main/resources/, adding the credentials to the appropriate properties.

Step 3: Run the application

To run, simply import the project into your IDE and deploy to a Servlet 2.5 or > container such as Tomcat 6 or 7. Access the project at http://localhost:8080/spring-social-showcase

Alternatively, you can run the application using Gradle. To make it easier to build the project with Gradle, the Gradle wrapper has been included. The Gradle wrapper makes it possible to run Gradle without having to explicitly install Gradle to your system.

To run the application with Gradle:

$ gradlew bootRun

Or you can build the application with Gradle, then run the resulting WAR file as an executable JAR:

$ gradlew build
$ java -jar build/libs/spring-social-showcase.war

When running the application from the command line, you can access it at http://localhost:8080 from your browser.

Step 4: Participate in the Spring Social community

Discuss Spring Social on StackOverflow at We welcome you to ask questions and we encourage you to answer any you might have insight into.

If you run into any problems or have a suggested new feature, let us know at Or better yet, fork Spring Social on GitHub and send us a pull request to fix a bug or introduce a new feature.