Suggested AppBuilder and CMS setup for local development

g.desantis · May 8, 2020, 7:50am

Hello,
as a frontend developer, how I should setup Entando to be fully productive with AppBuilder and CMS for local development?

l.cherubin · May 8, 2020, 10:34am

Hi @g.desantis,

In order to enable the Entando CMS plugin in the backend, you simply need to add the dependency in your project pom.xml.

The dependency to add is

        <dependency>
            <groupId>org.entando.entando.bundles.app-view</groupId>
            <artifactId>entando-app-view-cms-default</artifactId>
            <version>${entando.version}</version>
            <type>war</type>
        </dependency>

And the entando.version property is the version of entando cms you want to use, right now 6.1.1

For more details and a concrete example, you can check-out the entando-de-app project available on GitHub at https://github.com/entando-k8s/entando-de-app

g.desantis · May 8, 2020, 10:44am

From the frontend side, to install both app-builder and entando-cms from scratch you should:

git clone https://github.com/entando/entando-cms.git
cd entando-cms
npm i -g npm-install-peers
npm i && npm-install-peers

create an .env.local file, containing for example

REACT_APP_DOMAIN=http://localhost:8080/entando-de-app

git clone https://github.com/entando/app-builder.git
cd app-builder

create an .env.local file, containing for example

DOMAIN=http://localhost:8080/entando-de-app

then

npm i
npm run app-install cms
npm start

You can find more info at

github.com

entando/entando-cms/blob/master/README.md

# Entando CMS

This project contains the `App Builder` screens for the CMS app of Entando.

---

# Developer Prerequesites

It is recommended to install `npm-install-peers` (`npm i -g npm-install-peers`) to install peer dependencies. So when you install npm dependencies, you can only install at one command: `npm i && npm-install-peers` - this will download all your dependencies specified in `package.json` including the `peerDependencies`. This is to enable standalone mode during development phases. Take note that whenever you install a new npm module, this will erase all the peer dependencies, so you have to re-run `npm-install-peers` after installing.

# Configuration example

Put following config into `.env.local` file to configure your app for local development:
```
NODE_PATH=src/
REACT_APP_DOMAIN=http://tests.serv.run/entando-sample
REACT_APP_USE_MOCKS=false
REACT_APP_CLIENT_ID=appbuilder
REACT_APP_CLIENT_SECRET=appbuilder_secret
```

This file has been truncated. show original

github.com

entando/app-builder/blob/master/README.md



This project was bootstrapped with [Create React App](https://create-react-app.dev/).

---
## Configuration

The application uses `.env` files to set up some environment variables.

Dev instances should be using the `.env.development.local` file while production instances use `.env.production`

### Configurable properties

#### `USE_MOCKS` (boolean, default: `true`)
a boolean used to determine whether the API calls will be against a real Entando Core or if they are just being mocked internally.

#### `DOMAIN` (string, default: `null`)
a string representing the domain name of the Entando Core instance. The protocol is optional and it is possible to specify a subdirectory of the domain.
Trailing slashes are valid (but will automatically be removed) and it only validates up to 3rd level domains.

This file has been truncated. show original

github.com

entando/app-builder/blob/master/Apps.md

Apps for the app builder are developed as standalone applications which should be able to run with `npm start` in standalone mode.

Each App will be deployed in npm using the `@entando` namespace and will export in their dist folder several items used by the app builder when integrating it

# Babel and App configuration
The `package` json must contain the correct Babel and App configuration:

```js
  "files": [
    "dist",
    "!src",
    "!public",
    "!node_modules"
  ],
  "main": "dist/babel.js",
  "publishConfig": {
    "access": "public"
  },
```

This file has been truncated. show original

ffleandro · May 12, 2020, 5:54pm

What if I want to run app-builder from docker instead of the default development server from npm start?