mr-ufukgurbuz / spring-boot-react-typescript-full-stack-app-demo

This project is a boilerplate which contains backend (SpringBoot, Hibernate, SQL/NoSQL) and frontend (React/Typescript) technologies.

Spring Boot + React + Typescript + Hibernate Boilerplate

A boilerplate for Spring Boot + React + Typescript projects with Hibernate (H2 and MongoDB)

Includes:

Front-end:

• React and Typescript boilerplate files
• AntD (Ant Design) React UI library
• Axios promise-based HTTP Client

Back-end:

• SpringBoot boilerplate files
• Maven build project structure
• Hibernate Object Oriented Database Management
• H2 embedded database integration
• MongoDB NoSQL database integration
• log4j2 new generation logging
• JUnit unit tests

Setup

You should install above technologies and tools to your computer. You can search these instructions in Google.

Build and Run

First of all you need to configure the database. Properties are located in ./backend/src/main/resources/application.properties file.

By default application is using H2 and MongoDB databases.

H2 in-memory database (name: testdb).

MongoDB database (name: demo-app-db, user: user, password: password).

1. Run npm clean install --prefix frontend to install front-end dependencies.
2. Run npm run build:prod --prefix frontend to build React/Typescript application.
3. Run mvn clean compile -f backend to compile a spring boot application.
4. Run mvn install -f backend to start spring boot application on embedded server.

By default backend server will be running on port 8080.

Development

• npm start --prefix frontend to start front-end server for development.
• npm run start:prod --prefix frontend to start front-end server with service-workers.
• mvn install -f backend to start spring boot application on embedded server.

By default frontend server will be running on port 3000

Testing

• npm test --prefix frontend - to run front-end unit tests.
• mvn test -f backend - to run backend server tests.

Technologies used

Back-end:

• spring-boot-starter-web
• spring-boot-starter-security
• spring-boot-starter-data-jpa
• spring-boot-starter-data-mongodb
• spring-boot-starter-hateoas
• h2
• spring-kafka
• spring-boot-starter-log4j2
• lombok
• junit
• maven

Front-end:

• react
• react-dom
• react-redux
• react-router-dom
• react-scripts
• redux
• typescript
• antd
• axios
• i18next

License

springBoot-react-typescript-boilerplate is released under the MIT License.