Go to file
Gustavo Fuhr 0f4a8ee087 Merged in ray-develop (pull request #51)
Ray develop

* reset zoom and toolbar fixes

* lang fixes

* dialog enhancements

* comments

* tooltip for zoom and fit commented

* merge develop into ray develop

* rules for ignoring some linebreaks in eslint

* comments in .eslintrc

* brackets around ifs

* playground fixes, comments removed, semi-colon at bottom of editor removed, root container size now defined with css


Approved-by: Paulo Veiga
2022-07-09 01:34:52 +00:00
dist Add distribution base url. 2022-01-12 16:20:05 -08:00
libraries Moved the libraries/boostrap folder back due to a bug in removal and fixed the ColoPalettePanel.js and Group.js 2022-01-26 12:38:08 -03:00
packages Merged in ray-develop (pull request #51) 2022-07-09 01:34:52 +00:00
.dockerignore Merged in feature/tests-and-docs (pull request #9) 2021-12-17 02:13:54 +00:00
.gitignore Merged in ray-develop (pull request #51) 2022-07-09 01:34:52 +00:00
.nvmrc Increase coverage migrating tests. 2021-12-14 15:08:54 +00:00
.prettierignore adding basic config for prettier 2021-02-22 22:17:44 -08:00
.prettierrc.json Merged in ray-develop (pull request #51) 2022-07-09 01:34:52 +00:00
CONTRIBUTING.md Merged in feature/tests-and-docs (pull request #9) 2021-12-17 02:13:54 +00:00
README.md Chores 2022-04-06 21:04:27 -03:00
bitbucket-pipelines.yml Fix events tests. 2022-04-12 08:49:03 -03:00
docker-compose.snapshots.update.yml Merged in ray-develop (pull request #51) 2022-07-09 01:34:52 +00:00
docker-compose.snapshots.yml Merged in ray-develop (pull request #51) 2022-07-09 01:34:52 +00:00
lerna.json Merged in ray-develop (pull request #51) 2022-07-09 01:34:52 +00:00
package.json Merged in ray-develop (pull request #51) 2022-07-09 01:34:52 +00:00
webpack.common.js Merged in web2d-coreJS-solutions (pull request #5) 2021-12-02 00:41:56 +00:00
yarn.lock Update Google Analytics to GA4 2022-05-29 10:22:57 -07:00

README.md

WiseMapping Frond End

WiseMapping Frond End is part of the MindMap Open Source Project. The first release of WiseMapping was in 2010 and there was not mayor update on the architecture. In 2021, a major change started with the goal to provide a visual and technology refresh of the project.

WiseMapping Front extracts all the UI related aspects in this repository. You will find three major modules:

  • Web2D: Lighway abstraction over SVG for chart renderding.
  • Mindplot: Pure vanilla ES6 classes responsible for providing mindmap rendering and edition capabilities.
  • Webapp: REACT application that encompass the whole midnmap edition experience.

Getting started

Make sure you have NodeJs installed (version compatible with package.json engine), and yarn installed (npm i -g yarn).

nvm use
yarn install
yarn bootstrap

Please refer to each package's Readme.md for anything specific to the package.

If you want to contribute, please check out CONTRIBUTING.md.

Useful scripts

Each package might provide the following scripts.
You can run these for all packages by running it from the root folder. Alternatively you can run it for a specific package by passing the --scope option.

build

Production builds

yarn build

lint

run eslint

yarn lint

playground

start a devServer with some browsable examples

yarn playground --scope @wisemapping/web2d yarn playground --scope @wisemapping/mindplot

test

run all the tests

yarn test

run only integration tests

yarn test:integration

run only unit tests

yarn test:unit

Image Snapshot Testing

We use cypress-image-snapshot for snapshot testing. This is a relatively cheap way of identifying behavior changes based on page screenshots. See visual testing docs for more information.

When a test that contains a matchImageSnapshot call is run, it compares the snapshot to the corresponding one in the snapshots directory. If Any change is detected, the test will fail, and the diff can be found in the cypress/snapshots/*/__diff_output__ folder. If the change is intentional, we should "accept" those changes by updating the snapshot and include it in the commit.

There is a caveat where colors, fonts or ui may differ depending on the host machine running the tests.

A workaround for this is to run the tests using docker. Make sure you have docker and docker-compose installed.

Run snapshot tests: docker-compose -f docker-compose.snapshots.yml up
If anything changed, and the change was intentional, update the snapshots and then commit the new images to source control.
Update snapshots: docker-compose -f docker-compose.snapshots.update.yml up