Cesium

Unhosted webapp client for Duniter network.

Try it at: http://cesium.duniter.fr

Installation

On desktop computer

To use Cesium from your desktop computer :

• Download the latest release. Choose the web packaging (cesium-vX.Y.Z-we.zip);
• Unpack in a empty directory;
• Open the index.html file in a web browser.

On web server

Cesium can be easily installed on most web server.

Minimal install from source

if you don't allready use nodejs, see Prerequisite

git clone https://github.com/duniter/cesium.git
cd cesium
npm install
npm start

Answer asked questions.

Your cesium instance is now reacheable on : http://localhost:8100/ or an other ip if your listen on an other interface.

Installation script

For Linux distribution, a installation script could be used to:

• Download the latest release
• Unpack archive into the directory ./cesium. Existing files will be override.

curl -kL https://raw.githubusercontent.com/duniter/cesium/master/install.sh | bash

or:

wget -qO- https://raw.githubusercontent.com/duniter/cesium/master/install.sh | bash

Note: You may need root permission to write files. If so just replace | bash with | sudo bash.

Yunohost package

There is a package for YunoHost self-hosting distribution.

Configuration

To change default configuration:

• Edit the file config.js, and set default properties:

angular.module("cesium.config", [])
.constant("csConfig", {
	"timeout": 4000,
	"cacheTimeMs": 60000,
	"useRelative": true,
	"timeWarningExpireMembership": 5184000,
	"timeWarningExpire": 7776000,
	"useLocalStorage": false,
	"rememberMe": false,
	"showUDHistory": false,
	"node": {
		"host": "test-net.duniter.fr",
		"port": "9201"
	},
	"plugins": {
		"es": {
			"enable": "false",
			"host": "test-net.duniter.fr",
			"port": "9203"
		}
	},
	"version": "0.2.6",
	"build": "2016-08-25T07:16:49.361Z",
	"newIssueUrl": "https://github.com/duniter/cesium/issues/new?labels=bug"
});

• Configure a Duniter node:

  • set node.host and node.port to the default node address.

• Configure the optional extension for ElasticSearch Duniter4j node

  • set plugins.es.host and plugins.es.port to the default ES node address.

  • set plugins.es.enable with [true|false] to change the default extension state.

  • To remove the extension (and not only disable by default): remove all content inside the plugins tag. Users will NOT be able to enable the extension.

License

This software is distributed under GNU GPLv3.

Development Guide

Prerequisite

To build Cesium, you will have to:

• Installing nvm

  wget -qO- https://raw.githubusercontent.com/creationix/nvm/v0.31.0/install.sh | bash

• Configure NodeJS to use a version 5:

  nvm install 5 

• Installing nodejs build tools:

   npm install -g bower gulp [email protected] cordova

• Installing other build dependencies:

 sudo apt-get install build-essential

Source code

• Getting source and installing project dependencies:

  git clone https://github.com/duniter/cesium.git
  cd cesium
  npm install
  bower install

• Installing Cordova plugins

  ionic state restore

Build environment

• To configure your build environment :

  • Add your environment config into app/config.json

  • Update default configuration, using the command:

  gulp config --env <your_env_name> 

This will update the configuration file used by cesium, at www/js/config.json.

Compile and launch

• Compiling and running Cesium:

  ionic serve

Best pratices

Cesium could be run on phone devices. Please read performance tips on AgularJS + Ionic before starting to contribute. Read also Angular performance for large applicatoins.