/kartevonmorgen

Mapping for Good

Primary LanguageNixGNU Affero General Public License v3.0AGPL-3.0

Karte von morgen

Screenshot

Mapping for Good

von morgen supports kindness, sustainability and joint action. Everything that brings a little happiness to our world. We believe that living in a de‐stressed, environmental‐friendly and trust‐worthy society, is already in progress. We want to support people in finding ways to embrace those values.

The Map von morgen is a website and app, that allows users to share their favorite places in the world. Places that are forward‐thinking and inspiring. The goal is to collect projects, companies and events that make a world of tomorrow, already experienceable today.

Demo: https://kartevonmorgen.org/

Development

Build Status Dependency Status Dependency Status License

Are you're interested in contributing to KVM? The following is a description of a quickstart. If you're looking for a more comprehensive introduction, have a look at CONTRIBUTING.md.

Dependencies

To be able to start development you'll need the following tools:

Now clone this repository:

git clone https://github.com/flosse/kartevonmorgen

Go to the root of it and install all the dependencies:

cd kartevonmorgen/
npm install

Build

To build the web application run:

npm run pack

The result can be found in dist/. To build a Nix derivation, run

nix-build -E '(import <nixpkgs>{}).callPackage ./kartevonmorgen.nix {}'

Note: Sometimes the build fails because of a bad binary cache, so just disable it:

nix-build -E '(import <nixpkgs>{}).callPackage ./kartevonmorgen.nix {}' --option use-binary-caches false

Local development setup

Download the OpenFairDB Server

wget https://download.ofdb.io/openfairdb-x86_64-linux-v0.3.1.tar.gz

unpack it

tar xzf openfairdb-x86_64-linux-v0.3.1.tar.gz

and run it

./openfairdb

Now openfairdb is listening on port 6767.

cd /path/to/kartevonmorgen/
npm start

The web app is now listening on port 8080. Open it in your browser http://localhost:8080.

On every file change in src/, the app will be build for you and the browser reloads automatically.

Tests

All the tests can be found in the spec/ folder. To run the tests type

npm t

Nix

If you're using Nix or NixOS you can get your complete development environment by just typing

nix-shell dev-env.nix

Updating the node-packages.nix works as follows:

cd path/to/your/kartevonmorgen/
git clone https://github.com/NixOS/npm2nix
nix-shell -p nodejs
node npm2nix/lib/npm2nix.js package.json node-packages.nix

...and don't forget to update 'kartevonmorgen.nix' ;-)

Backend

KVM uses the OpenFairDB as its backend.

License

Copyright (c) 2015 - 2018 Markus Kohlhase mail@markus-kohlhase.de

This project is licensed under the AGPLv3 license.