better readme, refactored examples and boilerplate