Skip to content

Latest commit

 

History

History
116 lines (73 loc) · 2.53 KB

DEVELOP.md

File metadata and controls

116 lines (73 loc) · 2.53 KB
Raw

volto-columns-block

Develop

  1. Make sure you have docker and docker compose installed and running on your machine:

    git clone https://github.com/eea/volto-columns-block.git
cd volto-columns-block
git checkout -b bugfix-123456 develop
make
make start

  2. Wait for Volto started at 0.0.0.0:3000 meesage

  3. Go to http://localhost:3000

  4. Happy hacking!

    cd src/addons/volto-columns-block/

Or add @eeacms/volto-columns-block to your Volto project

Before starting make sure your development environment is properly set. See Volto Developer Documentation

  1. Make sure you have installed yo, @plone/generator-volto and mrs-developer

    npm install -g yo @plone/generator-volto mrs-developer

  2. Create new volto app

    yo @plone/volto my-volto-project --addon @eeacms/volto-columns-block --workspace src/addons/volto-columns-block --skip-install
cd my-volto-project

  3. Add the following to mrs.developer.json:

    {
    "volto-columns-block": {
        "url": "https://github.com/eea/volto-columns-block.git",
        "package": "@eeacms/volto-columns-block",
        "branch": "develop",
        "path": "src"
    }
}

  4. Install

    yarn develop
yarn

  5. Start backend

    docker pull plone
docker run -d --name plone -p 8080:8080 -e SITE=Plone -e PROFILES="profile-plone.restapi:blocks" plone

    ...wait for backend to setup and start - Ready to handle requests:

    docker logs -f plone

    ...you can also check http://localhost:8080/Plone

  6. Start frontend

    yarn start

  7. Go to http://localhost:3000

  8. Happy hacking!

    cd src/addons/volto-columns-block/

frontend

    $ yarn start

  1. Go to http://localhost:3000

  2. Happy hacking!

    $ cd src/addons/volto-columns-block/

Cypress

To run cypress locally, first make sure you don't have any Volto/Plone running on ports 8080 and 3000.

You don't have to be in a clean-volto-project, you can be in any Volto Frontend project where you added volto-columns-block to mrs.developer.json

Go to:

cd src/addons/volto-columns-block/

Start:

make
make start

This will build and start with Docker a clean Plone backend and Volto Frontend with volto-columns-block block installed.

Open Cypress Interface:

make cypress-open

Or run it:

make cypress-run