2. Guides

Our goal is to provide a smooth starting experience to all users of devonfw, no matter how experienced they are or what their stakeholder role is. To achieve this, we provide a list of recommended guides here:

For Students and Junior Engineers:

For Senior Engineers and Architects:

For Team Leaders and Product Ambassadors:

2.1. Build Your First devonfw Application

JumpTheQueue is a small application based on the devonfw framework, which you can create yourself by following our simple step-by-step tutorial. By doing so, you will learn about the app development workflow and gain insight into the design of a professional business information system. Please visit the JumpTheQueue wiki and start working trough the tutorial HERE.

Tip
The tutorial assumes you have successfully set up the devonfw-ide previously.

You can also clone the project and explore the finished source code via:

git clone https://github.com/devonfw/jump-the-queue.git
JumpTheQueue Screenshots

Another way to check out the JumpTheQueue-Application is to try our interactive katacoda scenario where you set up the application step by step.

2.2. Explore Our devonfw Sample Application

MyThaiStar is a complex sample app, that demonstrates the full capabilities of our framework. On this page we will describe how to download and launch the app on your system, so you can test the various functionalities it offers and explore its code.

You can also check out the interactive katacoda scenario for setting up and trying out the MyThaiStar-Application.

Tip
We assume you have successfully set up the devonfw-ide previously.
  1. In the root directory of a devonfw-ide directory, right click and select "Open Devon CMD shell here" from the Windows Explorer context menu. Then navigate to the main workspace and checkout the MyThaiStar Git repository like this:

    cd workspaces/main
    git clone https://github.com/devonfw/my-thai-star.git
  2. Perform: cd my-thai-star

  3. Execute: devon eclipse ws-up

  4. Execute: devon eclipse create-script

  5. Go to the root folder of the distribution and run eclipse-main.bat

  6. In Eclipse navigate to File > Import > Maven > Existing Maven Projects, then import the cloned project from your workspace by clicking the "Browse" button and selecting /workspaces/my-thai-star/java/mtsj/.

  7. Run the backend by right-clicking SpringBootApp.java and selecting Run as > Java Application in the context menu. The backend will start up and create log entries in the Eclipse Console tab.

    Running the MyThaiStar Backend

  8. Return to your command shell and perform: cd angular

  9. Execute: npm install

  10. Execute: ng serve

  11. Once started, the frontend will be available at localhost:4200/restaurant. Login with the username and password waiter and take a look at the various functionalities provided by MyThaiStar.

You should now take a look at both the front- and backend code and familiarize yourself with its structure and concepts, since most devonfw projects follow this exemplary implementation. Please visit the architecture overview pages of devon4ng and devon4j to learn more about the internal workings of front- and backend.

Last updated 2020-10-22 11:24:08 UTC