/usergrid

Mirror of Apache Usergrid

Primary LanguageJavaOtherNOASSERTION

Apache Usergrid

NOTICE: This master branch represents active and ongoing development of the Usergrid team. This branch represents Usergrid 2.x which requires some new components. In addition to a Cassandra cluster, Usergrid 2.x also requires an ElasticSearch cluster and a distributed Queue system (currently only AWS SQS is supported).

Prerequisites

  • Java 8 - Java7 will not work
  • ElasticSearch 1.4+
  • Cassandra 2.0+

Overview

Apache Usergrid is a multi-tenant Backend-as-a-Service stack for web & mobile applications, based on RESTful APIs.

Contributing

We accept all contributions via our GitHub, so you can fork our repo (apache/usergrid) and then submit a PR back to us for approval. For larger PRs you'll need to have an ICLA form on file with Apache. For more information see our Contribution Workflow Policy, and specifically our External Contributors Guide.

Build awesome apps with Usergrid!

Apache Usergrid provides all code necessary to build and power modern mobile applications. This includes the server stack, administrative portal website, SDKs in most popular languages, as well as command line tools.

Look for much more detailed README files in their corresponding subdirectories, or check out our website for more info.

  • The server-side stack, a Java 7 + Cassandra codebase that powers all of the features, is located under /stack. You can install dependencies and compile it with maven. See stack/README.md for instructions.

  • The admin portal is a pure HTML5+JavaScript app allowing you to register developers and let them manage their apps in a multi-tenant cluster. Located under /portal

  • SDKs for iOS, Android, HTML5/JavaScript, node.js, Ruby on Rails, pure Ruby, PHP, (server-side) Java, .Net / Windows, and Perl, located in their respective subdirectories under /sdks.

  • a command-line client “ugc” allowing you to complete most maintenance tasks, as well as queries in a manner similar to the mysql or the mongo shell, located under /ugc. You can install it on your machine with a simple sudo gem install ugc

For more information

See the Apache Usergrid web site.