spring-boot-react-maven-starter
This is a multi-module Spring Boot React Apache Maven starter app with good defaults. The react app is built using create-react-app.
This project provides productive setup for building Spring Boot React applications. The application is divided into two Maven modules:
backend
: This contains Java code of the application.frontend
: This contains all react JavaScript code of the application.
Running the full application
You can build the package as a single artifact by running the ./mvnw clean install
.
Next, you can run the application by executing:
$ java -jar backend/target/backend-0.1.0-SNAPSHOT.jar
The application will be accessible at http://localhost:8080
.
Features
This starter comes bundled with the following features:
- Multi module Maven project: A multi module project to modularize backend and frontend code separately.
- Maven wrapper: So, you don't need to install Maven on your machine.
- Checkstyle: Enforce sane coding standard guidelines.
- ErrorProne: Find errors in your code.
- Copy paste detection: Uses PMD CPD check to detect code duplication.
- CORS enabled: A global configuration is added to enable CORS so that frontend can work seamlessly with backend during development.
- REST API base path: Sets the base REST API path to
/api
. You can configure it by changingrest.api.base.path
property. - Bundle Git commit information
Running the backend for development mode
There are multiple ways to run the backend. For development, you can use your favorite IDE and run the
com.example.app.Application
. As soon as your code compiles, Spring Boot DevTools will reload the code.
You can also run the application using Maven.
$ cd backend
$ ../mvnw spring-boot:run
Running the frontend for development mode
You will need 6.0+ and yarn to run the dev server and build the project.
Make sure to install yarn on your development machine.
To install all the required binaries for your project, you can run following command.
$ cd frontend
$ ../mvnw frontend:install-node-and-yarn frontend:yarn
Once the above command finishes, you can start the frontend using the yarn start
command.
Hot reloading
Both the frontend and backend support hot reloading.