expand public api docs, tests for custom colors