cyberdog52/hackathon

Zuehlke Java Fullstack Hackathon Template Project

Java Fullstack Hackathon 2024

---

The project is split into four folders

• java-backend
• dotnet-backend
• react-frontend
• angular-frontend

You should be able to combine both backends with any of the frontends interchangeably.
You will decide with your team which technologies to use.

Setup

If your setup already has some of the required tools installed, please adjust accordingly.

1. Both frontends need Node to run. Install newest Node from here https://nodejs.org/en/ (currently 20.11.1 LTS)
2. Run npm install -g [email protected]
3. Run npm install -g @angular/[email protected]
4. Verify your versions with ng version:
   Angular CLI: 17.2.3
   Node: 20.11.1
   Package Manager: npm 10.5.0
5. Install a new version of IntelliJ or VSCode
6. Clone the master branch with git clone https://github.com/Cyberdog52/hackathon.git
7. (optional) Open the project with IntelliJ and let gradle build the project. Skip this step if you don't intend to work with java during the hackathon.
8. (optional) If prompted, install java (17.0.5). Skip this step if you don't intend to work with java during the hackathon.
9. Install the npm dependencies with cd angular-frontend followed by npm install
10. Install the npm dependencies with cd react-frontend followed by npm install

During the hackathon your team can decide to use a custom branch on this GitHub repository or to fork it to your own private repository.

Run

Start java backend

1. Start the java backend either by
   1. By selecting the Java Backend run configuration and running it
   2. Or by executing ./gradlew java-backend:bootRun

You should be able to open the Swagger endpoint documentation at http://localhost:8080/swagger-ui/index.html.

Dotnet backend

Prerequisites

Tools

Name	Purpose	Version	Version command	License
Visual Studio 2022	IDE	17.9.2		MIT
.NET SDK	.NET runtime and development tools	8.0	dotnet --version	MIT, Apache 2.0

In Visual Studio Installer, make sure to include the ASP.NET and web development workload.

Run dotnet backend

You should be able to open the Swagger endpoint documentation at http://localhost:8080/swagger/index.html.

1. make sure that you have all the prerequisites installed
2. Start the dotnet backend either by

   1. Clicking on the green play button HackathonWebApi

      

   2. Or by using dotnet commands

      > cd hackathon\dotnet-backend\HackathonWebApi
      > dotnet restore
      > dotnet clean
      > dotnet run

Start Angular frontend

1. By selecting the Angular Frontend and running it
2. Or by executing cd angular-frontend followed by npm start

You should now be able to open http://localhost:4200 to access the frontend.

Now you should see the following screen:

Start React frontend

1. By selecting the React Frontend and running it
2. Or by executing cd react-frontend followed by npm run dev

You should now be able to open http://localhost:5137 to access the frontend.

Now you should see the following screen: