diff --git a/lab-allan/.eslintignore b/lab-allan/.eslintignore
new file mode 100644
index 0000000..05b1cf3
--- /dev/null
+++ b/lab-allan/.eslintignore
@@ -0,0 +1,5 @@
+**/node_modules/*
+**/vendor/*
+**/*.min.js
+**/coverage/*
+**/build/*
diff --git a/lab-allan/.eslintrc b/lab-allan/.eslintrc
new file mode 100644
index 0000000..881053e
--- /dev/null
+++ b/lab-allan/.eslintrc
@@ -0,0 +1,33 @@
+{
+"rules": {
+"no-console": "off",
+"indent": [
+"error",
+2
+],
+"quotes": [
+"error",
+"single"
+],
+"semi": [
+"error",
+"always"
+],
+"linebreak-style": [
+"error",
+"unix"
+]
+},
+"env": {
+"es6": true,
+"node": true,
+"mocha": true,
+"jasmine": true
+},
+"ecmaFeatures": {
+"modules": true,
+"experimentalObjectRestSpread": true,
+"impliedStrict": true
+},
+"extends": "eslint:recommended"
+}
diff --git a/lab-allan/.gitignore b/lab-allan/.gitignore
new file mode 100644
index 0000000..345130c
--- /dev/null
+++ b/lab-allan/.gitignore
@@ -0,0 +1,136 @@
+# Created by https://www.gitignore.io/api/osx,vim,node,macos,windows
+
+### macOS ###
+*.DS_Store
+.AppleDouble
+.LSOverride
+
+# Icon must end with two \r
+Icon
+
+# Thumbnails
+._*
+
+# Files that might appear in the root of a volume
+.DocumentRevisions-V100
+.fseventsd
+.Spotlight-V100
+.TemporaryItems
+.Trashes
+.VolumeIcon.icns
+.com.apple.timemachine.donotpresent
+
+# Directories potentially created on remote AFP share
+.AppleDB
+.AppleDesktop
+Network Trash Folder
+Temporary Items
+.apdisk
+
+### Node ###
+# Logs
+logs
+*.log
+npm-debug.log*
+yarn-debug.log*
+yarn-error.log*
+
+# Runtime data
+pids
+*.pid
+*.seed
+*.pid.lock
+
+# Directory for instrumented libs generated by jscoverage/JSCover
+lib-cov
+
+# Coverage directory used by tools like istanbul
+coverage
+
+# nyc test coverage
+.nyc_output
+
+# Grunt intermediate storage (http://gruntjs.com/creating-plugins#storing-task-files)
+.grunt
+
+# Bower dependency directory (https://bower.io/)
+bower_components
+
+# node-waf configuration
+.lock-wscript
+
+# Compiled binary addons (http://nodejs.org/api/addons.html)
+build/Release
+
+# Dependency directories
+node_modules/
+jspm_packages/
+
+# Typescript v1 declaration files
+typings/
+
+# Optional npm cache directory
+.npm
+
+# Optional eslint cache
+.eslintcache
+
+# Optional REPL history
+.node_repl_history
+
+# Output of 'npm pack'
+*.tgz
+
+# Yarn Integrity file
+.yarn-integrity
+
+# dotenv environment variables file
+.env
+
+
+### OSX ###
+
+# Icon must end with two \r
+
+# Thumbnails
+
+# Files that might appear in the root of a volume
+
+# Directories potentially created on remote AFP share
+
+### Vim ###
+# swap
+[._]*.s[a-v][a-z]
+[._]*.sw[a-p]
+[._]s[a-v][a-z]
+[._]sw[a-p]
+# session
+Session.vim
+# temporary
+.netrwhist
+*~
+# auto-generated tag files
+tags
+
+### Windows ###
+# Windows thumbnail cache files
+Thumbs.db
+ehthumbs.db
+ehthumbs_vista.db
+
+# Folder config file
+Desktop.ini
+
+# Recycle Bin used on file shares
+$RECYCLE.BIN/
+
+# Windows Installer files
+*.cab
+*.msi
+*.msm
+*.msp
+
+# Windows shortcuts
+*.lnk
+
+# End of https://www.gitignore.io/api/osx,vim,node,macos,windows
diff --git a/lab-allan/README.md b/lab-allan/README.md
new file mode 100644
index 0000000..ec827da
--- /dev/null
+++ b/lab-allan/README.md
@@ -0,0 +1,15 @@
+## arithmetic.js
+- add function returns the sum of two numbers
+- sub function returns the difference of two numbers
+
+## greet.js
+- sayHello function returns 'hello' concatenated with a name argument
+- if the name argument is not a string, null is returned
+
+## arithmetic-test.js
+- tests that add and sub return the correct values when numbers are passed as arguments
+- tests that null is returned if any argument is not a number
+
+## greet-test.js
+- tests that the correct string is returned with the name argument
+- tests that null is returned if the argument is not a string
diff --git a/lab-allan/lib/arithmetic.js b/lab-allan/lib/arithmetic.js
new file mode 100644
index 0000000..65a283b
--- /dev/null
+++ b/lab-allan/lib/arithmetic.js
@@ -0,0 +1,15 @@
+'use strict';
+
+module.exports = exports = {};
+
+exports.add = function(first, second) {
+  if (isNaN(first) || isNaN(second))
+    return null;
+  return first + second;
+};
+
+exports.sub = function(first, second) {
+  if (isNaN(first) || isNaN(second))
+    return null;
+  return first - second;
+};
diff --git a/lab-allan/lib/greet.js b/lab-allan/lib/greet.js
new file mode 100644
index 0000000..f7ce0e2
--- /dev/null
+++ b/lab-allan/lib/greet.js
@@ -0,0 +1,11 @@
+'use strict';
+
+module.exports = exports = {};
+
+exports.sayHello = function(name) {
+  if (name.length === 0) throw new Error('no name');
+  if (typeof name !== 'string')
+    return null;
+
+  return `hello ${name}!`;
+};
diff --git a/lab-allan/test/arithmetic-test.js b/lab-allan/test/arithmetic-test.js
new file mode 100644
index 0000000..ad9fd8a
--- /dev/null
+++ b/lab-allan/test/arithmetic-test.js
@@ -0,0 +1,27 @@
+'use strict';
+
+const arithmetic = require('../lib/arithmetic.js');
+const assert = require('assert');
+
+describe('Arithmetic Module Test', function() {
+  describe('#add', function() {
+    it('should return 5', function() {
+      let result = arithmetic.add(3, 2);
+      assert.ok(result === 5, 'not equal to 5');
+    });
+    it('should return null', function() {
+      let result = arithmetic.add('word', 5);
+      assert.ok(result === null, 'null not returned');
+    });
+  });
+  describe('#sub', function() {
+    it('should return 1', function() {
+      let result = arithmetic.sub(3, 2);
+      assert.ok(result === 1, 'not equal to 1');
+    });
+    it('should return null', function() {
+      let result = arithmetic.sub('word', 50);
+      assert.ok(result === null, 'null not returned');
+    });
+  });
+});
diff --git a/lab-allan/test/greet-test.js b/lab-allan/test/greet-test.js
new file mode 100644
index 0000000..b8c0420
--- /dev/null
+++ b/lab-allan/test/greet-test.js
@@ -0,0 +1,17 @@
+'use strict';
+
+const greet = require('../lib/greet.js');
+const assert = require('assert');
+
+describe('Greet Module Test', function() {
+  describe('#sayHello', function() {
+    it('should return hello world!', function() {
+      let result = greet.sayHello('world');
+      assert.ok(result === 'hello world!', 'not equal to hello world!');
+    });
+    it('should return null', function() {
+      let result = greet.sayHello(5);
+      assert.ok(result === null, 'null not returned');
+    });
+  });
+});