Fullstack Boilerplate

Contents

• Backend service - a Java/Spring Boot service with a /ping endpoint. Extend with your code.
• Frontend app - a React app. Extend with your code.
• E2E test suites - a backend and a frontend Cypress test suites. Extend with your tests.
• Pipeline - a test Runner that executes the Cypress tests on push to a branch other than master/main.

Tech Stack

Backend

• Java 17
• Spring Boot 2
• SQLite 3
• Gradle 7

Frontend

• React
• Typescript

Misc

• Cypress
• GitHub Actions

Getting started

1. Make sure the required version of Java (17) is configured on your local env.

2. Make sure npm & node are configured on your local env. You can download those distributions for your platform here

3. Build your app.

npm install
npm run build # both Java/Spring Boot backend and Vue frontend
npm run build:backend # only Java/Spring Boot backend
npm run build:frontend # only React frontend

4. Start your app.

npm install
npm run start # both Java/Spring Boot backend and Vue frontend
npm run start:backend # only Java/Spring Boot backend
npm run start:frontend # only React frontend

5. Run the Cypress tests.

npm run test # run project tests under `cypress/integration`

---

Did you find this repo useful? Give me a shout on / LinkedIn.