zonemaster / zonemaster-gui

The Zonemaster GUI - part of the Zonemaster project
Other
14 stars 22 forks source link

Zonemaster Web GUI CI status

Purpose

This module is the Web Interface part of the Zonemaster project. For an overview of the Zonemaster software, please see the Zonemaster repository.

Prerequisites

Before you install the Zonemaster Web GUI module, you need the Zonemaster Engine test framework installed. Please see the [Zonemaster-Engine installation] document.

You also need a running Zonemaster-Backend component. Please see the Zonemaster-Backend installation document.

Installation

Follow the detailed installation instructions.

Configuration

The configuration instructions for the Backend can be found in the [Backend configuration] document.

The configuration instructions for the GUI can be found in the [GUI configuration] document.

Documentation

There is a public documentation. Some more specific documents can be found in the docs directory.

Contribution

This project was generated with Angular-CLI 1.6.8. It uses the Angular 2+ framework with all its tools.

The source code of the application is available in ./src/app folder.

The components folder is composed of subfolders that represent the main components. Each folder of component contain three files:

All assets are available in the src/assets folder. It is split by concern; the style configurations are in the css, images are in the images folder, etc.

All translation files are in the src/locale folder.

The environment defaults of the application are in the src/environments folder. environment.ts is used for development purposes, the environment.prod.ts for production, and the environment.test.ts for testing.

In order to contribute:

Development server

Run npm start for a dev server. Navigate to http://localhost:4200/en. The app will automatically reload if you change any of the source files.

Build

Run npm run build to build the project. The build artifacts will be stored in the dist/ directory.

Test

See Testing.

License

This is free software under a 2-clause BSD license. The full text of the license can be found in the LICENSE file included in this respository.

Images src/assets/images/person_looking_at_computer.svg and src/assets/images/world_connected.svg are taken from https://undraw.co, full license.