{"id":13602633,"url":"https://github.com/first-timers/app","last_synced_at":"2025-09-20T02:21:18.008Z","repository":{"id":17903512,"uuid":"82415730","full_name":"first-timers/app","owner":"first-timers","description":"A friendly bot that helps onboarding new Open Source Contributors","archived":false,"fork":false,"pushed_at":"2025-01-06T08:33:07.000Z","size":3013,"stargazers_count":283,"open_issues_count":11,"forks_count":59,"subscribers_count":37,"default_branch":"main","last_synced_at":"2025-08-19T13:34:39.896Z","etag":null,"topics":["bot","community","first-timers-only","probot","probot-app"],"latest_commit_sha":null,"homepage":"https://github.com/marketplace/first-timers","language":"JavaScript","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"apache-2.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/first-timers.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"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":"gr2m"}},"created_at":"2017-02-18T20:59:41.000Z","updated_at":"2025-08-16T23:09:09.000Z","dependencies_parsed_at":"2023-12-26T23:31:53.983Z","dependency_job_id":"c582544f-3813-474e-8eb7-b5e7209d9861","html_url":"https://github.com/first-timers/app","commit_stats":{"total_commits":470,"total_committers":23,"mean_commits":"20.434782608695652","dds":0.5085106382978724,"last_synced_commit":"2a6f9ac1349fc411e248167b8f6b5d65373c3353"},"previous_names":["hoodiehq/first-timers-bot"],"tags_count":0,"template":false,"template_full_name":null,"purl":"pkg:github/first-timers/app","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/first-timers%2Fapp","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/first-timers%2Fapp/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/first-timers%2Fapp/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/first-timers%2Fapp/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/first-timers","download_url":"https://codeload.github.com/first-timers/app/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/first-timers%2Fapp/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":276033095,"owners_count":25573478,"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","status":"online","status_checked_at":"2025-09-20T02:00:10.207Z","response_time":63,"last_error":null,"robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":true,"can_crawl_api":true,"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":["bot","community","first-timers-only","probot","probot-app"],"created_at":"2024-08-01T18:01:32.288Z","updated_at":"2025-09-20T02:21:17.950Z","avatar_url":"https://github.com/first-timers.png","language":"JavaScript","funding_links":["https://github.com/sponsors/gr2m"],"categories":["JavaScript"],"sub_categories":[],"readme":"# first-timers-bot\n\n[![Build Status](https://github.com/first-timers/app/workflows/Test/badge.svg)](https://github.com/first-timers/app/actions?query=workflow%3ATest+branch%3Amain) [![Uptime Robot status](https://img.shields.io/uptimerobot/status/m779426128-6b6e81ed8dc987db17d4cad2.svg)](https://stats.uptimerobot.com/LZ40Lcoj4)\n\n### 🐶🎯⛳ The Motivation\n\nFrom our own experiences, we know the process of creating a pull request is the biggest barrier for new contributors. We wanted to streamline the process to create very simple contributor-friendly issues to help onboard more people to become Open Source contributors for the first time.\n\nAt Hoodie, we aim to become the most [welcoming Open Source community possible](http://hood.ie/blog/welcoming-communities.html). We joined forces with initiatives like [First Timers Only](http://www.firsttimersonly.com/) and [Your First PR](http://yourfirstpr.github.io/) to actively reach out to new contributors and create an environment where they feel encouraged and supported.\n\nCreating what we call [starter issues](http://hood.ie/blog/starter-issues.html) is one aspect of that. And it is one of the most successful. A subset of these starter issues are super simple fixes like typos, so they are perfect to onboard people and help them get familiar with GitHub and the pull request workflow. Because typos and similar issues are so trivial, we should basically be able to automatically generate the entire starter issue based on a diff.\n\n### 💡💥❓ How Things Work\n\nSay I’m a Hoodie contributor and find a typo somewhere. Instead of fixing the issue directly in the repository's default branch or creating a pull request which is time-consuming, I can simply create a new branch that is called something like _first-timers-only-typo-in-title._ GitHub will then notify the **First Timers Bot** about the new branch using Webhooks. The bot is listening to any new branch starting with **first-timers-** and it will create a new issue on your repo. The commit body can be used to add some context information and if left empty, the 🤔 **What you will need to know** section of the issue will simply say \"Nothing :)\".\n\n### 😮🙌👀🎉 Use Our Bot!\n\nFirst-timers-bot is built with [Probot](https://probot.github.io/).\n\n\u003ctable\u003e\n    \u003ctr\u003e\n        \u003cth\u003eSteps\u003c/th\u003e\n        \u003cth\u003eExample\u003c/th\u003e\n    \u003c/tr\u003e\n    \u003ctr\u003e\n        \u003ctd\u003e1) \u003ca href=\"https://github.com/apps/first-timers\"\u003eInstall App\u003c/a\u003e on a repo of your choice\u003c/td\u003e\n        \u003ctd\u003e\u003cimg src=\"/assets/Install-App.png?raw=true\"\u003e\u003c/td\u003e\n    \u003c/tr\u003e\n    \u003ctr\u003e\n        \u003ctd\u003e2) Click on the file you want to edit.\u003c/td\u003e\n        \u003ctd\u003e\u003cimg src=\"/assets/editPic.png?raw=true\"\u003e\u003c/td\u003e\n    \u003c/tr\u003e\n    \u003ctr\u003e\n        \u003ctd\u003e3) Make the change and write your commit message under \u003cb\u003eCommit changes\u003c/b\u003e.  Make sure to check \u003ci\u003eCreate a new branch\u003c/i\u003e at the bottom and the branch needs to start with \u003cb\u003e\"first-timers-\"\u003c/b\u003e.\u003c/td\u003e\n        \u003ctd\u003e\u003cimg src=\"/assets/Committing-Branch.png?raw=true\"\u003e\u003c/td\u003e\n    \u003c/tr\u003e\n    \u003ctr\u003e\n        \u003ctd\u003e4) Click on the \u003cb\u003eissues\u003c/b\u003e tab and notice your issue was created with your change and commit message. The contributor would then follow the steps on the issue message.\u003c/td\u003e\n        \u003ctd\u003e\u003cimg src=\"/assets/Issue-Generated.png?raw=true\"\u003c/td\u003e\n    \u003c/tr\u003e\n\u003c/table\u003e\n\n### 😱🙌😎 Result\n\n[Issue Example Here](https://github.com/arlene-perez/bot-app-test/issues/1)\n\n\u003cp align=\"center\"\u003e\u003cimg src=\"/assets/Issue-Done.png\"\u003e\u003c/p\u003e\n\n### Configuration\n\nThe first-timers app works without configuration. If you want to change the default settings, create a .github/first-timers.yml file with the content below and then you can adjust the options to your preference. When both the template \u0026 the repository is set, then the template is loaded from the _configured_ repository at the configured template path.\n\n```yaml\n# You can change the labels to suit your needs if \"first-timers-only\" is not what you are looking for.\n# These are some examples.\nlabels:\n  - first-timers-only\n\n# If you would like to add your own template for the issue, add an .md file to your .github folder\ntemplate: .github/first-timers-issue-template.md\n# In order to load the template from another repository, prefix the path with \"\u003crepo\u003e:\", e.g.\n# template: other-repo:.github/first-timers-issue-template.md\n\n# You can create the issue in a different repo than where the problem is. Just make sure you installed the bot on the configured repository.\n# The issue will link back to the original repository where the contribution will be made.\nrepository: repo-name\n```\n\nThe following placeholders are supported in the template and will be replaced upon creation:\n\n- `$DIFF`: The diff string\n- `$FILENAME`: The file name\n- `$BRANCH_URL`: URL to the file on github.com\n- `$REPO`: name of the repository\n- `$AUTHOR`: author of the user who created the commit\n- `$COMMIT_BODY`: The body of the commit\n\n**Configuration Example** 🖥 💯\n\nOur `first-timers/app` repository’s [`.github/first-timers.yml`](https://github.com/first-timers/app/blob/main/.github/first-timers.yml) file is using `hoodiehq/camp` repository’s [`.github/FIRST_TIMERS_ISSUE_TEMPLATE.md`](https://github.com/hoodiehq/camp/blob/gh-pages/.github/FIRST_TIMERS_ISSUE_TEMPLATE.md) file as a template to create an issue such as this one: https://github.com/hoodiehq/camp/issues/126.\n\n### Server Status\n\nMake sure to verify that the **status** badge at the top of this file is labeled as `up`. You can check the current status at https://stats.uptimerobot.com/LZ40Lcoj4\n\n### 👩‍💻💕About Us\n\n\u003c!-- Contributors START\nAngie_Gonzalez agonzalez0515 https://agonzalez0515.github.io\nArlene_Perez techforchange https://github.com/techforchange\nContributors END --\u003e\n\u003c!-- Contributors table START --\u003e\n\n| \u003cimg src=\"https://avatars.githubusercontent.com/agonzalez0515?s=100\" width=\"100\" alt=\"Angie Gonzalez\" /\u003e\u003cbr /\u003e[\u003csub\u003eAngie Gonzalez\u003c/sub\u003e](https://agonzalez0515.github.io)\u003cbr /\u003e | \u003cimg src=\"https://avatars.githubusercontent.com/techforchange?s=100\" width=\"100\" alt=\"Arlene Perez\" /\u003e\u003cbr /\u003e[\u003csub\u003eArlene Perez\u003c/sub\u003e](https://github.com/techforchange)\u003cbr /\u003e |\n| :------------------------------------------------------------------------------------------------------------------------------------------------------------------------------: | :---------------------------------------------------------------------------------------------------------------------------------------------------------------------------: |\n\n\u003c!-- Contributors table END --\u003e\n\nAngie and Arlene are LA natives that met while attending Dev Bootcamp in San Francisco. After bootcamp was over and they were back in LA, they wanted to once again be part of an amazing, welcoming community like DBC was. They found Hoodie through [Rails Girls Summer of Code](https://railsgirlssummerofcode.org/)! This project is extra special for them as it is their first contribution to open source.\n\n### Contributors\n\nThank you to everyone who has helped with this project.\n\n\u003c!-- Contributors START\n Michael_McCombie michaelmccombie https://twitter.com/michaelbuilds design\n Gregor_Martynus gr2m https://twitter.com/gr2m mentor\n Contributors END --\u003e\n\u003c!-- Contributors table START --\u003e\n\n| \u003cimg src=\"https://avatars.githubusercontent.com/michaelmccombie?s=100\" width=\"100\" alt=\"Michael McCombie\" /\u003e\u003cbr /\u003e[\u003csub\u003eMichael McCombie\u003c/sub\u003e](https://twitter.com/michaelbuilds)\u003cbr /\u003e[🎨](https://raw.githubusercontent.com/first-timers/app/51742c62ae3e4e2be7e58d170a9eab73a3871bf4/assets/avatar.png) | \u003cimg src=\"https://avatars.githubusercontent.com/gr2m?s=100\" width=\"100\" alt=\"Gregor Martynus\" /\u003e\u003cbr /\u003e[\u003csub\u003eGregor Martynus\u003c/sub\u003e](https://twitter.com/gr2m)\u003cbr /\u003e👨🏻‍🏫 |\n| :---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------: | :------------------------------------------------------------------------------------------------------------------------------------------------------------------: |\n\n\u003c!-- Contributors table END --\u003e\n\nThis project follows the [all-contributors](https://github.com/kentcdodds/all-contributors) specification.\n\n### License\n\n[Apache 2.0](http://www.apache.org/licenses/LICENSE-2.0)\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Ffirst-timers%2Fapp","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Ffirst-timers%2Fapp","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Ffirst-timers%2Fapp/lists"}