Generic platform for large scale collaborative planning
Latest commit 4fbc021 Nov 27, 2018


Travis build status Codacy grade StackShare

The xCoLab is a generic version of the Climate CoLab, a platform to crowdsource solutions to climate change. The xCoLab is intended to be domain independent and appropriate for solving a wide range of complex social problems.

Getting Started


  • Java 8
  • MySQL 5.6 or higher

Quick Start

You can set up a copy of the xCoLab like this:

# Create database
mysql -u root -p -e 'CREATE DATABASE xcolab CHARACTER SET utf8mb4 COLLATE utf8mb4_unicode_ci;'

# Create the file conf/ with your database credentials
# (use conf/ file as a guide)

# Check prerequesites and set up configuration file

# Compile the sources, defining database schema
./mvnw compile

# Populate database
cat sql/starter/xcolab-data.sql | mysql -u root -p xcolab

# Run the xCoLab:

The components may take a few minutes to start (you can use the script in scripts/run to tail the log). After that, the xCoLab will be available at http://localhost:18082.

Development setup

For a more comprehensive development setup guide, please check out our setup wiki page.


The xCoLab is built with Spring Boot. You can read more about our architecture here.


If you notice any issues with the xCoLab, please open an issue in this repository. If you're interested in contributing to this project, check out


We use browserstack for cross-browser testing to ensure the xCoLab looks good across all supported browsers and devices: Browserstack