Getting started examples don't successfully run

[gdiscord]

I have tried to run the getting started examples and so far none has been completely successful.

One of the issues that I got help with through the Gitter group is that there must be explicitly declared maven-war-plugin, otherwise the default 2.2 is used which results in error during compile. To fix I had to add the directive below:

org.apache.maven.plugins maven-war-plugin 3.3.2

Another issue is that it is not obvious how to run the examples.

Notably the html page is missing, so you end up seeing a directly listing of the files within the app, instead of rendering the components. The documentation for using the dominocli to start a basic app makes mention of a provided run.sh script to start the app, but it turns out that file is no where to be found.

Also tried the mvp, and although everything loads up the page is blank. opening up the project in eclipse shows that a class that would have been expected to be created, based on the options passed on the command line to dominocli, was not created.

In essence, the examples maintainers need to review that the contents are up to date and that new comers are able to run them successfully. Otherwise it becomes a barrier to entry.

I have so far spent around 4 hours and yet still not able to get any of the examples successfully running.

I'll revisit it in a few days time to see if there is any joy.

[vegegoku]

Can you please add how you created the project in each case? Can you also please specify the commands you executed?

[gdiscord]

I followed the exact steps that is provided in all cases, just substituting my values for the files surround in square brackets [].

For this: https://github.com/DominoKit/domino-ui/wiki/Getting-started I followed "Method 3: Create project using Nalu project initializer"

The last step in that section that says : ""From the gwt devmode dialog click on Launch default browser" could not be followed because it is not clear what is being mentioned there, especially for a total new comer.

For this: https://github.com/DominoKit/domino-mvp/wiki/Getting-started I did everything up to the point where it says
"For gwt compiled mode

cd {appname}-backend
execute mvn exec:java -Dmode=compiled
the server port will be printed in the logs access the application on http://localhost:[port]
"

code server started fine, and so did the gwt app. But the page is blank.

[vegegoku]

I am not the author of the nalu project initializer but there is many users who uses domino with nalu, that is why I keep a section there, we can ask @FrankHossfeld to elaborate on that when he has time.

Now for the domino-mvp project created with domino-cli

the app compiled and loaded, but the page is blank.

That is correct even though the page is blank the project is working correctly, you just created a project but didnt add any page to it, if you check the browser console you will see logs saying the application is initialized
I think I should add that as a note to in the getting started.

The domino-mvp wiki docs have been updated recently with an added tutorial

https://github.com/DominoKit/domino-mvp/wiki

But I still didn't receive any feedback on that
if you would try it out and give me some feedback that would be awesome

you should see something like this in the console when run the app
if you import the project into intellij you will get run configurations prepared for you to use right from the run button

this is what you will need for development
this is just a compound run config that runs both commands of the command line, just more convenient
and the tutorial uses Java 11