civil-services-geojson-app v1.0.0

Civil Services is a collection of tools that make it possible for citizens to be a part of what is happening in their Local, State & Federal Governments.

GeoJSON Mapbox Electron App

Electron App for Loading GeoJSON files with Mapbox

We built this app because we are creating a few thousand GoeJSON files and discovered that there was no easy way to view them on your local computer. Since GeoJSON files are important to our development process, and likely important to yours, we decided to spend the time to make a native app that you can use to open GeoJSON files on your local machine.

See Full Demo Video

App Features

This initial release was developed as a weekend project by @mrmidi so it certainly has room to grow, but currently this app has the following features:

• Supports .json & .geojson file extensions
• Open GeoJSON Maps via File > Open Menu
• Open GeoJSON Maps via Drag & Drop onto App
• Open GeoJSON Maps via Command Line ( as either raw data or file path )
• Built with Multiple Language Support ( just add a JSON file in ./translations )
• Six different Map Themes: Dark, Light, Outdoors, Satellite, Streets & Hybrid ( Satellite Streets )
• Slide out Drawer to preview GeoJSON Map Properties for Clicked Features
• Automatic Data Conversion of URLs & Images for instant previews
• Automatically reloads the last file you were looking at when you restart the app
• Keeps track of your app preferences ( selected theme, window size & location )

Install App

Installation is done via NPM Installation:

npm install -g civil-services-geojson-app

Launch App

You can launch the app using a Terminal Window via:

Directly by Name:

geojson

Via NPM Script:

cd /path/to/this/project
npm start

Via Node:

cd /path/to/this/project
node ./bin/cli.js

Advanced Launch Options

This can be used by either geojson or node ./bin/cli.js methods:

geojson /path/to/filename.geojson
cat filename.geojson | geojson

Currently there is only one flag you can pass, which is used to set the theme. Here are the current theme options:

geojson /path/to/filename.geojson --theme=dark
geojson /path/to/filename.geojson --theme=light
geojson /path/to/filename.geojson --theme=outdoors
geojson /path/to/filename.geojson --theme=satellite
geojson /path/to/filename.geojson --theme=streets
geojson /path/to/filename.geojson --theme=satellite-streets

Build Native App

If you are feeling a bit adventurous and want to actually build the app on your machine as a Native App, there are a few commands setup to make that easy. All Native Apps are package and built into the ./builds directory. These files are not included in this project as they would not likley work for everyone.

MacOS

npm run build-osx

Windows

npm run build-windows

Linux

npm run build-linux

MacOS App Store

npm run build-osx-app-store