React Frontend for Spring Boot PetClinic demo

This project was forked from original Spring Boot Petclinic - spring-petclinic-reactjs. It's a port of the Spring (Boot) PetClinic demo with a frontend built using ReactJS, TypeScript and UI tests written with Selenide.

Related projects

Note there is another Spring PetClinic example that uses React: spring-petclinic-graphql. Beside React that example uses GraphQL for API queries instead of the REST API.

Install and run

Database configuration

You may start a Postgresql database with docker:

docker run -p 5432:5432 -e POSTGRES_USER=petclinic -e POSTGRES_PASSWORD=qKqUu2vAuf -e POSTGRES_DB=petclinic -d postgres:9.6.1

Application configuration

Note: Spring Boot Server App must be running before starting the client!

To start the server, launch a Terminal and run from the project's root folder (spring-petclinic-reactjs-ui-tests):

1. ./gradlew clean build
2. java -jar application/build/libs/spring-petclinic-1.7.0-SNAPSHOT.jar

but there is a more preferable option to run Spring Boot from IDEA:

open /application/src/main/java/org/springframework/samples/petclinic/PetClinicApplication.java run main method

When the server is running you can try to access the API for example to query all known pet types:

curl http://localhost:8080/api/pettypes

After starting the server you can install and run the client from the frontend folder:

0. cd frontend
1. npm install (installs the node modules and the TypeScript definition files)
2. npm start
3. Open http://localhost:3000

(Why not use the same server for backend and frontend? Because Webpack does a great job for serving JavaScript-based SPAs and I think it's not too uncommon to run this kind of apps using two dedicated server, one for backend, one for frontend)

Local run

• Test classes have to extend org.springframework.samples.petclinic.tests.LocalUiTest
• Spring Boot app, database and frontend must be launched

From the original sample README file:

Understanding the Spring Petclinic application with a few diagrams

See the presentation here

In case you find a bug/suggested improvement for Spring Petclinic ReactJS UI Tests

Issue tracker is available here: https://github.com/igor-dmitriev/spring-petclinic-reactjs-ui-tests

Contributing

The issue tracker is the preferred channel for bug reports, features requests and submitting pull requests.