{"id":18737811,"url":"https://github.com/colemars/devcontra-api","last_synced_at":"2025-11-17T19:30:15.949Z","repository":{"id":48282986,"uuid":"201179055","full_name":"colemars/devcontra-api","owner":"colemars","description":"Contribution aggregation tool hooked up to aws via serverless framework","archived":false,"fork":false,"pushed_at":"2021-08-03T13:26:41.000Z","size":44900,"stargazers_count":0,"open_issues_count":26,"forks_count":0,"subscribers_count":1,"default_branch":"master","last_synced_at":"2025-02-15T14:16:16.084Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":"","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/colemars.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":"CONTRIBUTING.MD","funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null}},"created_at":"2019-08-08T04:37:31.000Z","updated_at":"2020-01-25T06:02:42.000Z","dependencies_parsed_at":"2022-08-26T02:23:42.876Z","dependency_job_id":null,"html_url":"https://github.com/colemars/devcontra-api","commit_stats":null,"previous_names":[],"tags_count":0,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/colemars%2Fdevcontra-api","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/colemars%2Fdevcontra-api/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/colemars%2Fdevcontra-api/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/colemars%2Fdevcontra-api/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/colemars","download_url":"https://codeload.github.com/colemars/devcontra-api/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":239611961,"owners_count":19668276,"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":[],"created_at":"2024-11-07T15:26:55.522Z","updated_at":"2025-11-17T19:30:15.703Z","avatar_url":"https://github.com/colemars.png","language":"JavaScript","readme":"\u003cp align=\"center\"\u003e\n  \u003ca href=\"https://prod-devcontra.now.sh\" rel=\"noopener\" target=\"_blank\"\u003e\u003cimg width=\"400\" src=\"https://i.imgur.com/yq3L9as.png\" alt=\"DevContra logo\"\u003e\u003c/a\u003e\u003c/p\u003e\n\u003c/p\u003e\n\n\u003ch1 align=\"center\"\u003eDevContra\u003c/h1\u003e\n\n\u003cdiv align=\"center\"\u003e\n\n[React](https://reactjs.org/) component that implements [d3](https://github.com/d3/d3) for data visualization and is configured via the [DevContra Client](https://prod-devcontra.now.sh).\n\n[![npm package](https://img.shields.io/npm/v/devcontra/latest.svg)](https://www.npmjs.com/package/devcontra)\n[![npm downloads](https://img.shields.io/npm/dm/devcontra.svg)](https://www.npmjs.com/package/devcontra)\n![Code style](https://img.shields.io/badge/code_style-prettier-ff69b4.svg)\n[![Follow on Twitter](https://img.shields.io/twitter/follow/itsacolemars.svg?label=follow)](https://twitter.com/itsacolemars)\n[![Dependabot Status](https://api.dependabot.com/badges/status?host=github\u0026repo=colemars/devcontra-component)](https://dependabot.com)\n[![peerDependencies Status](https://david-dm.org/colemars/devcontra-component/peer-status.svg)](https://david-dm.org/colemars/devcontra-component?type=peer)\n[![dependencies Status](https://david-dm.org/colemars/devcontra-component/status.svg)](https://david-dm.org/colemars/devcontra-component)\n[![devDependencies Status](https://david-dm.org/colemars/devcontra-component/dev-status.svg)](https://david-dm.org/colemars/devcontra-component?type=dev)\n[![Average time to resolve an issue](https://isitmaintained.com/badge/resolution/colemars/devcontra-component.svg)](https://isitmaintained.com/project/colemars/devcontra-component \"Average time to resolve an issue\")\n\u003c/div\u003e\n\n## What is it?\n\nA data viz tool that aggregates all of your dev contribution activity into one component that can be easily integrated into your personal website.\n\nData is currently fetched from Twitter, Github, and StackOverflow, with support for Spectrum coming soon.\n\nEach band in the timeline represents a week of dev activity, with 17 total bands, and the current, or most recent, week/band being the outermost. The type of activity is color coded according to the respective platform's brand.\n\n## \"Dev Activity\"?\n\nYour Github activity is determined by the commits, issues, and pull requests authored by you.\n\nYour StackOverflow activity is determined by your posts, answers, and comments - as well as any badges you recieve.\n\nYour Twitter activity is determined by parsing your tweets for relevant hashtags that match any existing StackOverflow tag. Support for adding tags to match against is coming soon.\n\n## Installation\n\nDevContra is available as an [npm package](https://www.npmjs.com/package/devcontra).\n\n**[Stable channel v0](https://prod-devcontra.now.sh)**\n```sh\n// with npm\nnpm i devcontra\n\n// with yarn\nyarn add devcontra\n```\n\nPlease note that `@next` will only point to pre-releases; to get the latest stable release use `@latest` instead.\n\n## Usage\n\nHere is a quick example to get you started, **it's all you need**:\n\n```jsx\nimport React from 'react';\nimport DevContra from 'devcontra';\n\nfunction App() {\n  return (\n    // test key\n    \u003cDevContra profileKey=\"e380df4d-c9b0-4ac0-be51-6cf8a49d0760\" /\u003e\n  );\n}\n\nReactDOM.render(\u003cApp /\u003e, document.querySelector('#app'));\n```\n\nSee it here in this live demo:\n\n[![Edit Button](https://codesandbox.io/static/img/play-codesandbox.svg)](https://codesandbox.io/s/beautiful-shamir-m2h0z)\n\n## Configuration\n\nYou can begin configuring your profile [here](devcontra.colemars.dev). After you create your account you will be able to set your twitter, stackoverflow, and github profiles, and receive your unique `profileKey`.\n\n## Customization\n\nSeveral optional `props` are available to customize your component. \n\n`determinedMax` sets your domain, or the value you want your results to be relative to. If not set, it defaults to the nearest rounded up tenths place from your most active week. If your most active week has 72 contributions, your timeline will be set relative to a value of 80.\n\n`diameter` is responsible for the size of your component. The default value is 350.\n\n`padding` can be used to increase padding around the svg. Default padding is 0.\n\n\n```jsx\nimport React from 'react';\nimport DevContra from 'devcontra';\n\nfunction App() {\n  return (\n    // test key\n    \u003cDevContra\n      profileKey=\"e380df4d-c9b0-4ac0-be51-6cf8a49d0760\"\n      deteminedMax={80}\n      diameter={350}\n      padding={0}\n    /\u003e\n  );\n}\n\nReactDOM.render(\u003cApp /\u003e, document.querySelector('#app'));\n```\n\n## Questions\n\nFor *how-to* questions and other non-issues,\nplease free to use Github issues or contact me directly.\n\n## Examples\n\n[DevContra Demo](https://prod-devcontra.now.sh/demo)\n\n## Contributing\n\nRead the [contributing guide](/CONTRIBUTING.MD) to learn about our development process, how to propose bugfixes and improvements, and how to build and test your changes to DevContra.\n\n## Changelog\n\nRecently Updated?\nPlease read the [changelog](https://github.com/colemars/devcontra-component/releases).\n\n## Roadmap\n\nThe future plans and high priority features and enhancements can be found [here](/ROADMAP.md).\n\n## Utilizes\n\n[\u003cimg src=\"https://github.githubassets.com/images/modules/logos_page/GitHub-Logo.png\" width=\"100\"\u003e](https://github.com/)\n\nGitHub's beta API allows for easy data fatching for repo activity history.\n\n[\u003cimg src=\"https://seeklogo.com/images/T/twitter-logo-C591CF37A1-seeklogo.com.png\" width=\"120\"\u003e](https://circleci.com/)\n\nTwitters's API allows for easy data fatching for tweet history.\n\n[\u003cimg src=\"https://i.stack.imgur.com/BDie5.png\" width=\"200\"\u003e](https://www.netlify.com/)\n\nStackOverflow's API allows for easy data fatching for post history.\n\n[\u003cimg src=\"https://d1.awsstatic.com/logos/aws-logo-lockups/poweredbyaws/PB_AWS_logo_RGB.61d334f1a1a427ea597afa54be359ca5a5aaad5f.png\" width=\"200\"\u003e](https://crowdin.com/)\n\ndynamoDb, Cognito, Cloudformation, API Gateway, IAM, and CloudWatch make continuous devopment and management of this tool as simple as possible.\n\n[\u003cimg src=\"https://www.browserstack.com/images/mail/browserstack-logo-footer.png\" width=\"150\"\u003e](https://www.browserstack.com/)\n\nBrowserStack allows us to test in real browsers.\n\n[\u003cimg src=\"https://avatars1.githubusercontent.com/u/52219245?s=200\u0026v=4\" width=\"50\"\u003e](https://seed.run)\n\nSeed.run allows for simple and quick API CI/CD pipeline management.\n\n[\u003cimg src=\"https://user-images.githubusercontent.com/2752551/30404910-d56d9b66-989d-11e7-9208-b720eb28b4f2.png\" width=\"150\"\u003e](https://serverless.com/)\n\nServerless Framework allows for building and operating a serverless application. \n\n[\u003cimg src=\"https://lh4.googleusercontent.com/XnrMs4cNpMtZLAuUxypJnF1hDllFb3Hz53_WlHIqx8yo0yPzTnjfGmb18dS_9fHzJF5RjgEct7Wv7Xd99PJCCA6n5GOEvdZNxGTF0JulDZPYaGaoT-c25Zxcon9pCZqLeHSZgvuZ\" width=\"150\"\u003e](https://zeit.co/)\n\nZEIT Now offers a great solution for site hosting. \n\n[\u003cimg src=\"https://seeklogo.com/images/N/next-js-logo-7929BCD36F-seeklogo.com.png\" width=\"150\"\u003e](https://nextjs.org/)\n\nNEXT.js is a React Framework that offers a great server side rendering solution.\n\n## Other Repos\n\n[DevContra Component](https://github.com/colemars/devcontra-component)\n\n[DevContra Client](https://github.com/colemars/devcontra-client)\n\n\n## License\n\nThis project is licensed under the terms of the\n[MIT license](/LICENSE).\n","funding_links":[],"categories":[],"sub_categories":[],"project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fcolemars%2Fdevcontra-api","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fcolemars%2Fdevcontra-api","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fcolemars%2Fdevcontra-api/lists"}