Local Development

Choose tutorial:#

Micronaut
Spring Boot
React

🕓 30 minutes

What you’ll learn#

How to set up your local development environment for:

Java Micronaut component development.
Run the developed component in the local development mode on your machine.

Prerequisites#

Create a new CodeNOW component in your application.
- Use the Java Micronaut scaffolder.
- See the How to Create a New Application Component tutorial.

Prepare local development IDE#

Clone code from the created git repository to your local machine.
Use your favourite IDE and import repository as a maven project. You will require:
- Java 11+
- Enable Maven support in your IDE and install Apache maven (if required) – http://maven.apache.org/ide.html
- Enable Micronaut support – https://docs.micronaut.io/latest/guide/#quickStart
  - Make sure you enabled “Enable annotation processing” checkbox in your IDE’s maven configuration.

To run the project in the local development setup, check README.md . The required minimum is to set the path to Micronaut configuration file as a JVM startup parameter:
- -Dmicronaut.config.files=file:config/application.yaml
  - Check the Run configuration dialog in your IDE and set this line as a VM argument in the JVM options.
- NOTE: You can also configure this server to listen on a custom port (the default port is 8080).
- -Dserver.port=9090
- This comes in handy when running multiple projects at once, which is very common with micro-service oriented architecture.

Start Run/Debug in your IDE.
- The component should successfully start up with port 8080 exposed
- Check the swagger-ui by clicking on http://localhost:8080/swagger/index.html
  - For more information about the Swagger UI check: https://swagger.io/tools/swagger-ui/
  - Swagger UI is used as a simple swagger presentation UI.
  - Any changes must apply to the swagger.yaml in the src/main/resources/META-INF/swagger directory
  - The same swagger UI is used as a documentation tool and is also an easy way to test the functionality of your component’s API.

Docker compose and third-party tools#

Some manuals for CodeNOW work with different third-party components like Apache Kafka or Redis. The easiest way for local development is to download the publicly available docker compose receipts. Some examples used during the writing of this manual:

More about docker compose: https://docs.docker.com/compose/install/
Kafka with Kafdrop: https://github.com/StratoxEnterprises/oxus-docker-kafka-dev.git
Redis with Redis Commander: https://github.com/ikknd/docker-study.git
PostgreSQL with PgAdmin: https://github.com/khezen/compose-postgres.git

What`s next?#

See our other developer tutorials:

🕓 30 minutes

What you’ll learn#

How to set up your local development environment for:

Java Spring Boot component development.
Run the developed component in the local development mode on your machine.

Prerequisites#

Create a new CodeNOW component in your application.
- Use the Java Spring Boot scaffolder.
- See the How to Create a New Application Component tutorial.

Prepare local development IDE#

Clone code from the created git repository to your local machine.
Use your favourite IDE and import repository as a maven project. You will require:
- Java 11+
- Enable Maven support in your IDE and install Apache maven (if required) – http://maven.apache.org/ide.html

To run the project in the local development setup, check README.md . The required minimum is to set the path to Micronaut configuration file as a JVM startup parameter:
- -Dspring.config.location=file:./config/application.yaml
  - Check the Run configuration dialog in your IDE and set this line as a VM argument in the JVM options.
- NOTE: You can also configure this server to listen on a custom port (the default port is 8080).
  - -Dserver.port=9090
  - This comes in handy when running multiple projects at once, which is very common with micro-service oriented architecture.

Start Run/Debug in your IDE.
- The component should successfully start up with port 8080 exposed
- Check swagger-ui by clicking on http://localhost:8080/swagger/index.html
  - For more information about Swagger UI check: https://swagger.io/tools/swagger-ui/
  - Swagger UI is used as a simple swagger presentation UI.
  - Any changes made in the code are automatically propagated to swagger-ui (courtesy of SpringFox).
  - The same swagger UI is used as the documentation tool and is also an easy way to test the functionality of your component’s API.

Docker compose and third-party tools#

More about docker compose: https://docs.docker.com/compose/install/
Kafka with Kafdrop: https://github.com/StratoxEnterprises/oxus-docker-kafka-dev.git
Redis with Redis Commander: https://github.com/ikknd/docker-study.git
PostgreSQL with PgAdmin: https://github.com/khezen/compose-postgres.git

What`s next?#

See our other developer tutorials:

🕓 15 minutes

What you’ll learn#

How to set up your local development environment for:

Javascript React
Run the developed component in the local development mode on your machine.

Prerequisites#

Create a new CodeNOW component in your application.
- Use the Javascript React scaffolder.
- See the How to Create a New Application Component tutorial.

Prepare local development IDE#

Clone code from the created git repository to your local machine.
Use your favourite IDE. You must have:
- an installed npm package manager https://www.npmjs.com/
To run the project in local development setup, check README.md
- For installation of the required npm modules, go to project root and run the command below
  - npm install
- To start the project in development mode, run the command
  - npm start
- The application starts in development mode on the local machine, running on default port 3000
You can start your browser now and go to http://localhost:3000

What’s next?#

Now you are ready to start with some development. See the other developer manuals.

Javascript React UI with REST HTTP call