The Starred PH

⭐ Top 10 most starred Github repositories in the Philippines

About

The project aims to be a station for fellow pinoy developers and their projects to be promoted, so that others may see it as well. For starters also, who might be curious of what other tech craftsmen do at their spare time and what frameworks they use.

More details are provided in content/about.md file.

Objectives

1. Promote fellow Pinoy developers and their projects
2. Learn more about unit testing and Github actions
3. Learn how open source community works

Setup and Dependencies

Nuxt

# install dependencies
$ npm install

# serve with hot reload at localhost:3000
$ npm run dev

# build for production and launch server
$ npm run build
$ npm run start

# generate static project
$ npm run generate

# run unit tests
$ npm run test

For detailed explanation on how things work, check out Nuxt.js docs.

Github Graphql API

To be able to request to Github's Graphql API, one must secure an OAuth token with the right scopes. Please follow along with this provided documentation.

Environment

After the token has been created, make a copy of .env.sample file and rename it to .env in the project root. Values should be the following:

# can be production | develop
ENVIRONMENT=develop

GH_GQL_API_URL=https://api.github.com/graphql
GH_GQL_ACCESS_KEY=your-github-access-key-here

# any name here, I named mine tph-github-repos
SESSION_KEY_NAME=tph-github-repos

Rate limit and caching

To avoid excessive calls to Github's Graphql API, query results are being cached to user's browser using session storage.

What's next?

At the moment, The Starred PH lists works that are made in the Github ecosystem only. The project is eyeing to get lists of top works also in other platforms assuming that those have public facing API.

Ideas such as:

• Most starred artwork in platforms such as Dribbble, Artstation and the likes.
• Most followed Pinoy youtuber, or most viewed video of them.
• And so on, if it can promote our Pinoy creatives.

Contribute

Hi 👋, thanks for taking some time to read this document. If it happens that you know Nuxt and have experience in implementing any of the ideas mentioned above, or have some suggestions on the current look/behavior of the site, or seen some inconsistencies, please feel free to submit an issue and/or create a pull request.

Contributions are very much welcome in this project.

Please see Contributing Guide and Code of Conduct to get started.

License

This project is licensed under MIT License