{"id":22157977,"url":"https://github.com/lucavallin/verto","last_synced_at":"2025-05-15T14:05:42.239Z","repository":{"id":65014130,"uuid":"572041069","full_name":"lucavallin/verto","owner":"lucavallin","description":"Your Gateway to Open-Source Collaboration.","archived":false,"fork":false,"pushed_at":"2025-05-05T03:39:21.000Z","size":5109,"stargazers_count":425,"open_issues_count":17,"forks_count":91,"subscribers_count":3,"default_branch":"main","last_synced_at":"2025-05-15T14:05:34.789Z","etag":null,"topics":["github","gitlab","good-first-issue","hacktoberfest","javascript","nextjs","open-source","react","reactjs","typescript"],"latest_commit_sha":null,"homepage":"https://verto.sh","language":"TypeScript","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":"deepsourcelabs/good-first-issue","license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/lucavallin.png","metadata":{"files":{"readme":"README.md","changelog":null,"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,"zenodo":null},"funding":{"github":[]}},"created_at":"2022-11-29T12:37:06.000Z","updated_at":"2025-05-15T08:00:51.000Z","dependencies_parsed_at":"2023-09-26T04:53:54.115Z","dependency_job_id":"dfc52a0e-ae51-4af3-9f60-7d47b136ff13","html_url":"https://github.com/lucavallin/verto","commit_stats":null,"previous_names":["lucavallin/verto","lucavallin/first-issue"],"tags_count":0,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/lucavallin%2Fverto","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/lucavallin%2Fverto/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/lucavallin%2Fverto/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/lucavallin%2Fverto/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/lucavallin","download_url":"https://codeload.github.com/lucavallin/verto/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":254355334,"owners_count":22057354,"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":["github","gitlab","good-first-issue","hacktoberfest","javascript","nextjs","open-source","react","reactjs","typescript"],"created_at":"2024-12-02T03:16:45.564Z","updated_at":"2025-05-15T14:05:37.230Z","avatar_url":"https://github.com/lucavallin.png","language":"TypeScript","funding_links":[],"categories":[],"sub_categories":[],"readme":"# verto.sh\n\u003e Your Gateway to Open-Source Collaboration.\n\n\u003cp align=\"center\"\u003e\n  \u003cimg src=\"/public/meta.png\" width=\"100%\"/\u003e\n\u003c/p\u003e\n\n---\n\nStep into the world of open-source with **verto.sh**! We carefully pick out popular projects with easy-to-tackle issues, making it simple for developers to find a new or first project to contribute to. **verto.sh** is more than just a list — it's a platform. It's where beginners can make their first contribution, founders can build a solid team, and maintainers can find new contributors.\n\nThe open-source community is always welcoming new talent, but getting started can feel tough. **verto.sh** makes it easier. By showing newcomers the ropes and connecting them with projects that need a hand, we're helping not just individuals, but the whole open-source movement.\n\nWith **verto.sh**, take the first step into collaborative coding, and be part of something bigger. Your code today could be the start of something amazing in the open-source community.\n\n## Adding a New Project\n\nYou're welcome to add a new project in **verto.sh**, just follow these steps:\n\n- To maintain the quality of projects in **verto.sh**, please make sure the repository you want to add meets the following criteria:\n\n  - For **GitHub** repositories: it has at least three issues with the `good first issue` label or other labels defined in [config.json](config.json) (see `labels` and the end of the `GitHub` provider).\n\n  - For **GitLab** repositories: it has at least three issues with the `quick win` label or other labels defined in [config.json](config.json) (see `labels` and the end of the `GitLab` provider).\n\n  - It has at least 10 contributors.\n\n  - It has at least 1000 stars.\n\n  - It contains a README.md with detailed setup instructions for the project, and a CONTRIBUTING.md with guidelines for new contributors.\n\n  - It is actively maintained (last update less than 1 month ago).\n\n- For **GitHub** repositories: add your repository's path (in the format `owner/name` and lexicographic order) to [config.json](config.json) inside the `GitHub` provider.\n\n- For **GitLab** repositories: add your repository's id (in the format `\u003cproject path\u003e|\u003cproject id\u003e`) to [config.json](config.json) inside the `GitLab` provider.\n\n- Create a new pull-request. Please add the link to the issues page of the repository in the PR description. Once the pull request is merged, the changes will be live on [verto.sh](https://verto.sh/).\n\n## How Does It Work?\n\n**verto.sh** uses Next.js, React and Typescript. The data shown on the website is loaded from the [data.json](data/data.json) file, which is generated by a function in [data/utils.ts](data/utils.ts). It queries the GitHub and GitLab APIs to fetch issues from the repositories listed in [config.json](config.json). The labels defined in [config.json](config.json) are used to filter issues for the repositories.\n\n## How to Setup The Project Locally\n\nTo contribute new features and changes to the website, you would want to run the app locally. Please follow these steps:\n\n1. Fork the repository, clone it locally, create a new branch to work on a specific feature or bug fix without affecting the main branch of the repository. Make sure you have a recent version of Node.js installed on your computer.\n2. You can use the included [data.json](data/data.json) as dummy data or you can run `npm run prebuild` to fetch the latest data from GitHub yourself: for this, you will need to set the `GH_PAT` environment variable to a valid GitHub Personal Access Token (PAT). Notice: repositories not maching the criteria listed above (see rules in [data.json](data/data.json)are automatically removed from [config.json](config.json) when the [data.json]data/data.json) script runs.\n3. Start the development server and open the app in your browser.\n\n```bash\n# install the dependencies\n$ npm install\n# start the development server\n$ npm run dev\n```\n\nGood to know when you commit: the project contains a `pre-commit` hook that runs linters automatically to ensure code quality!\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Flucavallin%2Fverto","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Flucavallin%2Fverto","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Flucavallin%2Fverto/lists"}