{"id":28075662,"url":"https://github.com/vadimdemedes/ohcrash","last_synced_at":"2025-05-13T00:59:00.913Z","repository":{"id":57313830,"uuid":"80991642","full_name":"vadimdemedes/ohcrash","owner":"vadimdemedes","description":"💣 Microservice to report errors directly to your repo's GitHub Issues","archived":false,"fork":false,"pushed_at":"2017-02-06T21:02:17.000Z","size":118,"stargazers_count":17,"open_issues_count":0,"forks_count":1,"subscribers_count":2,"default_branch":"master","last_synced_at":"2025-05-06T12:43:03.295Z","etag":null,"topics":["crash-reporting","error-reporting","microservice"],"latest_commit_sha":null,"homepage":"","language":"JavaScript","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":null,"status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/vadimdemedes.png","metadata":{"files":{"readme":"readme.md","changelog":null,"contributing":null,"funding":null,"license":null,"code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null}},"created_at":"2017-02-05T12:34:36.000Z","updated_at":"2020-03-10T20:54:24.000Z","dependencies_parsed_at":"2022-09-20T23:20:33.117Z","dependency_job_id":null,"html_url":"https://github.com/vadimdemedes/ohcrash","commit_stats":null,"previous_names":[],"tags_count":2,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/vadimdemedes%2Fohcrash","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/vadimdemedes%2Fohcrash/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/vadimdemedes%2Fohcrash/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/vadimdemedes%2Fohcrash/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/vadimdemedes","download_url":"https://codeload.github.com/vadimdemedes/ohcrash/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":253491664,"owners_count":21916898,"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":["crash-reporting","error-reporting","microservice"],"created_at":"2025-05-13T00:59:00.299Z","updated_at":"2025-05-13T00:59:00.890Z","avatar_url":"https://github.com/vadimdemedes.png","language":"JavaScript","funding_links":[],"categories":[],"sub_categories":[],"readme":"\u003ch1 align=\"center\"\u003e\n\t\u003cbr\u003e\n\t\u003cimg width=\"200\" src=\"https://cdn.rawgit.com/vadimdemedes/ohcrash/master/media/logo.svg\" alt=\"OhCrash\"\u003e\n\t\u003cbr\u003e\n\t\u003cbr\u003e\n\u003c/h1\u003e\n\n[![Build Status](https://travis-ci.org/vadimdemedes/ohcrash.svg?branch=master)](https://travis-ci.org/vadimdemedes/ohcrash)\n\nA microservice, which creates issues in a GitHub repository for each reported error.\nThink of it as barebones [BugSnag](https://bugsnag.com), but errors are reported straight to GitHub Issues.\n\nYou can effortlessly deploy your own instance of OhCrash using [now](https://zeit.co/now).\n\n[![Deploy to now](https://deploy.now.sh/static/button.svg)](https://deploy.now.sh/?repo=https://github.com/vadimdemedes/ohcrash\u0026env=GITHUB_TOKEN\u0026env=GITHUB_USER\u0026env=GITHUB_REPO)\n\n\n## Usage\n\nOhCrash microservice requires a GitHub token, username and a repository name.\nYou can obtain your personal access token [here](https://github.com/settings/tokens).\nMake sure to select `public_repo` scope to create issues in a public repository or `repo` for private repositories.\n\nIf you want to run OhCrash locally:\n\n```bash\n$ npm install --global ohcrash\n$ export GITHUB_TOKEN=\"your token\"\n$ export GITHUB_USER=\"your username\"\n$ export GITHUB_REPO=\"target repository name\"\n$ ohcrash\n```\n\n`ohcrash` command accepts the same options as [micro](https://github.com/zeit/micro).\n\nAfter OhCrash instance is up, use [ohcrash-client](https://github.com/vadimdemedes/ohcrash-client) module to start reporting errors!\nIt catches uncaught exceptions and unhandled rejections out-of-the-box.\nErrors can also be reported manually, using a `report()` method.\n\n```js\nconst ohcrash = require('ohcrash-client').register('http://localhost:3000');\n\nconst err = new Error('Custom error handling');\nohcrash.report(err);\n```\n\nLearn more about the client at [ohcrash-client](https://github.com/vadimdemedes/ohcrash-client) repository.\n\n\n## Deployment\n\nOhCrash can (and should 😄) be easily deployed to [now](https://github.com/zeit/now) by Zeit.\nAssuming you've got `now` all set up:\n\n```\n$ now -e GITHUB_TOKEN=token -e GITHUB_USER=user -e GITHUB_REPO=repo vadimdemedes/ohcrash\n```\n\nAlternatively, deploy `ohcrash` without even leaving the browser:\n\n[![Deploy to now](https://deploy.now.sh/static/button.svg)](https://deploy.now.sh/?repo=https://github.com/vadimdemedes/ohcrash\u0026env=GITHUB_TOKEN\u0026env=GITHUB_USER\u0026env=GITHUB_REPO)\n\nMake sure to set a persistent alias using `now alias` for your deployment.\nExecute `now help alias` for information on how to do this.\nLater, use that URL as an endpoint for [ohcrash-client](https://github.com/vadimdemedes/ohcrash-client).\n\n```js\nrequire('ohcrash-client').register('https://my-ohcrash.now.sh');\n```\n\n## License\n\nMIT © [Vadim Demedes](https://vadimdemedes.com)\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fvadimdemedes%2Fohcrash","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fvadimdemedes%2Fohcrash","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fvadimdemedes%2Fohcrash/lists"}