bugfixes, design notes, theme and example updates