{"id":15136788,"url":"https://github.com/eddiehubcommunity/reporater","last_synced_at":"2025-10-23T11:31:50.753Z","repository":{"id":212686540,"uuid":"732075308","full_name":"EddieHubCommunity/RepoRater","owner":"EddieHubCommunity","description":"Rate GitHub Repos for Developer Experience (DX)","archived":true,"fork":false,"pushed_at":"2024-10-01T11:13:35.000Z","size":1151,"stargazers_count":155,"open_issues_count":23,"forks_count":35,"subscribers_count":3,"default_branch":"main","last_synced_at":"2024-12-17T01:42:46.177Z","etag":null,"topics":["appwrite","nextjs","tailwindcss"],"latest_commit_sha":null,"homepage":"https://repo-rater.eddiehub.org","language":"JavaScript","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/EddieHubCommunity.png","metadata":{"files":{"readme":"README.md","changelog":"CHANGELOG.md","contributing":"CONTRIBUTING.md","funding":".github/FUNDING.yml","license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null},"funding":{"github":["eddiejaoude"]}},"created_at":"2023-12-15T15:24:41.000Z","updated_at":"2024-11-12T06:00:40.000Z","dependencies_parsed_at":"2024-01-12T10:21:16.368Z","dependency_job_id":"df2b2d6c-5e9f-475b-9363-b42b0fe30411","html_url":"https://github.com/EddieHubCommunity/RepoRater","commit_stats":null,"previous_names":["eddiehubcommunity/reporater"],"tags_count":11,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/EddieHubCommunity%2FRepoRater","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/EddieHubCommunity%2FRepoRater/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/EddieHubCommunity%2FRepoRater/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/EddieHubCommunity%2FRepoRater/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/EddieHubCommunity","download_url":"https://codeload.github.com/EddieHubCommunity/RepoRater/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":237821649,"owners_count":19371801,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["appwrite","nextjs","tailwindcss"],"created_at":"2024-09-26T06:41:17.270Z","updated_at":"2025-10-23T11:31:50.134Z","avatar_url":"https://github.com/EddieHubCommunity.png","language":"JavaScript","funding_links":["https://github.com/sponsors/eddiejaoude"],"categories":[],"sub_categories":[],"readme":"\u003e [!IMPORTANT]\n\u003e This project is now archived. Thank you for your contributions to this project. The free rate limit on the hosting provider has been reached and it is not financially sustainable to continue this project.\n\u003e \n\n[![RepoRater](https://repo-rater.eddiehub.org/api/badge?owner=EddieHubCommunity\u0026name=RepoRater)](https://repo-rater.eddiehub.org/rate?owner=EddieHubCommunity\u0026name=RepoRater)\n\n# RepoRater\n\nThis project allows you to rate GitHub Repositories from the Developer Experience (DX) perspective.\n\nWhen considering your rating here are a few points you might like to think about:\n\n- does the Repo have a helpful community?\n- does the Repo have good documentation to enable you to get started?\n- are the maintainers supportive and do they provide useful feedback?\n\n## Features\n\n- [x] Login with GitHub OAuth\n- [x] Rate a Repo\n- [x] List all Repos\n- [x] List popular Repos\n- [x] Leaderboard of most active users\n- [x] README badges\n- [x] Search Repos\n\nWant to see any other features? [Open an issue](https://github.com/EddieHubCommunity/RepoRater/issues) and let us know.\n\n## Screenshots\n\n![repo-rater-laptop](https://github.com/EddieHubCommunity/RepoRater/assets/624760/6795c662-b9d2-45ee-9cbb-cf8a84064aa7)\n\n## Technologies used\n\n- [NextJS](https://nextjs.org)\n- [Appwrite](https://appwrite.io)\n- [Tailwind](https://tailwindcss.com)\n\n## Quickstart for development\n\n1. Sign up to Appwrite and create a project (free)\n2. Create database\n3. Create collections `app` with the attributes\n   - `ratings`: integer\n   - `repos`: integer\n   - `stars`: integer\n   - create empty document with `0` for each attribute\n4. Create collections `ratings` with the attributes\n   - `url`: url\n   - `username`: string (128)\n   - `rating`: integer\n5. Create collections `repos` with the attributes\n   - `url`: url\n   - `description`: string (1024)\n   - `name`: string (128, required)\n   - `votes`: integer\n   - `rating`: float\n   - `owner`: string (128)\n   - `logo`: string (512)\n   - `language`: string (32)\n   - `topics`: string with option `array` (1024)\n   - `stars`: integer\n6. Copy `.env.example` template file to `.env` (You can get these values from your Appwrite project settings)\n7. Get you private keys from Appwrite (Overview \u003e Integrations \u003e \"API Keys\" tab \u003e \"+ Create API key\" button) and add them to `.env` template (all data are required)\n8. Create an OAuth app on GitHub and connect it with Appwrite Authentication\n9. On collections `ratings` and `repos` enable read permissions for `all` users\n10. Create index on collection `repos`, named `url_search` with the attribute `url` and type `fulltext`\n11. Run the development server with:\n\n```bash\nnpm ci\nnpm run dev\n```\n\n12. Open [http://localhost:3000](http://localhost:3000) with your browser to see the result.\n\n## RepoRater Badge in your README\n\nAdd the following markdown to your README to show your RepoRater badge and link to rate your repository.\n\n[![RepoRater](https://repo-rater.eddiehub.org/api/badge?owner=EddieHubCommunity\u0026name=RepoRater)](https://repo-rater.eddiehub.org/rate?owner=EddieHubCommunity\u0026name=RepoRater)\n\n```markdown\n[![RepoRater](https://repo-rater.eddiehub.org/api/badge?owner=EddieHubCommunity\u0026name=RepoRater)](https://repo-rater.eddiehub.org/rate?owner=EddieHubCommunity\u0026name=RepoRater)\n```\n\nChange the `owner` and `name` parameters to your GitHub org/username and repository name.\n\n### Badge Style\n\nThe default badge is \"flat\" but there are other styles if you prefer. This is done by appending the url with the `style` parameter.\n\nHere are the options with examples:\n\n| style         | badge                                                                                                                  |\n| :------------ | :--------------------------------------------------------------------------------------------------------------------- |\n| flat          | ![flat](https://repo-rater.eddiehub.org/api/badge?owner=EddieHubCommunity\u0026name=RepoRater\u0026style=flat)                   |\n| flat-square   | ![flat-square](https://repo-rater.eddiehub.org/api/badge?owner=EddieHubCommunity\u0026name=RepoRater\u0026style=flat-square)     |\n| for-the-badge | ![for-the-badge](https://repo-rater.eddiehub.org/api/badge?owner=EddieHubCommunity\u0026name=RepoRater\u0026style=for-the-badge) |\n| plastic       | ![plastic](https://repo-rater.eddiehub.org/api/badge?owner=EddieHubCommunity\u0026name=RepoRater\u0026style=plastic)             |\n| social        | ![social](https://repo-rater.eddiehub.org/api/badge?owner=EddieHubCommunity\u0026name=RepoRater\u0026style=social)               |\n\n### Badge Format\n\nThe default badge format is to show the average rating out of `5`. You can also show the percentage. This is done by appending the url with the `format` parameter.\n\n[![RepoRater](https://repo-rater.eddiehub.org/api/badge?owner=EddieHubCommunity\u0026name=RepoRater)](https://repo-rater.eddiehub.org/rate?owner=EddieHubCommunity\u0026name=RepoRater\u0026format=percentage)\n\n```markdown\n[![RepoRater](https://repo-rater.eddiehub.org/api/badge?owner=EddieHubCommunity\u0026name=RepoRater)](https://repo-rater.eddiehub.org/rate?owner=EddieHubCommunity\u0026name=RepoRater\u0026format=percentage)\n```\n\n| format     | badge                                                                                                                                                                                           |\n| :--------- | :---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |\n| number     | [![RepoRater](https://repo-rater.eddiehub.org/api/badge?owner=EddieHubCommunity\u0026name=RepoRater\u0026format=number)](https://repo-rater.eddiehub.org/rate?owner=EddieHubCommunity\u0026name=RepoRater)     |\n| percentage | [![RepoRater](https://repo-rater.eddiehub.org/api/badge?owner=EddieHubCommunity\u0026name=RepoRater\u0026format=percentage)](https://repo-rater.eddiehub.org/rate?owner=EddieHubCommunity\u0026name=RepoRater) |\n\n## GitHub Action\n\n\u003e Automatically comment on Issues and Pull Requests to get votes\n\n```yml\nname: repo-rater\nrun-name: repo-rater (#${{ github.event.issue.number || github.event.pull_request.number }})\n\npermissions:\n  issues: write\n  pull-requests: write\n\non:\n  issues:\n    types: [closed]\n  pull_request:\n    types: [closed]\n\njobs:\n  repo-rater:\n    runs-on: ubuntu-latest\n    steps:\n      - uses: actions/checkout@v4\n      - uses: xkrishguptaa/action-repo-rater@v1\n        with:\n          github-token: ${{ secrets.GITHUB_TOKEN }}\n```\n\nMore details https://github.com/xkrishguptaa/action-repo-rater\n\n## API (for your 3rd party apps)\n\nYou can consume our data for your own apps.\n\n### User Leaderboard\n\nGET https://repo-rater.eddiehub.org/api/leaderboard\n\n```json\n[\n  {\n    \"username\": \"eddiejaoude\",\n    \"votes\": 5,\n    \"stars\": 13\n  },\n  {\n    \"username\": \"SaraJaoude\",\n    \"votes\": 3,\n    \"stars\": 5\n  },\n  {\n    \"username\": \"test2\",\n    \"votes\": 2,\n    \"stars\": 9\n  }\n]\n```\n\n### Popular Repos\n\nGET https://repo-rater.eddiehub.org/api/popular\n\nOptional paramater `?minimumVotes=5` (default is `5`)\n\n```json\n[\n  {\n    \"url\": \"https://github.com/appwrite/appwrite\",\n    \"logo\": \"https://avatars.githubusercontent.com/u/25003669?v=4\",\n    \"description\": \"Build like a team of hundreds_\",\n    \"rating\": 4.9,\n    \"votes\": 310,\n    \"owner\": \"appwrite\",\n    \"name\": \"appwrite\",\n    \"badgeViews\": 321\n  },\n  {\n    \"url\": \"https://github.com/EddieHubCommunity/BioDrop\",\n    \"logo\": \"https://avatars.githubusercontent.com/u/66388388?v=4\",\n    \"description\": \"Connect to your audience with a single link. Showcase the content you create and your projects in one place. Make it easier for people to find, follow and subscribe.\",\n    \"rating\": 4.75,\n    \"votes\": 49,\n    \"owner\": \"EddieHubCommunity\",\n    \"name\": \"BioDrop\",\n    \"badgeViews\": 109\n  }\n]\n```\n\n### All Repos with Search\n\nGET https://repo-rater.eddiehub.org/api/repos\n\nOptional paramater `?keyword=EddieHub`\n\n```json\n[\n  {\n    \"url\": \"https://github.com/EddieHubCommunity/BioDrop\",\n    \"logo\": \"https://avatars.githubusercontent.com/u/66388388?v=4\",\n    \"description\": \"Connect to your audience with a single link. Showcase the content you create and your projects in one place. Make it easier for people to find, follow and subscribe.\",\n    \"rating\": 4.75,\n    \"votes\": 49,\n    \"owner\": \"EddieHubCommunity\",\n    \"name\": \"BioDrop\",\n    \"badgeViews\": 321\n  },\n  {\n    \"url\": \"https://github.com/EddieHubCommunity/RepoRater\",\n    \"logo\": \"https://avatars.githubusercontent.com/u/66388388?v=4\",\n    \"description\": \"Connect to your audience with a single link. Showcase the content you create and your projects in one place. Make it easier for people to find, follow and subscribe.\",\n    \"rating\": 4.6,\n    \"votes\": 12,\n    \"owner\": \"EddieHubCommunity\",\n    \"name\": \"RepoRater\",\n    \"badgeViews\": 98\n  }\n]\n```\n\n### App stats\n\nGET https://repo-rater.eddiehub.org/api/stats\n\n```json\n{\n  \"ratings\": 1137,\n  \"repos\": 657,\n  \"stars\": 53,\n  \"$createdAt\": \"2023-12-24T07:41:21.204+00:00\",\n  \"$updatedAt\": \"2024-01-02T20:42:33.660+00:00\"\n}\n```\n\n## Community\n\nCome and chat with the community in the EddieHub Discord http://discord.eddiehub.org\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Feddiehubcommunity%2Freporater","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Feddiehubcommunity%2Freporater","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Feddiehubcommunity%2Freporater/lists"}