{"id":20234818,"url":"https://github.com/datamade/my-reps","last_synced_at":"2025-04-12T22:22:55.351Z","repository":{"id":53477623,"uuid":"61902500","full_name":"datamade/my-reps","owner":"datamade","description":":busts_in_silhouette: Enter your address to find your elected representatives. Powered by the Google Civic Information API","archived":false,"fork":false,"pushed_at":"2025-02-27T18:07:46.000Z","size":346,"stargazers_count":74,"open_issues_count":11,"forks_count":184,"subscribers_count":6,"default_branch":"main","last_synced_at":"2025-04-05T20:01:33.555Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":"https://myreps.datamade.us","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/datamade.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}},"created_at":"2016-06-24T17:52:32.000Z","updated_at":"2025-02-27T18:07:44.000Z","dependencies_parsed_at":"2022-08-17T23:05:33.802Z","dependency_job_id":"657b40dd-5c3c-41d4-ac8d-b2cec01c074c","html_url":"https://github.com/datamade/my-reps","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/datamade%2Fmy-reps","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/datamade%2Fmy-reps/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/datamade%2Fmy-reps/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/datamade%2Fmy-reps/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/datamade","download_url":"https://codeload.github.com/datamade/my-reps/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":248638608,"owners_count":21137690,"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-14T08:13:11.571Z","updated_at":"2025-04-12T22:22:55.315Z","avatar_url":"https://github.com/datamade.png","language":"JavaScript","funding_links":[],"categories":[],"sub_categories":[],"readme":"# My Reps\n\n## My Reps will stop working in April 2025\n\nThe Google Civic Information API, which powers this website, will [shut down in April 2025](https://groups.google.com/g/google-civicinfo-api/c/9fwFn-dhktA) and My Reps will stop working.\n\nWe recommend you switch to one of these free tools: [BallotReady](https://www.ballotready.org/), [Elected Officials \u0026 Districts by Cicero](https://live.cicerodata.com/live/local), [Who Represents Me? by BallotPedia](https://ballotpedia.org/Who_represents_me).\n\n## About My Reps\n\nMy Reps helps you locate and contact your federal, state, county and local elected representatives. Based on [my-reps-pbp](https://github.com/datamade/my-reps-pbp) by [DataMade](https://datamade.us/) and [Participatory Budgeting Project](http://participatorybudgeting.org/). Powered by the [Google Civic Information API](https://developers.google.com/civic-information/).\n\nFor more, read our launch blog post: \"[We find your reps so you don't have to](https://datamade.us/blog/we-find-your-reps-so-you-dont-have-to)\".\n\n**Custom installations**: If you would like assistance setting up a customized version of this tool, contact DataMade: info@datamade.us\n\n## Demo site: [myreps.datamade.us](http://myreps.datamade.us)\n\n![My Reps](https://datamade.us/images/blog/2016-07-26-we-find-your-reps-so-you-dont-have-to/img1.jpg)\n\n## Organizers: reuse our code!\n\nWe built this tool to be open source and easy to repurpose. Feel free to copy, reuse, and customize the My Reps codebase.\n\nHere's how to do it:\n\n#### 1. Fork this repository\n\nClick the 'Fork' button in the upper right corner of this page to copy it to your GitHub account.\n\n![Fork this repo](https://help.github.com/assets/images/help/repository/fork_button.jpg)\n\n#### 2. Clone this project to your local computer\n\nNext, you can clone it to your local computer (requires the command line):\n``` bash\ngit clone git@github.com:your-name-here/my-reps.git\ncd my-reps\n```\n\nYou can use [GitHub Desktop](https://desktop.github.com/) instead if you are not familiar with the command line.\n\n#### 3. Add your Google API key\n\nFor the address search, map and representative lookup to work, you'll need to get a Google API key. You can get yours and enable it by following these instructions: https://developers.google.com/maps/documentation/javascript/get-api-key\n\nYou'll need to make sure that you enable the following API services from Google:\n\n* Geocoding API\n* Geolocation API\n* Maps Javascript API\n* Google Civic Information API\n* Places API\n\nRead Google's instructions on how to enable these services: https://support.google.com/googleapi/answer/6158841?hl=en\n\nWhen you get a key, set the `google_api_key` in `_config.yml`.\n\n```\nport:  5000\nmarkdown: kramdown\nname: \"My Reps\"\n\n...\n\ngoogle_api_key: YOUR API KEY GOES HERE\n```\n\n#### 4. Modify the `index.html` and `/js/lookup_tool.js` files as needed\n\nSome examples of things you can do:\n\n**Customize the messaging**\n\nFirst, create a new tagline in the `_layouts/default.html` page.\n\n```html\n\u003cdiv class='text-center'\u003e\n    \u003ch1\u003e\u003ca href='index.html'\u003eMy Reps\u003c/a\u003e\u003c/h1\u003e\n    \u003c!-- Update this tagline! --\u003e\n    \u003cp class='lead'\u003eEnter your address to \u003cstrong\u003efind and contact\u003c/strong\u003e your federal, state, county and local elected representatives\u003c/p\u003e\n\u003c/div\u003e\n```\n\nThen, add text to the top of the `index.html` page.\n\n```html\n---\nlayout: default\n---\n\n\u003cp class='text-center'\u003eThis is my call to action. Let's do something about it!\u003c/p\u003e\n\n\u003cdiv class=\"row\"\u003e\n...\n\n```\n\n**Change the instructions in the 'contact' popup for each representative**\n\nYou can change the text that displays when you click the 'Contact' button next to each representative. Go to the `modalGuts` section in `index.html` and look for 'Add your contact instructions here!'.\n\nNote that we're using [EJS templates](http://www.embeddedjs.com/) for this part, so mind the template tags.\n\n**Limit your results to specific levels of government (local, county, state \u0026 federal)**\n\nIn `js/lookup_tool.js` you can toggle if you want to show federal, state, county and local government representatives.\n\n```javascript\n\nvar show_federal = true; //change this to false to hide federal results\nvar show_state   = true;\nvar show_county  = true;\nvar show_local   = true;\n\n```\n\n#### 5. Run it\n\nThis website is built using Jekyll. You will need to [install it first](http://jekyllrb.com/docs/installation/).\n\n```console\njekyll serve -w\n```\n\nThen, open your web browser and navigate to http://localhost:5000\n\n#### 6. Deploy it with GitHub pages\n\n**GitHub pages** You can host your table on GitHub pages for free! Once you've made all your changes and committed them, push everything in the `master` branch to `gh-pages`, which automatically enables GitHub pages.\n```bash\ngit push origin master:gh-pages\n```\n\nThen navigate to http://your-github-username.github.io/my-reps/\n\nRead more on working with [GitHub pages projects](https://help.github.com/articles/user-organization-and-project-pages/#project-pages).\n\n#### 7. Add it as an iframe on your site (optional)\n\nWant to embed your nifty table on your website? You can use an [iframe](http://www.w3schools.com/tags/tag_iframe.asp). Once you've deployed your table (above in step 5) you can link to it in an iframe right in your HTML.\n\nHere's an example:\n\n```html\n\u003ciframe style=\"border-style: none;\" src=\"https://datamade.github.io/my-reps/\" height=\"950\" width=\"600\"\u003e\u003c/iframe\u003e\n```\n\nIf you need professional assistance, contact DataMade at info@datamade.us\n\n## Reporting outdated or missing information\n\nInformation on elected officials comes from the [Google Civic Information API](https://developers.google.com/civic-information/), which aggregates data across the United States on elected officials in federal, state, county and local government offices.\n\nSometimes data is outdated or missing. If you notice an issue with the data, please [report it to Google](https://docs.google.com/forms/d/e/1FAIpQLScFpFTOkTpm0YoerLLprY_ySS9PRXLsu27SM01hebHqkefW2Q/viewform).\n\n## Web dependencies\n\nData comes from the [Google Civic Information API](https://developers.google.com/civic-information/).\n\nWe used the following open source tools:\n\n* [Jekyll](http://jekyllrb.com/docs/installation/) - Static website framework\n* [Bootstrap](http://getbootstrap.com/) - Responsive HTML, CSS and Javascript framework\n* [jQuery Address](https://github.com/asual/jquery-address) - javascript library creating RESTful URLs\n* [Google Civic Information API](https://developers.google.com/civic-information/) - API for looking up elected representatives in the USA\n\n## Team\n\n* Derek Eder - developer, content\n* Eric van Zanten - developer\n\n## Errors and Bugs\n\nIf something is not behaving intuitively, it is a bug, and should be reported.\nReport it here: https://github.com/datamade/my-reps/issues\n\n## Note on Patches and Pull Requests\n\n* Fork the project.\n* Make your feature addition or bug fix.\n* Send a pull request. Bonus points for topic branches.\n\n## Copyright\n\nCopyright (c) 2016 DataMade. Released under the [MIT License](https://github.com/datamade/my-reps/blob/master/LICENSE).\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fdatamade%2Fmy-reps","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fdatamade%2Fmy-reps","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fdatamade%2Fmy-reps/lists"}