Skip to main content
Version: Previous

Developer training - Environment setup

import Tabs from '@theme/Tabs'; import TabItem from '@theme/TabItem';

Workstation set-up​

Please follow these instructions very carefully to ensure your environment is ready for a productive training. It's not necessary to have admin rights on your workstation to develop with the Genesis low-code platform, but you might have to check with your System Administrator how to install the required third-party software listed here.

import MinimumRequirement from '/snippet/_minimum_requirement.mdx'

Accessing the Genesis repository and configuring the Genesis packages​

Since version 11.3.0 of the foundation-UI, we have set our libraries public. To verify the infos about this package, type npm info @genesislcap/foundation-ui. If everything is ok, you should see a response like this:

@genesislcap/foundation-ui@0.0.26 | UNLICENSED | deps: 23 | versions: 111
Genesis Foundation UI
trouble running npm?

Please make sure:

  • You have the correct versions of the software packages, especially node and npm, as explained in the workstation setup. If you have an older version of npm (run 'npm -v'), make sure you uninstall it first.
  • If you're behind a corporate network, you may need to setup a proxy:
npm config set proxy http://proxy_host:port
npm config set https-proxy https://proxy_host:port

Install GenX CLI; this is a Genesis tool that enables you to seed projects.

npx @genesislcap/genx@latest

import InsecureFlag from '../../_includes/_cli-insecure-flag.md'

Gradle set-up​

Make sure you have a gradle.properties file inside a .gradle folder in your user directory; this file must contain your clear text password:

genesisArtifactoryUser=<your-artifactory-user>
genesisArtifactoryPassword=<your-artifactory-password>
proxy settings

If you are behind a corporate proxy, make sure you add your proxy settings to the gradle.properties file as well. For example:

systemProp.https.proxyHost=proxy_hostname_here
systemProp.https.proxyPort=proxy_port_here
systemProp.https.proxyUser=your_proxy_user_here
systemProp.https.proxyPassword=your_proxy_password_here
#if behind an NTLM authenticated proxy, add the next line:
#systemProp.https.auth.ntlm.domain=your_network_domain_here

If you are unsure on what settings to use, please contact your IT support.

More information here.

Your own database​

To do this training, you need an individual database to create and test the back-end changes we are proposing. Please make sure you have a Database Technology supported by Genesis available and running.

tip

You could use, for instance, PostgreSQL running a local instance or a Docker container.

docker ps --format '{{ .ID }}\t{{.Image}}\t{{ .Names }}'
docker pull postgres
docker run --name localPostgresDb -p 5432:5432 -e POSTGRES_USER=postgres -e POSTGRES_PASSWORD=postgres -d postgres postgres -c 'max_connections=100'

Training requirements set-up​

Start the project baseline​

Clone the Developer Training starting repo from here, and open it using IntelliJ.

Running the back and front end​

We are going to change the back-end and front-end code, so ideally we should have the server running to make our application work. Below you see all supported technologies in the training.

<Tabs defaultValue="plugin" values={[{ label: 'Intellij Plugin', value: 'plugin', }, { label: 'Docker', value: 'docker', }, { label: 'WSL', value: 'wsl', }]}>

You can use the IntelliJ plugin provided by Genesis. So, first step is installing the plugin following the instructions here. Then, have a look at the Tools window installed to understand it and do the configurations asked.

As soon as everything is done and you are ok about the Intellij plugin, double-check if you can see the processes running properly as explained. You must see all processes up and running or in standby mode.

import Docker from '/snippet/_environment_setup_docker.mdx'

import Wls from '/snippet/_environment_setup_wls.mdx'

You are good to go!