# About :star:

I wanted to subscribe to the one and only *professional web design and development competition body* on the web.
Unfortunately they don't provide an RSS feed these days anymore or never have been. Although they tweet about
**sites and nominees** all day long, I'm by far no twitter user and got never used to it. So I thought, 
why not lemme fix all of that crap and create an [Awwwards.com](https://awwwards.com/) parser out of it?

## Install

`yarn add awwwards`

## Usage

Just gimme ma JSON, son!

```
import 'Awwwards' from 'awwwards';

let awwwards = new Awwwards();

awwwards.then((sites) => {

    console.log(sites);

}).catch((error) => {

    throw error;

});
```
There are also static wrapper methods for all the other awards, such as:

- `Awwwards.sites_of_the_day([query])`
- `Awwwards.sites_of_the_month([query])`
- `Awwwards.sites_of_the_year([query])`
- `Awwwards.honorable_mentions([query])`
- `Awwwards.mobile_excellence([query])`
- `Awwwards.developer([query])`
- `Awwwards.nominees([query])`

You can even use additional filters available on the [awwwards](https://www.awwwards.com/websites/) website:

```
let nominees = Awwwards.nominees({
    technology: 'bootstrap',
    category: 'sports',
    country: 'germany',
    color: 'blue',
    tag: 'vector'
});
```

## Example

If you just want to run the local webserver, adjust the index file to your needs an run the app like below.
This will provide the rss feeds for both, awwwards **winners and nominees**.

`npm run app`