Coophub - Cooperatives repos over the world!

:link: coophub.io

This web app uses the open APIs of GitHub, GitLab, Git.coop, Codeberg and 0xacab to fetch, process and nicely display the projects/repositories of any subscribed cooperative from over the world.

Please note that it's strictly limited to cooperative enterprises.

The main goal is to gather in one place all the open source projects that can be used to start others, to be consumed, to learn or to just motivate collaboration.

Add your cooperative

1. Fork this repo or edit this file
2. Add your co-op in the cooperatives.yml file:

key_org_name:
  source: github|gitlab|git.coop|codeberg|0xacab
  login: <USERNAME_IN_THE_SOURCE>
  name: <NAME_OF_THE_COOP>
  url: <URL_OF_THE_COOP>
  description: <DESCRIPTION>
  location: <LOCATION>

3. Add-commit-push and send us a Pull Request!

Changelog

See changelog file.

Development

Use GITHUB_OAUTH_TOKEN ENV var in order to authenticate with the GitHub APIv3. Read the guide.

With docker

If you want to set any environment, like GITHUB_OAUTH_TOKEN, create a .env file with the custom values that you want.

Available environments:

Steps:

• Clone this repository
• Run the command docker compose up -d

Local

It uses the Elixir Phoenix Framework for the back-end and ReactJS for the front-end. Then, to run this app you will need:

• Erlang OTP >= 26
• Elixir >= 1.15
• NodeJS >= 24

Run it!

• Install dependencies with mix deps.get
• Install Node.js dependencies with npm install
• Start Phoenix server with mix phx.server

Now you can visit localhost:4000 from your browser.

API Endpoints

• GET api/orgs (all the coops)
• GET api/orgs/:name (detail of a coop)
• GET api/orgs/:name/repos (repos of a coop)
• GET api/repos (all coops repos)
• GET api/search?q=term_to_search
• GET api/topics (all the repos topics)
• GET api/languages (all the programming languages with percentages)
• GET api/languages/:lang (the repos using the lang)

Allowed query params

• limit - Number
• sort - popular or latest (default)
• exclude_forks - boolean (false default)

Releasing a new version

1. Update CHANGELOG.md with latest changes.
2. Go to create a new release and complete the fields:

• Tag version: vx.x.x (like v0.2.2).
• Target: Always against master branch.
• Release title: Same as tag version.
• Description: Just copy/paste the latest changes from CHANGELOG.md.

3. Click the Publish release button and check that a new github action was started for this release.
4. When the github action finishes, a release asset should be attached (like coophub-20200330-034316-0635b9c7.tar.gz).
5. Done! Just wait a few minutes and the new release will be deployed to https://coophub.io (you can check the version at site footer).

---

Working with the fiqus <=> farox fork

1. Rename original as "upstream"

git remote rename origin upstream

2. Add your fork as the new "origin"

git remote add origin git@github.com:farox-coop/coophub.git

3. Verify

git remote -v
# upstream  git@github.com:fiqus/coophub.git (fetch)
# upstream  git@github.com:fiqus/coophub.git (push)
# origin    git@github.com:farox-coop/coophub.git (fetch)
# origin    git@github.com:farox-coop/coophub.git (push)

Then push to fork

git push -u origin master

Then, to bring the changes to the original (deploy to coophub.io):

1. Go to https://github.com/farox-coop/coophub
2. Click "Pull Request" → farox-coop/coophub:master → fiqus/coophub:master
3. When merged, the fiqus/coophub CI launches build + deploy to coophub.io automatically.

To keep the fork synchronized in the future

git fetch upstream
git merge upstream/master
git push origin master