💡 We are hiring full-time OSS comitters! https://eukarya.io/join

Features

Visualizer is a powerful tool for visualizing GIS data, offering a range of features to enhance your mapping experience:

Comprehensive WebGIS Support: Visualizer supports various common WebGIS data types, displaying them seamlessly on a digital map using Cesium as the rendering engine.
Interactive Geometry Drawing: Draw geometric shapes directly on the map for custom annotations and spatial analysis.
Conditional Layer Styling: Modify display styles for individual layers based on conditions, allowing for personalized data visualization.
Engaging Storytelling Feature: Create interactive, page-by-page narratives with your GIS data using the built-in storytelling feature.
Customizable Interface with Plugins: Use the plugin system to create custom solutions and tailor the interface of public projects to suit your needs.
Easy Project Publishing and Sharing: Publish your projects and share them effortlessly through distribution, embedding, or custom URLs.
Community Plugin Marketplace: Add your custom plugins to the marketplace and allow other users to integrate them into their projects.

Built with

React, TypeScript, Go, GraphQL, MongoDB, WebAssembly (plugin execution), OpenID Connect

Getting Started

Setup Server and Database

Before you begin, please ensure that Docker is properly installed and running on your machine.

🖥️ macOS / Linux

Navigate to the server directory and start the backend server.
This command will automatically start the database and mock GCS storage:
```
cd server
make run
```
Initialize the development environment.
This creates a mock user and sets up the mock GCS bucket.
This step is only required for the first-time setup:
```
make init
```

Windows (PowerShell)

Open PowerShell and navigate to the server directory:
```
cd server
```
Set an alias to use dv as a shortcut for make:
```
Set-Alias dv .\dev.bat
```
Start the backend server.
This will automatically start the database and mock GCS storage:
```
dv run
```
Initialize the development environment.
This creates a mock user and sets up the mock GCS bucket.
This step is only required for the first-time setup:
```
dv init
```

Setup Web

🖥️ macOS / Linux

Navigate to the web directory of your visualizer project and create a local .env file:
```
cd web
touch .env
```

Add the following environment variables to your .env file:

# .env
REEARTH_WEB_API=http://localhost:8080/api
REEARTH_WEB_PLUGINS=http://localhost:8080/plugins
REEARTH_WEB_CESIUM_ION_ACCESS_TOKEN=your_cesium_ion_access_token_here
REEARTH_WEB_AUTH_PROVIDER=mock

To obtain a Cesium Ion Access Token, please follow
this official guide.

Install dependencies and start the frontend server:
```
yarn && yarn start
```

Windows (PowerShell)

Open PowerShell and navigate to the web directory:
```
cd web
```
Create a new .env file:
```
New-Item .env -ItemType File
```

Add the following environment variables:

Add-Content .env "REEARTH_WEB_API=http://localhost:8080/api"
Add-Content .env "REEARTH_WEB_PLUGINS=http://localhost:8080/plugins"
Add-Content .env "REEARTH_WEB_CESIUM_ION_ACCESS_TOKEN=your_cesium_ion_access_token_here"
Add-Content .env "REEARTH_WEB_AUTH_PROVIDER=mock"