check-my-rpo-site.mov
Aiming to help Open Source Software OSS maintainers we, at the Sauce Labs Open Source Program Office, created Check-My-Repo. An automated tool built upon Repolinter, that verifies if the main necessary parameters to comply with open source best practices: from Readme to License, are present in the organizations or users repositories. By automating this verification open source projects maintenance is more effective and effortless, and can help you and your organization to have compliant software projects easier to service, test, upgrade, and maintain. Built with Node.js, Repolinter and Vue.js, it is designed to run locally and automated, displaying results on your organization’s or user’s GitHub Page.
Meant to be as easy as possible to enable right away usage, all you need to do is: fork it, and enable Pages choosing gh-pages as your GitHub pages repository. That easy 😊.
- Fork it
- Enable Actions on Settings/ Actions Permissions
- Enable Pages on Settings/ Pages by choosing gh-pages as your GitHub pages repository
check-my-repo-how-to.mov
Using GitHub Actions and default environment variables, it will automatically get our user/ organization public information.
Please note that, as Actions are planned to run once a day on cron: '0 0 * * *' time, or when a push is made to the main branch, you need to wait until your organization/ user information is updated in the page.
It is designed to be as neutral as possible and comply with A11y accessibility guidelines. But, of course, you can modify all you want, it is open sourced under MIT license. Check How to Configure file to know how to do it.
Even if you enable GitHub Actions, you may need to enable it in 2 other places on the Actions tab. After clicking on the enable button, go back to Settings / Pages and you will see a note saying your page is published.
touble-shooting-check-my-repo.mov
-
Navigate in your terminal into the director you want to clone the repository, for example:
cd Documents
- Clone your fork (remember to change "YOUR ORGANIZATION")
git clone https://github.com/<YOUR ORGANIZATION>/check-my-repo.git
- Open the cloned directory
cd check-my-repo
-
Open the repository on your favorite code editor. If you are using VSC you can use
.code
to open your code editor -
Install dependencies
npm install
- To run it locally, run the script:
node src/index.js
It enables you to verify all of your organization’s or user’s public repositories. You need to do this process at least once, as this generates a frontend.json file on the frontend/public folder, which will be used to display the information in Browser.
- Now let’s install your frontend application:
cd frontend
- Install frontend dependencies
npm install
- Run server locally
npm run serve
- Open link provided in terminal
Cmd + click
That’s it!
See CONTRIBUTING.md for details.
Want a fast, setup dev environment? .
Here for Hacktoberfest?. Check out Our Hacktoberfest Issues, or visit https://opensource.saucelabs.com/hacktoberfest/ to see all our Hacktoberfest projects!