diff --git a/random-seed/random-seed-tests.ts b/random-seed/random-seed-tests.ts
new file mode 100644
index 0000000000..de49c65e45
--- /dev/null
+++ b/random-seed/random-seed-tests.ts
@@ -0,0 +1,18 @@
+/// <reference path="./random-seed.d.ts" />
+import { RandomSeed, create } from "random-seed";
+
+// these generators produce different numbers
+let rand1: RandomSeed = create(); // method 1
+
+// these generators will produce
+// the same sequence of numbers
+let seed = 'My Secret String Value';
+let rand2 = create(seed);
+
+// API
+rand1.addEntropy();
+rand1.random();
+rand1.range(100);
+rand1.intBetween(0, 10);
+rand1.floatBetween(0, 1);
+rand1.seed("new seed");
diff --git a/random-seed/random-seed.d.ts b/random-seed/random-seed.d.ts
new file mode 100644
index 0000000000..2dcb02d1e6
--- /dev/null
+++ b/random-seed/random-seed.d.ts
@@ -0,0 +1,28 @@
+// Type definitions for random-seed 0.3.0
+// Project: https://github.com/skratchdot/random-seed/
+// Definitions by: Endel Dreyer <https://github.com/endel>
+// Definitions: https://github.com/DefinitelyTyped/DefinitelyTyped
+
+declare module "random-seed" {
+
+  export interface RandomSeed {
+    range (range: number): number;
+    random (): number;
+    floatBetween (min: number, max: number): number;
+    intBetween (min: number, max: number): number;
+
+    string (count: number): string;
+    seed (seed: string): void;
+
+    cleanString (inStr: string): string;
+    hashString (inStr: string): string;
+
+    addEntropy (...args: any[]): void;
+    initState (): void;
+
+    done (): void;
+  }
+
+  export function create (seed?: string): RandomSeed;
+
+}