🔗 coophub.io
This web app uses the GitHub API and GitLab API 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.
- Fork this repo or edit this file
- Add your co-op in the cooperatives.yml file:
key_org_name:
source: github|gitlab|git.coop
login: <USERNAME_IN_THE_SOURCE>
name: <NAME_OF_THE_COOP>
url: <URL_OF_THE_COOP>
description: <DESCRIPTION>
location: <LOCATION>
- Add-commit-push and send us a Pull Request!
See changelog file.
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 >= 18
- Elixir >= 1.5
- NodeJS >= 5.0
Use GITHUB_OAUTH_TOKEN
ENV var ir order to authenticate with the GitHub APIv3. Read the guide.
- 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.
- 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)
limit
- Numbersort
-popular
orlatest
(default)exclude_forks
- boolean (false
default)
- Update CHANGELOG.md with latest changes.
- Go to create a new release and complete the fields:
- Tag version:
vx.x.x
(likev0.2.2
). - Target: Always against
master
branch. - Release title: Same as tag version.
- Description: Just copy/paste the latest changes from CHANGELOG.md.
- Click the
Publish release
button and check that a new github action was started for this release. - When the github action finishes, a release asset should be attached (like
coophub-20200330-034316-0635b9c7.tar.gz
). - 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).