OpenCollective API

How to get started

Note: If you see a step below that could be improved (or is outdated), please update instructions. We rarely go through this process ourselves, so your fresh pair of eyes and your recent experience with it, makes you the best candidate to improve them for other users.

Download the source code

Although this repository only contains the code for the API and the code for the UI is in a separate repository, these instructions will get both running on developer mode. That's why you need to download both codebases under the same directory. Here's an example of how it can be done if you have a git client setup and ready to work:

$ mkdir -p ~/src/github.com/opencollective
$ cd ~/src/github.com/opencollective
$ git clone https://github.com/opencollective/opencollective-api
$ git clone https://github.com/opencollective/frontend

Run the application

Vagrant setup

If you by any chance is a Vagrant user, just run the usual vagrant up within the opencollective-api directory and go to http://localhost:23000/ in your browser.

Docker setup

If you prefer using docker-compose make sure it's installed and working and then execute the following command:

$ docker-compose -f docker/docker-compose.yml up --build

Then you'll be able to access the UI from http://localhost:13000 and the API from the address http://localhost:13060.

Once it's running

This new environment is created with the opencollective_dvl database. And it comes with enough data to play with most of the system.

However, trying to access the home page will lead you to a 404 page. That's because we're porting our old UI over to the new one. The repository opencollective-website is deprecated but it still powers our home page and the /discover page.

To see something interesting, please access one of the collectives that are present in this sanitized version of the database. Here are some examples:

• http://localhost:13000/opensource
• http://localhost:13000/apex
• http://localhost:13000/railsgirlsatl
• http://localhost:13000/tipbox
• http://localhost:13000/brusselstogether
• http://localhost:13000/veganizerbxl

Participate on the discussion

If you have any questions, ping us on Slack (https://slack.opencollective.org) or on Twitter (@opencollect).

TODO

• The User model is confusing with the concept of User Collective, we should merge the "User" model with the "ConnectedAccount" model so that we could have multiple emails per User.
• CreatedByUserId is confusing, it should be "CreatedByCollectiveId"