An open API service indexing awesome lists of open source software.

https://github.com/hackoregon/archive-behindthecurtain


https://github.com/hackoregon/archive-behindthecurtain

Last synced: 6 months ago
JSON representation

Awesome Lists containing this project

README

          

# Welcome to the HackOregon front end app!

## Philosophy
The core Hack Oregon application is meant to expose answers to 4 main questions about campaign finance using open data:

- **who?** Who is being funded, and by which PACs, Corporations, and individuals.
- **what?** What are the outcomes of campaign finance dollars at work? (good or bad)
- **when?** When do cycles of campaign and funding take place and how does this effect the political process and civic life?
- **where?** What does the breakdown of donors/funders look like in Oregon and how does 'place' effect the political process?

Components for the core application lives at the top level of each directory. Additionally, in each folder there is a `community` folder for contributions that do not relate to the core application, but should exist on their own.

## Getting started
We're using yeoman for workflow.
```
#Install yeoman:
npm install -g yo
git clone
cd

#install node packages
npm install
```

Once everything is installed run:
`grunt serve`
to get your development server fired up.

## Getting acquainted with things
Hack Oregon's front end is contained in an [Angular JS app](http://angularjs.org).

Additionally, we are using [SASS](http://sass-lang.com/) which compiles into css and [coffeescript](http://coffeescript.org).

**Adding new styles:** add a partial to the styles folder e.g. `_mypartial.scss` and then include the partial in the `main.scss` file with an import statement `@import '_mypartial';` If you prefer to use plane css, simply import it by adding an import line to the `main.scss` file: `@import plainolcss.css;`

**Adding scripts:** Read about how to add to the angular application with the yeoman angular-generator [here](https://github.com/yeoman/generator-angular). Using angular generator you can add new routes, controllers, views, etc. with the simple commands listed in their [documentation](https://github.com/yeoman/generator-angular). For example,
`yo angular:route myAwesomeRoute`
This will create a new route, a new controller for that route, as well as an html view that will be rendered at that route. If you are a javascript purist, you can run the same command with a flag that tells the generator to use javascript. For example,
`yo angular:controller myAwesomeCtrl --coffee=false`

## Contributing
You probably have some amazing ideas, and things you'd like to contribute - we'd love to include them. Here's how:
```bash
# fork this repo
git clone
git checkout -b
git branch -D master
# hack away!
```