added readme and helpers