Skip to main content
Version: Previous

Quick start - hardware and software

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. 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/genx@xx.xx.x| SEE LICENSE IN license.txt | deps: XX | versions: XXX
Genx CLI
https://github.com/genesislcap/foundation-ui#readme
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 -y @genesislcap/genx@latest init myApp

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​

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'