https://github.com/eea/bise-frontend

Plone front-end server for Biodiversity Information System for Europe (BISE).
https://github.com/eea/bise-frontend

Last synced: about 2 months ago
JSON representation

Plone front-end server for Biodiversity Information System for Europe (BISE).

• Host: GitHub
• URL: https://github.com/eea/bise-frontend
• Owner: eea
• Created: 2019-12-06T10:40:55.000Z (about 5 years ago)
• Default Branch: master
• Last Pushed: 2024-11-12T10:11:11.000Z (2 months ago)
• Last Synced: 2024-11-12T10:32:24.790Z (2 months ago)
• Language: JavaScript
• Homepage: https://biodiversity.europa.eu
• Size: 411 MB
• Stars: 4
• Watchers: 36
• Forks: 0
• Open Issues: 1
• Metadata Files:
  • Readme: README.md
  • Changelog: CHANGELOG.md

Awesome Lists containing this project

• awesome-volto - Biodiversity Information System for Europe - Volto project for [Biodiversity Information System for Europe website](https://biodiversity.europa.eu) (Websites built with Volto / Open-source websites built with Volto)

README

        
## Documentation

[Volto Hands-On](https://training.plone.org/voltohandson/index.html) is a training on how to create your own website.

## Quick Start

Below is a list of commands you will probably find useful.

### `make install`

Installs and checkouts the `mrs-developer` directives (`make develop`), creates a shortcut to the Volto source code (`omelette` folder), then triggers the install of the frontend environment.

### `yarn start`

Runs the project in development mode.

You can view your application at `http://localhost:3000`

The page will reload if you make edits.

### `yarn build`

Builds the app for production to the build folder.

The build is minified and the filenames include the hashes.

Your app is ready to be deployed!

### `yarn start:prod`

Runs the compiled app in production.

You can again view your application at `http://localhost:3000`

### `yarn test`

Runs the test watcher (Jest) in an interactive mode.

By default, runs tests related to files changed since the last commit.

### `yarn i18n`

Runs the test i18n runner which extracts all the translation strings and

generates the needed files.

### mrs-developer

[mrs-developer](https://github.com/collective/mrs-developer) is a great tool

for developing multiple packages at the same time.

mrs-developer should work with this project by running the configured shortcut script:

```bash

make develop

```

Volto's latest razzle config will pay attention to your tsconfig.json (or jsconfig.json) file for any customizations.

In case you don't want (or can't) install mrs-developer globally, you can install it in this project by running:

```bash

yarn add -W mrs-developer

```

## Acceptance tests

In order to run localy (while developing) the project acceptance tests (Cypress), there are some `Makefile` commands in place (in the repo root). Run them in order:

`start-test-acceptance-server`: Start server fixture in docker (previous build required)

`start-test-acceptance-frontend`: Start the Core Acceptance Frontend Fixture in dev mode

`test-acceptance`: Start Core Cypress Acceptance Tests in dev mode

`full-test-acceptance`: Start the whole suite (backend + frontend + headless tests) Cypress Acceptance Tests in headless (CI) mode