UNMAINTAINED. An embeddable widget to find issues on the Code for America API

Subscribe to updates I use civic-issue-finder

Statistics on civic-issue-finder

Number of watchers on Github 33
Number of open issues 22
Average time to close an issue 2 months
Main language Python
Average time to merge a PR 2 days
Open pull requests 3+
Closed pull requests 0+
Last commit 5 months ago
Repo Created over 3 years ago
Repo Last Updated about 2 months ago
Size 361 KB
Homepage http://www.codefo...
Organization / Authorcodeforamerica
Page Updated
Do you use civic-issue-finder? Leave a review!
View open issues (22)
View civic-issue-finder activity
View on github
Latest Open Source Launches
Trendy new open source projects in your inbox! View examples

Subscribe to our mailing list

Evaluating civic-issue-finder for your project? Score Explanation
Commits Score (?)
Issues & PR Score (?)


Civic Issue Finder

The easiest way to get started with civic hacking. This is a small, embeddable, and customizable web app that makes it easy to find open GitHub Issues from across the civic technology movement. It fetches data from the Code for America API.

How to get your Issues included

  1. Get your group included on the CfAPI. Don't worry if your group isn't a Brigade. We're glad to have you!
  2. Ensure your project is included in your group's projects on the CfAPI. Ask your Captain or Delivery Lead how they included projects or check the projects_list_url column for your group on the Group Information sheet.
  3. Create GitHub Issues for your projects. Make sure they are easy to understand. Create and use appropriate GitHub labels. We recommend using help wanted whenever it is as we display these issues on the most sites.
  4. The CfAPI updates once an hour. Check back to see if your Issues appear. Send a message to @ondrae if you need help.

How to Use

This widget can be accessed directly, or it can be embedded into any webpage with the code generated by our embed tool.

Summary Video

Kind of long and boring

Blog Post

The Embed Code

<iframe src="" width="100%" height="600" frameBorder="0"> </iframe>

The url in the src attribute of the iframe can be given the following query params to customize your widget

  • organization_name: Only looks for issues of projects in the given organization. The organization has to match a name from the CfAPI. Example: <iframe src="" width="100%" height="600" frameBorder="0"></iframe>
  • labels: GitHub labels to filter the search by. Example: <iframe src=" wanted,enhancement" width="100%" height="600" frameBorder="0"></iframe>
  • number: The number of issues to show in the widget. Example: <iframe src="" width="100%" height="600" frameBorder="0"> </iframe>

Note: On Code for America sites, please include the tracking=false parameter, so that we don't double up on our Google Analytics page views.


The CFAPI is built on Flask and Python with a little bit of Javascript. The file describes the routes. The templates have the html. main.js helps out the embed form.

1. Add `SECRET` and `DATABASE_URL` variables to your environment.
2. Run `python`



Copyright (c) 2014-2015 Code for America.

civic-issue-finder open issues Ask a question     (View All Issues)
  • over 1 year Project link is broken
  • almost 2 years Issues should display language used
  • almost 2 years Closed issues shouldn't be displayed
  • almost 2 years Simplify widget css
  • almost 2 years Remove "layout-breve" class from widget template
  • over 2 years Clearly organize issues
  • over 2 years Redirect url to /brigade/issues
  • over 2 years README review
  • over 2 years Code Review
  • over 2 years Civic Issue Bot Turned Off
  • over 2 years Consider adding repo name and/or description with "badge"
  • almost 3 years Add test for single issue endpoint
  • almost 3 years Add project specific Issue Finder view
  • almost 3 years Add search to the Civic Issue FInder
  • almost 3 years Small screens result in large white space at bottom of frame
  • about 3 years Fix image vs. font asset loading order
  • over 3 years UTF8 Issues
  • over 3 years Embed remote header/footer content
  • over 3 years Finding the running app
  • over 3 years Add Repsitory as an optional filter
  • over 3 years Mobile menu overlaps title
civic-issue-finder open pull requests (View All Pulls)
  • Fix for issue #6
  • Featured issues
  • Added search for both label and body
civic-issue-finder list of languages used
Other projects in Python