0.7.0-1520717388 • Published 9 months ago

@geogirafe/lib-geoportal v0.7.0-1520717388

Weekly downloads
-
License
Apache-2.0
Repository
gitlab
Last release
9 months ago

Pipeline Status Docker Pulls

GitLab Contributors GitLab Issues GitLab Merge Requests GitLab last commit

GitLab License

GeoGirafe

GeoGirafe is a flexible application to build online geoportals. This repository contains the web-viewer part of the project.

Please note that GeoGirafe is at its very beginning, can strongly evolve and is therefore not intended for the moment to be used by people other than developers or contributors.

The project documentation can be found here: https://doc.geomapfish.dev.
The demo instances of GeoGirafe can be tested here: https://demo.geomapfish.dev.

Goal

The goal of GeoGirafe is to allow the easy implementation of a stable, efficient and secure geoportal. GeoGirafe is also meant to be easily extensible, by allowing users to integrate their own plugins.

As the main users of GeoGirafe do not necessarily have advanced skills in computer development, we wanted to have a learning curve as smooth as possible. This is why the project does not use the latest frameworks and favours readable code over code corresponding to certain arbitrary "quality" criteria. GeoGirafe is therefore based on web standards (Vanilla Web Components) and limits the number of dependencies to other libraries.

Development philosophy

GeoGirafe is developed according to the following principles:

  • KISS: GeoGirafe is simple. It is developed with pure Vanilla-JavaScript. No complex framework like React or Angular is used. If you know JavaScript, you can understand how it works.

  • DevSecOps: GeoGirafe is baking security in at every phase of the software lifecycle, in order to deliver a secure-by-design application. Quality, readability, reliability and security are checked by the SonarCloud platform during our continuous integration processes: View SonarCloud Reports

  • Reactivity: GeoGirafe is meant to be responsive, resilient, elastic and message driven according to the Reactive Manifesto.

  • Agility: GeoGirafe is being developed according to the Agile methodology. We value individuals collaboration, and change responsiveness more than processes, tools and plans.

  • Accessibility: GeoGirafe is doing its best to make web content more accessible to individuals with disabilities: View Wave Report.

Architecture

Architectural choices made for the GeoGirafe project, including strategic objectives and technological choices, is explained in details here: https://doc.geomapfish.dev/docs/architecture.

Getting Started

If you want to get started with GeoGirafe, the simplest way is to use the Docker Container : https://hub.docker.com/r/geogirafe/viewer. This will allow you to get a running instance of GeoGirafe with minimum effort. Please follow the small documentation in the Docker Hub Readme.

Work with GeoGirafe

Development

First, install Node 20.

Then, clone the Repository:

git clone https://gitlab.com/geogirafe/gg-viewer.git

Now you can build the application, and start the development server:

npm install
npm start

Working locally

❗❗ IMPORTANT ❗❗
When working locally with authentication, and more generally with cookies, browsers treat single-label domains (domains without any dots) differently from multi-label domains (domains with at least one dot). Cookies set on single-label domains are often considered less secure because they can be more easily spoofed or misused. As a result, many browsers restrict or do not allow cookies to be set on single-label domains like localhost.

Therefore, working against https://localhost will not work, because the cookies cannot be correctly set.
You'll have to use https://app.localhost, which has been defined as the default domain when working locally with GeoGirafe.

Further discussions about this:

Debugging using VSCode

If you are using VSCode, there is a preconfigured debugging configuration in the .vscode directory.
After you've started the application in development mode, just press F5, and VSCode will attach to the running process. You will then be able to debug your code.

Configuration

The complete configuration of the application is done in the file config.json. This configuration will be loaded dynamically when the application starts. Therefore it is not necessary to rebuild the project when you modify this file.

The file config.json does not exists by default. The simplest way to create one is to pick up an existing one in the demo directory, and to adapt the content to your needs.

You can also preconfigure GeoGirafe for an existing demo configuration by using:

On Linux

npm run configure-demo <environment>

On Windows

npm run configure-demo-win <environment>

This will automatically copy the config.json file in the right place, and download the needed Mock objects.

Please note that today, the GeoGirafe Viewer is using a backend based on GeoMapFish. The services you will have to use in your configuration must therefore be compliant with GeoMapFish.

Build for Production

npm install
npm run build

This will output a complete built GeoGirafe app which can be served by a Webserver easily in the dist/app folder.

You can try the built asset with (you need docker for this example!):

docker run --rm -p 8088:80 -v $(pwd)/dist/app:/usr/share/nginx/html nginx:latest

This will spin up an NGINX and you can access it on app.localhost:8088.

Press CTRL+C to stop the container.

Build the NPM Package

Make sure to have run the command npm login before at least once

Build the library

npm install
npm run build-lib

This will output (beside others) a transpiled version of GeoGirafe's library part into dist/lib.

Publish Lib Package to npmjs.com

npm run publish-lib --access public

Build the Android Application

Make sure you have build the application for production before with npm run build.
The file config.json present in the dist\app directory will be used.

npm run build-apk

This will output an APK package of GeoGirafe into dist/apk.

Deployment

The deployment can be done in 2 ways:

Using an existing WebServer

After the build, everything that needs to be deployed is in the public directory. Copy the public directory content to any webserver, for example in the htdocs directory.

Using Docker

When the project has been built, you can build a docker image that will contains the application:

docker build -t <your_name>/viewer -f buildtools/Dockerfile dist

Then, you can start it:

docker run -p 8080:80 -p 8443:443 <your_name>/viewer

Contributing

Merge-Requests are welcome. For major changes, please open an issue first to discuss what you would like to change.
Contribution guidelines are available here: CONTRIBUTING.md.
Please read them before contributing.

License

Apache License, Version 2.0

0.7.0-1520717388

9 months ago

0.7.0-1518627463

9 months ago

0.7.0-1516093820

9 months ago

0.7.0-1516100268

9 months ago

0.7.0-1520368796

9 months ago

0.7.0-1519676774

9 months ago

0.7.0-1510690614

9 months ago

0.7.0-1508349667

9 months ago

0.7.0-1508318134

9 months ago

0.7.0-1507399767

9 months ago

0.7.0-1498684022

9 months ago

0.7.0-1496417817

9 months ago

0.7.0-1471396819

10 months ago

0.7.0-1491661828

9 months ago

0.7.0-1470528092

10 months ago

0.7.0-1486430779

9 months ago

0.7.0-1478854576

10 months ago

0.7.0-1493065221

9 months ago

0.7.0-1470435832

10 months ago

0.7.0-1470633274

10 months ago

0.7.0-1484664470

9 months ago

0.7.0-1469382933

10 months ago

0.7.0-1472489585

10 months ago

0.7.0-1475586073

10 months ago

0.7.0-1470152814

10 months ago

0.7.0-1470946315

10 months ago

0.7.0-1475543600

10 months ago

0.7.0-1484074452

9 months ago

0.7.0-1492178782

9 months ago

0.7.0-1488083279

9 months ago

0.7.0-1470577968

10 months ago

0.7.0-1468373093

10 months ago

0.7.0-1467108134

10 months ago

0.7.0-1466333660

10 months ago

0.7.0-1465736587

10 months ago

0.7.0-1465704009

10 months ago

0.6.0-1456802652

10 months ago

0.6.0-1456373881

10 months ago

0.6.0-1450728614

10 months ago

0.6.0-1445265375

10 months ago

0.6.0-1445290476

10 months ago

0.6.0-1442687757

10 months ago

0.6.0-1443239051

10 months ago

0.6.0-1442728540

10 months ago

0.6.0-1441982295

10 months ago

0.6.0-1442673131

10 months ago

0.6.0-1433998114

11 months ago

0.6.0-1433157121

11 months ago

0.6.0-1430022356

11 months ago

0.6.0-1428599141

11 months ago

0.6.0-1428917543

11 months ago

0.6.0-1414225712

11 months ago

0.6.0-1414395421

11 months ago

0.6.0-1405713724

11 months ago

0.6.0-1394837954

12 months ago

0.6.0-1394986144

12 months ago

0.6.0-1407254493

11 months ago

0.6.0-1409696638

11 months ago

0.6.0-1384472870

12 months ago

0.6.0-1384516890

12 months ago

0.6.0-1378559874

12 months ago

0.6.0-1388932291

12 months ago

0.6.0-1384646592

12 months ago

0.6.0-1395595122

12 months ago

0.6.0-1378997802

12 months ago

0.6.0-1384590870

12 months ago

0.6.0-1387826811

12 months ago

0.6.0-1415575084

11 months ago

0.6.0-1375532465

12 months ago

0.6.0-1387565110

12 months ago

0.6.0-1377080004

12 months ago

0.6.0-1376902362

12 months ago

0.6.0-1419907316

11 months ago

0.6.0-1412734616

11 months ago

0.6.0

1 year ago

0.4.0

1 year ago