FuskDev

Fuskdev short for full stack development. A template for developing api and web containerized using sprint boot framework, GraphQL and react ui library.

How to run

Installing Build Tools

Follow Docker Desktop installation Guide

Starts the application

% docker compose up

Open browser and enter localhost in url bar. You will find the icon shown in default page that will lead to user management.

Start Developing

The system is containerized in four parts: Database, USERSERV, GATEWAY and Web. Turnoff userserv-1, gateway-1 and web-1 in docker desktop container dashboard.

GATEWAY

• GATEWAY is GraphQL based implemented in spring boot.

• Follow how to install Java and Gradle in your system.

• It's ideal to develop spring boot using intellij. Follow how to install here.

• After successfull installation open the folder userserv in intellij and wait to finish sync process.

• Configure VM options in build process to use application-dev.properties containing USERSERV connection service.

  -Dspring.profiles.active=dev
  

  

• Alternatively you can use gradle command to run the API in terminal regardless which editor you use. In project root folder execute

  cd gateway/gradle
  ./gradlew bootRun --args='--spring.profiles.active=dev'

• GATEWAY depends its datasource from USERSERV and a necessary to be running.

• Test GATEWAY in browser by entering localhost:8081/graphiql?path=/graphql

  

USERSERV

• USERSERV is REST based implemented in spring boot.

• Follow how to install Java and Gradle in your system.

• It's ideal to develop spring boot using intellij. Follow how to install here.

• After successfull installation open the folder userserv in intellij and wait to finish sync process.

• Configure VM options in build process to use application-dev.properties containing database connection service.

  -Dspring.profiles.active=dev
  

  

• Alternatively you can use gradle command to run the API in terminal regardless which editor you use. In project root folder execute

  cd userserv/gradle
  ./gradlew bootRun --args='--spring.profiles.active=dev'

• Test USERSERV in browser by entering localhost:8080/api/user

  

Web

• Follow how to install node and npm.

• Open folder web in your favorite editor.

• Execute npm command to run web application in project root folder

  cd web
  npm run start

• Test Web by entering localhost:3000