diff --git a/randomcolor/randomcolor-tests.ts b/randomcolor/randomcolor-tests.ts
new file mode 100644
index 0000000000..9c72892e78
--- /dev/null
+++ b/randomcolor/randomcolor-tests.ts
@@ -0,0 +1,40 @@
+/// <reference path="randomcolor.d.ts" />
+
+// Returns a hex code for an attractive color
+randomColor();
+
+// Returns an array of ten green colors
+randomColor({
+    count: 10,
+    hue: 'green'
+});
+
+// Returns a hex code for a light blue
+randomColor({
+    luminosity: 'light',
+    hue: 'blue'
+});
+
+// Returns a hex code for a 'truly random' color
+randomColor({
+    luminosity: 'random',
+    hue: 'random'
+});
+
+// Returns a bright color in RGB
+randomColor({
+    luminosity: 'bright',
+    format: 'rgb' // e.g. 'rgb(225,200,20)'
+});
+
+// Returns a dark RGB color with random alpha
+randomColor({
+    luminosity: 'dark',
+    format: 'rgba' // e.g. 'rgba(9, 1, 107, 0.6482447960879654)'
+});
+
+// Returns a light HSL color with random alpha
+randomColor({
+    luminosity: 'light',
+    format: 'hsla' // e.g. 'hsla(27, 88.99%, 81.83%, 0.6450211517512798)'
+});
\ No newline at end of file
diff --git a/randomcolor/randomcolor.d.ts b/randomcolor/randomcolor.d.ts
new file mode 100644
index 0000000000..1886e38a09
--- /dev/null
+++ b/randomcolor/randomcolor.d.ts
@@ -0,0 +1,14 @@
+// Type definitions for randomColor 0.4.1
+// Project: https://github.com/davidmerfield/randomColor
+// Definitions by: Mathias Feitzinger <https://github.com/feitzi>
+// Definitions: https://github.com/DefinitelyTyped/DefinitelyTyped
+
+declare function randomColor(options?: RandomColorOptions): string;
+
+interface RandomColorOptions {
+	hue?: number | "red" | "orange" | "yellow" | "green" | "blue" | "purple" | "pink" | "monochrome" | "random";
+	luminosity?: "bright" | "light" | "dark" | "random";
+	count?: number;
+	seed?: number | string;
+	format?: "hsvArray" | "hslArray" | "hsl" | "hsla" | "rgbArray" | "rgb" | "rgba" | "hex";
+}
\ No newline at end of file