diff --git a/CHANGELOG.md b/CHANGELOG.md
index e8c1f5fc..196237af 100644
--- a/CHANGELOG.md
+++ b/CHANGELOG.md
@@ -4,6 +4,10 @@
 
 - Test strict Front Matter in `/test` site. [#1236](https://github.com/mmistakes/minimal-mistakes/pull/1236)
 - Rename `gems` key to `plugins`. [#1239](https://github.com/mmistakes/minimal-mistakes/pull/1239)
+- Add [YIQ Color Contrast](https://github.com/easy-designs/yiq-color-contrast) mixin for determining lightness of a color.
+- DRY up button CSS using Sass lists and YIQ Color Contrast mixin.
+- Add `btn--primary` button class. **Note:** elements that were previously using only a `.btn` class will now also need `.btn--primary` (eg. `<a class="btn btn--primary" href="#">my link</a>`).
+- Add `air`, `contrast`, `dark`, `dirt`, `mint`, and `sunrise` skin color options. [#1208](https://github.com/mmistakes/minimal-mistakes/issues/1208)
 
 ## [4.5.2](https://github.com/mmistakes/minimal-mistakes/releases/tag/4.5.2)
 
@@ -27,7 +31,7 @@
 - Reduce amount of blank pages when printing in Chrome. [#1196](https://github.com/mmistakes/minimal-mistakes/issues/1196)
 - Remove `#disqus_thread` duplicate  from `comments-providers/disqus.html` as it is already in `comments.html` include. [#1199](https://github.com/mmistakes/minimal-mistakes/issues/1199)
 - Fix Liquid syntax errors in `tag-list.html` and `category-list.html` includes by removing parenthesis in `assign`s. [#1223](https://github.com/mmistakes/minimal-mistakes/issues/1223)
-- Fix Liquid syntax error: "Expected id but found open_square in `"{{page.[include.id] }}"`" in `gallery` and `feature_row` includes.
+- Fix Liquid syntax error: "Expected id but found open_square in `"{{ page.[include.id] }}"`" in `gallery` and `feature_row` includes.
 - Fix Liquid syntax error: "Expected end_of_string but found pipe in `"name in __names | sort"`" in `group-by-array` include.
 
 ## [4.5.1](https://github.com/mmistakes/minimal-mistakes/releases/tag/4.5.1)
diff --git a/_config.yml b/_config.yml
index 4746534e..141be417 100644
--- a/_config.yml
+++ b/_config.yml
@@ -5,6 +5,8 @@
 # For technical reasons, this file is *NOT* reloaded automatically when you use
 # `jekyll serve`. If you change this file, please restart the server process.
 
+minimal_mistakes_skin    : "default" # "air", "contrast", "dark", "dirt", "mint", "sunrise"
+
 # Site Settings
 locale                   : "en"
 title                    : "Site Title"
diff --git a/_includes/comments.html b/_includes/comments.html
index 1df73b3d..332374ee 100644
--- a/_includes/comments.html
+++ b/_includes/comments.html
@@ -84,7 +84,7 @@
                 </p>
                 <!-- End comment form alert messaging -->
                 <fieldset>
-                  <button type="submit" id="comment-form-submit" tabindex="5" class="btn btn--large">{{ site.data.ui-text[site.locale].comment_btn_submit | default: "Submit Comment" }}</button>
+                  <button type="submit" id="comment-form-submit" tabindex="5" class="btn btn--primary btn--large">{{ site.data.ui-text[site.locale].comment_btn_submit | default: "Submit Comment" }}</button>
                 </fieldset>
               </form>
             </div>
@@ -94,4 +94,4 @@
       {% when "custom" %}
         <section id="custom-comments"></section>
   {% endcase %}
-</div>
+</div>
\ No newline at end of file
diff --git a/_layouts/single.html b/_layouts/single.html
index 7d327352..4a297941 100644
--- a/_layouts/single.html
+++ b/_layouts/single.html
@@ -35,7 +35,7 @@ layout: default
 
       <section class="page__content" itemprop="text">
         {{ content }}
-        {% if page.link %}<div><a href="{{ page.link }}" class="btn">{{ site.data.ui-text[site.locale].ext_link_label | default: "Direct Link" }}</a></div>{% endif %}
+        {% if page.link %}<div><a href="{{ page.link }}" class="btn btn--primary">{{ site.data.ui-text[site.locale].ext_link_label | default: "Direct Link" }}</a></div>{% endif %}
       </section>
 
       <footer class="page__meta">
diff --git a/_sass/minimal-mistakes/_archive.scss b/_sass/minimal-mistakes/_archive.scss
index d6ab5f66..70cb116e 100644
--- a/_sass/minimal-mistakes/_archive.scss
+++ b/_sass/minimal-mistakes/_archive.scss
@@ -26,7 +26,7 @@
   margin: 1.414em 0 0;
   padding-bottom: 0.5em;
   font-size: $type-size-5;
-  color: mix(#fff, $gray, 25%);
+  color: $muted-text-color;
   border-bottom: 1px solid $border-color;
 
   + .list__item .archive__item-title {
@@ -72,6 +72,7 @@
 }
 
 .archive__item:hover {
+
   .archive__item-teaser {
     box-shadow: 0 0 10px rgba(#000, 0.25);
   }
diff --git a/_sass/minimal-mistakes/_base.scss b/_sass/minimal-mistakes/_base.scss
index c5311a29..d9f7df30 100644
--- a/_sass/minimal-mistakes/_base.scss
+++ b/_sass/minimal-mistakes/_base.scss
@@ -118,8 +118,13 @@ a {
 
   &:hover,
   &:active {
+    color: $link-color-hover;
     outline: 0;
   }
+
+  &:visited {
+    color: $link-color-visited;
+  }
 }
 
 /* code */
@@ -141,7 +146,7 @@ td > code {
   padding-bottom: 0.1rem;
   font-size: $type-size-6;
   background: $code-background-color;
-  border: 1px solid $lighter-gray;
+  border: 1px solid $border-color;
   border-radius: $border-radius;
   box-shadow: $box-shadow;
 
@@ -236,20 +241,16 @@ figure {
 
 figcaption {
   margin-bottom: 0.5em;
-  color: mix(#fff, $text-color, 25%);
+  color: $muted-text-color;
   font-family: $caption-font-family;
   font-size: $type-size-6;
 
   a {
-    color: inherit;
-    text-decoration: none;
-    border-bottom: 1px solid $light-gray;
     -webkit-transition: $global-transition;
     transition: $global-transition;
 
     &:hover {
-      color: #000;
-      border-bottom-color: #000;
+      color: $link-color-hover;
     }
   }
 }
diff --git a/_sass/minimal-mistakes/_buttons.scss b/_sass/minimal-mistakes/_buttons.scss
index d6cf90ea..6027eac7 100644
--- a/_sass/minimal-mistakes/_buttons.scss
+++ b/_sass/minimal-mistakes/_buttons.scss
@@ -7,25 +7,19 @@
    ========================================================================== */
 
 .btn {
-  /* default button */
+  /* default */
   display: inline-block;
   margin-bottom: 0.25em;
   padding: 0.5em 1em;
-  color: #fff !important;
   font-family: $sans-serif;
   font-size: $type-size-6;
   font-weight: bold;
   text-align: center;
   text-decoration: none;
-  background-color: $primary-color;
-  border: 0 !important;
+  border-width: 0;
   border-radius: $border-radius;
   cursor: pointer;
 
-  &:hover {
-    background-color: mix(white, #000, 20%);
-  }
-
   .icon {
     margin-right: 0.5em;
   }
@@ -34,8 +28,41 @@
     margin-left: -0.5em; /* override for hidden text*/
   }
 
-  /* fills width of parent container */
+  /* button colors */
+  $buttoncolors:
+  (primary, $primary-color),
+  (inverse, #fff),
+  (light-outline, transparent),
+  (success, $success-color),
+  (warning, $warning-color),
+  (danger, $danger-color),
+  (info, $info-color),
+  (facebook, $facebook-color),
+  (twitter, $twitter-color),
+  (google-plus, $google-plus-color),
+  (linkedin, $linkedin-color);
 
+  @each $buttoncolor, $color in $buttoncolors {
+    &--#{$buttoncolor} {
+      @include yiq-contrasted($color);
+      @if ($buttoncolor == inverse) {
+        border: 1px solid $border-color;
+      }
+      @if ($buttoncolor == light-outline) {
+        border: 1px solid #fff;
+      }
+
+      &:hover {
+        @include yiq-contrasted(mix(#000, $color, 20%));
+      }
+
+      &:visited {
+        @include yiq-contrasted($color);
+      }
+    }
+  }
+
+  /* fills width of parent container */
   &--block {
     display: block;
     width: 100%;
@@ -45,68 +72,7 @@
     }
   }
 
-  /* for dark backgrounds */
-
-  &--inverse {
-    color: $gray !important;
-    border: 1px solid $light-gray !important; /* override*/
-    background-color: #fff;
-
-    &:hover {
-      color: #fff !important;
-      border-color: $gray;
-    }
-  }
-
-  /* light outline */
-
-  &--light-outline {
-    border: 1px solid #fff !important; /* override*/
-    background-color: transparent;
-  }
-
-  /* information */
-
-  &--info {
-    background-color: $info-color;
-
-    &:hover {
-      background-color: mix(#000, $info-color, 20%);
-    }
-  }
-
-  /* warning */
-
-  &--warning {
-    background-color: $warning-color;
-
-    &:hover {
-      background-color: mix(#000, $warning-color, 20%);
-    }
-  }
-
-  /* success */
-
-  &--success {
-    background-color: $success-color;
-
-    &:hover {
-      background-color: mix(#000, $success-color, 20%);
-    }
-  }
-
-  /* danger */
-
-  &--danger {
-    background-color: $danger-color;
-
-    &:hover {
-      background-color: mix(#000, $danger-color, 20%);
-    }
-  }
-
   /* disabled */
-
   &--disabled {
     pointer-events: none;
     cursor: not-allowed;
@@ -115,38 +81,17 @@
     opacity: 0.65;
   }
 
-  /* social buttons */
-
-  $social:
-  (facebook, $facebook-color),
-  (twitter, $twitter-color),
-  (google-plus, $google-plus-color),
-  (linkedin, $linkedin-color);
-
-  @each $socialnetwork, $color in $social {
-    &--#{$socialnetwork} {
-      background-color: $color;
-
-      &:hover {
-        background-color: mix(#000, $color, 20%);
-      }
-    }
-  }
-
   /* extra large button */
-
   &--x-large {
     font-size: $type-size-4;
   }
 
   /* large button */
-
   &--large {
     font-size: $type-size-5;
   }
 
   /* small button */
-
   &--small {
     font-size: $type-size-7;
   }
diff --git a/_sass/minimal-mistakes/_footer.scss b/_sass/minimal-mistakes/_footer.scss
index 9e2b5d2f..3b3ddd31 100644
--- a/_sass/minimal-mistakes/_footer.scss
+++ b/_sass/minimal-mistakes/_footer.scss
@@ -15,13 +15,12 @@
   height: auto;
   /* sticky footer fix end */
   margin-top: 3em;
-  color: mix(#fff, $gray, 25%);
+  color: $muted-text-color;
   -webkit-animation: $intro-transition;
           animation: $intro-transition;
   -webkit-animation-delay: 0.45s;
           animation-delay: 0.45s;
-  background-color: $lighter-gray;
-  border-top: 1px solid $light-gray;
+  background-color: $footer-background-color;
 
   footer {
     @include clearfix;
@@ -46,7 +45,7 @@
   }
 
   .fa {
-    color: mix(#fff, $gray, 25%);
+    color: $muted-text-color;
   }
 }
 
diff --git a/_sass/minimal-mistakes/_forms.scss b/_sass/minimal-mistakes/_forms.scss
index a1f0f146..dc521319 100644
--- a/_sass/minimal-mistakes/_forms.scss
+++ b/_sass/minimal-mistakes/_forms.scss
@@ -4,6 +4,8 @@
 
 form {
   margin: 0 0 5px 0;
+  padding: 1em;
+  background-color: $form-background-color;
 
   fieldset {
     margin-bottom: 5px;
@@ -19,7 +21,6 @@ form {
     padding: 0;
     color: $text-color;
     border: 0;
-    border-bottom: 1px solid mix(#fff, #000, 80%);
     white-space: normal;
   }
 
@@ -80,14 +81,10 @@ select {
   padding: 0.25em;
   margin-bottom: 0.5em;
   color: $text-color;
-  background-color: #fff;
-  border: 1px solid mix(#fff, #000, 80%);
+  background-color: $background-color;
+  border: $border-color;
   border-radius: $border-radius;
   box-shadow: $box-shadow;
-
-  &:hover {
-    border-color: mix(#fff, $primary-color, 50%);
-  }
 }
 
 .input-mini {
@@ -224,6 +221,7 @@ textarea:focus {
   border-color: $primary-color;
   outline: 0;
   outline: thin dotted \9;
+  box-shadow: inset 0 1px 3px rgba($text-color, 0.06), 0 0 5px rgba($primary-color, 0.7);
 }
 
 input[type="file"]:focus,
@@ -240,7 +238,7 @@ select:focus {
 
 .help-block,
 .help-inline {
-  color: $info-color;
+  color: $muted-text-color;
 }
 
 .help-block {
@@ -382,7 +380,7 @@ select:focus {
   color: #000;
   border-width: 2px !important;
   border-style: solid !important;
-  border-color: lighten(#000,50);
+  border-color: $border-color;
   border-radius: $border-radius;
 }
 
diff --git a/_sass/minimal-mistakes/_mixins.scss b/_sass/minimal-mistakes/_mixins.scss
index 14782b19..1d221fc8 100644
--- a/_sass/minimal-mistakes/_mixins.scss
+++ b/_sass/minimal-mistakes/_mixins.scss
@@ -50,4 +50,43 @@
     content: "";
     display: table;
   }
+}
+
+/*
+   Compass YIQ Color Contrast
+   https://github.com/easy-designs/yiq-color-contrast
+   ========================================================================== */
+
+@function yiq-is-light(
+  $color,
+  $threshold: $yiq-contrasted-threshold
+) {
+  $red: red($color);
+  $green: green($color);
+  $blue: blue($color);
+
+  $yiq: (($red*299)+($green*587)+($blue*114))/1000;
+
+  @if $yiq-debug { @debug $yiq, $threshold; }
+
+  @return if($yiq >= $threshold, true, false);
+}
+
+@function yiq-contrast-color(
+  $color,
+  $dark: $yiq-contrasted-dark-default,
+  $light: $yiq-contrasted-light-default,
+  $threshold: $yiq-contrasted-threshold
+) {
+  @return if(yiq-is-light($color, $threshold), $yiq-contrasted-dark-default, $yiq-contrasted-light-default);
+}
+
+@mixin yiq-contrasted(
+  $background-color,
+  $dark: $yiq-contrasted-dark-default,
+  $light: $yiq-contrasted-light-default,
+  $threshold: $yiq-contrasted-threshold
+) {
+  background-color: $background-color;
+  color: yiq-contrast-color($background-color, $dark, $light, $threshold);
 }
\ No newline at end of file
diff --git a/_sass/minimal-mistakes/_navigation.scss b/_sass/minimal-mistakes/_navigation.scss
index 74730ec9..d9bcc971 100644
--- a/_sass/minimal-mistakes/_navigation.scss
+++ b/_sass/minimal-mistakes/_navigation.scss
@@ -6,369 +6,382 @@
    Breadcrumb navigation links
    ========================================================================== */
 
-.breadcrumbs {
-  @include clearfix;
-  margin: 0 auto;
-  max-width: 100%;
-  padding-left: 2em;
-  padding-right: 2em;
-  font-family: $sans-serif;
-  -webkit-animation: $intro-transition;
-          animation: $intro-transition;
-  -webkit-animation-delay: 0.30s;
-          animation-delay: 0.30s;
-
-  @include breakpoint($large) {
-    padding-left: 1em;
-    padding-right: 1em;
-  }
-
-  @include breakpoint($x-large) {
-    max-width: $x-large;
-  }
-
-  ol {
-    padding: 0;
-    list-style: none;
-    font-size: $type-size-6;
+   .breadcrumbs {
+    @include clearfix;
+    margin: 0 auto;
+    max-width: 100%;
+    padding-left: 2em;
+    padding-right: 2em;
+    font-family: $sans-serif;
+    -webkit-animation: $intro-transition;
+            animation: $intro-transition;
+    -webkit-animation-delay: 0.30s;
+            animation-delay: 0.30s;
 
     @include breakpoint($large) {
-      float: right;
-      width: span(10 of 12);
+      padding-left: 1em;
+      padding-right: 1em;
     }
 
     @include breakpoint($x-large) {
-      padding-left: gutter(0.5 of 12);
+      max-width: $x-large;
     }
-  }
 
-  li {
-    display: inline;
-  }
+    ol {
+      padding: 0;
+      list-style: none;
+      font-size: $type-size-6;
 
-  .current {
-    font-weight: bold;
-  }
-}
-
-
-/*
-   Post pagination navigation links
-   ========================================================================== */
-
-.pagination {
-  @include clearfix();
-  float: left;
-  margin-top: 1em;
-  padding-top: 1em;
-  width: 100%;
-
-  ul {
-    margin: 0;
-    padding: 0;
-    list-style-type: none;
-    font-family: $sans-serif;
-  }
-
-  li {
-    display: block;
-    float: left;
-    margin-left: -1px;
-
-    a {
-      display: block;
-      margin-bottom: 0.25em;
-      padding: 0.5em 1em;
-      font-family: $sans-serif;
-      font-size: 14px;
-      font-weight: bold;
-      line-height: 1.5;
-      text-align: center;
-      text-decoration: none;
-      color: mix(#fff, $gray, 25%);
-      border: 1px solid $light-gray;
-      border-radius: 0;
-
-      &:hover {
-        color: $link-color-hover;
+      @include breakpoint($large) {
+        float: right;
+        width: span(10 of 12);
       }
 
-      &.current {
-        color: #fff;
-        background: $primary-color;
-      }
-
-      &.disabled {
-        color: mix(#fff, $gray, 75%);
-        pointer-events: none;
-        cursor: not-allowed;
+      @include breakpoint($x-large) {
+        padding-left: gutter(0.5 of 12);
       }
     }
 
-    &:first-child {
-      margin-left: 0;
-
-      a {
-        border-top-left-radius: $border-radius;
-        border-bottom-left-radius: $border-radius;
-      }
-    }
-
-    &:last-child {
-      a {
-        border-top-right-radius: $border-radius;
-        border-bottom-right-radius: $border-radius;
-      }
-    }
-  }
-
-  /* next/previous buttons */
-  &--pager {
-    display: block;
-    padding: 1em 2em;
-    float: left;
-    width: 50%;
-    font-family: $sans-serif;
-    font-size: $type-size-5;
-    font-weight: bold;
-    text-align: center;
-    text-decoration: none;
-    color: $link-color;
-    border: 1px solid $light-gray;
-    border-radius: $border-radius;
-
-    &:hover {
-      color: $link-color-hover;
-    }
-
-    &:first-child {
-      border-top-right-radius: 0;
-      border-bottom-right-radius: 0;
-    }
-
-    &:last-child {
-      margin-left: -1px;
-      border-top-left-radius: 0;
-      border-bottom-left-radius: 0;
-    }
-
-    &.disabled {
-      color: mix(#fff, $gray, 75%);
-      pointer-events: none;
-      cursor: not-allowed;
-    }
-  }
-}
-
-.page__content + .pagination,
-.page__meta + .pagination,
-.page__share + .pagination,
-.page__comments + .pagination {
-  margin-top: 2em;
-  padding-top: 2em;
-  border-top: 1px solid $border-color;
-}
-
-
-/*
-   Priority plus navigation
-   ========================================================================== */
-
-.greedy-nav {
-  position: relative;
-  display: -webkit-box;
-  display: flex;
-  -webkit-box-align: center;
-        align-items: center;
-  background: $background-color;
-
-  a {
-    display: block;
-    margin: 0 1rem;
-    padding: 0.5rem 0;
-    color: $masthead-link-color;
-    text-decoration: none;
-
-    &:hover {
-      color: $masthead-link-color-hover;
-    }
-
-    &.site-title {
-      margin-left: 0;
-    }
-  }
-
-  button {
-    padding: 0 0.5rem;
-    align-self: stretch;
-    border: 0;
-    outline: none;
-    color: #fff;
-    background-color: $primary-color;
-    cursor: pointer;
-  }
-
-  .visible-links {
-    display: -webkit-box;
-    display: flex;
-    -webkit-box-pack: end;
-     justify-content: flex-end;
-    -webkit-box-flex: 1;
-                flex: 1;
-    padding-right: 2rem;
-    overflow: hidden;
-
     li {
-      -webkit-box-flex: 0;
-                  flex: none;
+      display: inline;
+    }
+
+    .current {
+      font-weight: bold;
+    }
+  }
+
+
+  /*
+     Post pagination navigation links
+     ========================================================================== */
+
+  .pagination {
+    @include clearfix();
+    float: left;
+    margin-top: 1em;
+    padding-top: 1em;
+    width: 100%;
+
+    ul {
+      margin: 0;
+      padding: 0;
+      list-style-type: none;
+      font-family: $sans-serif;
+    }
+
+    li {
+      display: block;
+      float: left;
+      margin-left: -1px;
+
+      a {
+        display: block;
+        margin-bottom: 0.25em;
+        padding: 0.5em 1em;
+        font-family: $sans-serif;
+        font-size: 14px;
+        font-weight: bold;
+        line-height: 1.5;
+        text-align: center;
+        text-decoration: none;
+        color: $muted-text-color;
+        border: 1px solid mix(#000, $border-color, 25%);
+        border-radius: 0;
+
+        &:hover {
+          color: $link-color-hover;
+        }
+
+        &.current,
+        &.current.disabled {
+          color: #fff;
+          background: $primary-color;
+        }
+
+        &.disabled {
+          color: rgba($muted-text-color, 0.5);
+          pointer-events: none;
+          cursor: not-allowed;
+        }
+      }
+
+      &:first-child {
+        margin-left: 0;
+
+        a {
+          border-top-left-radius: $border-radius;
+          border-bottom-left-radius: $border-radius;
+        }
+      }
 
       &:last-child {
         a {
-          margin-right: 0;
+          border-top-right-radius: $border-radius;
+          border-bottom-right-radius: $border-radius;
         }
       }
     }
 
+    /* next/previous buttons */
+    &--pager {
+      display: block;
+      padding: 1em 2em;
+      float: left;
+      width: 50%;
+      font-family: $sans-serif;
+      font-size: $type-size-5;
+      font-weight: bold;
+      text-align: center;
+      text-decoration: none;
+      color: $muted-text-color;
+      border: 1px solid mix(#000, $border-color, 25%);
+      border-radius: $border-radius;
+
+      &:hover {
+        @include yiq-contrasted($muted-text-color);
+      }
+
+      &:first-child {
+        border-top-right-radius: 0;
+        border-bottom-right-radius: 0;
+      }
+
+      &:last-child {
+        margin-left: -1px;
+        border-top-left-radius: 0;
+        border-bottom-left-radius: 0;
+      }
+
+      &.disabled {
+        color: rgba($muted-text-color, 0.5);
+        pointer-events: none;
+        cursor: not-allowed;
+      }
+    }
+  }
+
+  .page__content + .pagination,
+  .page__meta + .pagination,
+  .page__share + .pagination,
+  .page__comments + .pagination {
+    margin-top: 2em;
+    padding-top: 2em;
+    border-top: 1px solid $border-color;
+  }
+
+
+  /*
+     Priority plus navigation
+     ========================================================================== */
+
+  .greedy-nav {
+    position: relative;
+    display: -webkit-box;
+    display: flex;
+    -webkit-box-align: center;
+          align-items: center;
+    background: $background-color;
+
     a {
-      position: relative;
+      display: block;
+      margin: 0 1rem;
+      padding: 0.5rem 0;
+      color: $masthead-link-color;
+      text-decoration: none;
+
+      &:hover {
+        color: $masthead-link-color-hover;
+      }
+
+      &.site-title {
+        margin-left: 0;
+      }
+    }
+
+    button {
+      padding: 0 0.5rem;
+      align-self: stretch;
+      border: 0;
+      outline: none;
+      color: #fff;
+      background-color: $primary-color;
+      cursor: pointer;
+    }
+
+    .visible-links {
+      display: -webkit-box;
+      display: flex;
+      -webkit-box-pack: end;
+       justify-content: flex-end;
+      -webkit-box-flex: 1;
+                  flex: 1;
+      padding-right: 2rem;
+      overflow: hidden;
+
+      li {
+        -webkit-box-flex: 0;
+                    flex: none;
+
+        &:last-child {
+          a {
+            margin-right: 0;
+          }
+        }
+      }
+
+      a {
+        position: relative;
+
+        &:before {
+          content: "";
+          position: absolute;
+          left: 0;
+          bottom: 0;
+          height: 4px;
+          background: $primary-color;
+          width: 100%;
+          -webkit-transition: $global-transition;
+          transition: $global-transition;
+          -webkit-transform: scaleX(0) translate3d(0, 0 , 0);
+                  transform: scaleX(0) translate3d(0, 0 , 0); /* hide*/
+        }
+
+        &:hover:before {
+          -webkit-transform: scaleX(1);
+                  -ms-transform: scaleX(1);
+              transform: scaleX(1); /* reveal*/
+        }
+      }
+    }
+
+    .hidden-links {
+      position: absolute;
+      top: 100%;
+      right: 0;
+      margin-top: 15px;
+      padding: 5px;
+      border: 1px solid $border-color;
+      border-radius: $border-radius;
+      background: $background-color;
+      box-shadow: 0 2px 4px 0 rgba(#000, 0.16), 0 2px 10px 0 rgba(#000, 0.12);
+
+      &.hidden {
+        display: none;
+      }
+
+      a {
+        margin: 0;
+        padding: 10px 20px;
+        font-size: $type-size-5;
+
+        &:hover {
+          color: $masthead-link-color-hover;
+          background: $navicon-link-color-hover;
+        }
+      }
 
       &:before {
         content: "";
         position: absolute;
-        left: 0;
-        bottom: 0;
-        height: 4px;
-        background: mix(#fff, $primary-color, 50%);
-        width: 100%;
-        -webkit-transition: $global-transition;
-        transition: $global-transition;
-        -webkit-transform: scaleX(0) translate3d(0, 0 , 0);
-                transform: scaleX(0) translate3d(0, 0 , 0); /* hide*/
+        top: -11px;
+        right: 10px;
+        width: 0;
+        border-style: solid;
+        border-width: 0 10px 10px;
+        border-color: $border-color transparent;
+        display: block;
+        z-index: 0;
       }
 
-      &:hover:before {
-        -webkit-transform: scaleX(1);
-                -ms-transform: scaleX(1);
-            transform: scaleX(1); /* reveal*/
+      &:after {
+        content: "";
+        position: absolute;
+        top: -10px;
+        right: 10px;
+        width: 0;
+        border-style: solid;
+        border-width: 0 10px 10px;
+        border-color: $background-color transparent;
+        display: block;
+        z-index: 1;
+      }
+
+      li {
+        display: block;
+        border-bottom: 1px solid $border-color;
+
+        &:last-child {
+          border-bottom: none;
+        }
       }
     }
   }
 
-  .hidden-links {
-    position: absolute;
-    top: 100%;
-    right: 0;
-    margin-top: 15px;
-    padding: 5px;
-    border: 1px solid $border-color;
-    border-radius: $border-radius;
-    background: #fff;
-    box-shadow: 0 2px 4px 0 rgba(#000, 0.16), 0 2px 10px 0 rgba(#000, 0.12);
 
-    &.hidden {
+  /*
+     Navigation list
+     ========================================================================== */
+
+  .nav__list {
+    margin-bottom: 1.5em;
+
+    input[type="checkbox"],
+    label {
       display: none;
     }
 
-    a {
-      margin: 0;
-      padding: 10px 20px;
-      font-size: $type-size-5;
+    @include breakpoint(max-width ($large - 1px)) {
 
-      &:hover {
-        color: $masthead-link-color-hover;
-        background: $navicon-link-color-hover;
-      }
-    }
-
-    &:before {
-      content: "";
-      position: absolute;
-      top: -11px;
-      right: 10px;
-      width: 0;
-      border-style: solid;
-      border-width: 0 10px 10px;
-      border-color: $border-color transparent;
-      display: block;
-      z-index: 0;
-    }
-
-    &:after {
-      content: "";
-      position: absolute;
-      top: -10px;
-      right: 10px;
-      width: 0;
-      border-style: solid;
-      border-width: 0 10px 10px;
-      border-color: #fff transparent;
-      display: block;
-      z-index: 1;
-    }
-
-    li {
-      display: block;
-      border-bottom: 1px solid $border-color;
-
-      &:last-child {
-        border-bottom: none;
-      }
-    }
-  }
-}
-
-
-/*
-   Navigation list
-   ========================================================================== */
-
-.nav__list {
-  margin-bottom: 1.5em;
-
-  input[type="checkbox"],
-  label {
-    display: none;
-  }
-
-  @include breakpoint(max-width ($large - 1px)) {
-
-    label {
-      position: relative;
-      display: inline-block;
-      padding: 0.5em 2.5em 0.5em 1em;
-      color: $gray;
-      font-size: $type-size-6;
-      font-weight: bold;
-      border: 1px solid $light-gray;
-      border-radius: $border-radius;
-      z-index: 20;
-      -webkit-transition: 0.2s ease-out;
-      transition: 0.2s ease-out;
-      cursor: pointer;
-
-      &:before,
-      &:after {
-        content: '';
-        position: absolute;
-        right: 1em;
-        top: 1.25em;
-        width: 0.75em;
-        height: 0.125em;
-        line-height: 1;
-        background-color: $gray;
+      label {
+        position: relative;
+        display: inline-block;
+        padding: 0.5em 2.5em 0.5em 1em;
+        color: $gray;
+        font-size: $type-size-6;
+        font-weight: bold;
+        border: 1px solid $light-gray;
+        border-radius: $border-radius;
+        z-index: 20;
         -webkit-transition: 0.2s ease-out;
         transition: 0.2s ease-out;
+        cursor: pointer;
+
+        &:before,
+        &:after {
+          content: '';
+          position: absolute;
+          right: 1em;
+          top: 1.25em;
+          width: 0.75em;
+          height: 0.125em;
+          line-height: 1;
+          background-color: $gray;
+          -webkit-transition: 0.2s ease-out;
+          transition: 0.2s ease-out;
+        }
+
+        &:after {
+          -webkit-transform: rotate(90deg);
+                  -ms-transform: rotate(90deg);
+              transform: rotate(90deg);
+        }
+
+        &:hover {
+          color: #fff;
+          border-color: $gray;
+          background-color: mix(white, #000, 20%);
+
+          &:before,
+          &:after {
+            background-color: #fff;
+          }
+        }
       }
 
-      &:after {
-        -webkit-transform: rotate(90deg);
-                -ms-transform: rotate(90deg);
-            transform: rotate(90deg);
-      }
-
-      &:hover {
-        color: #fff;
-        border-color: $gray;
+      /* selected*/
+      input:checked + label {
+        color: white;
         background-color: mix(white, #000, 20%);
 
         &:before,
@@ -376,177 +389,164 @@
           background-color: #fff;
         }
       }
-    }
 
-    /* selected*/
-    input:checked + label {
-      color: white;
-      background-color: mix(white, #000, 20%);
+      /* on hover show expand*/
+      label:hover:after {
+        -webkit-transform: rotate(90deg);
+                -ms-transform: rotate(90deg);
+            transform: rotate(90deg);
+      }
 
-      &:before,
-      &:after {
-        background-color: #fff;
+      input:checked + label:hover:after {
+        -webkit-transform: rotate(0);
+                -ms-transform: rotate(0);
+            transform: rotate(0);
+      }
+
+      ul {
+        margin-bottom: 1em;
+      }
+
+      a {
+        display: block;
+        padding: 0.25em 0;
+
+        @include breakpoint($large) {
+          padding-top: 0.125em;
+          padding-bottom: 0.125em;
+        }
+
+        &:hover {
+          text-decoration: underline;
+        }
       }
     }
+  }
 
-    /* on hover show expand*/
-    label:hover:after {
-      -webkit-transform: rotate(90deg);
-              -ms-transform: rotate(90deg);
-          transform: rotate(90deg);
-    }
-
-    input:checked + label:hover:after {
-      -webkit-transform: rotate(0);
-              -ms-transform: rotate(0);
-          transform: rotate(0);
-    }
-
-    ul {
-      margin-bottom: 1em;
-    }
+  .nav__list .nav__items {
+    margin: 0;
+    font-size: 1.25rem;
 
     a {
-      display: block;
-      padding: 0.25em 0;
-
-      @include breakpoint($large) {
-        padding-top: 0.125em;
-        padding-bottom: 0.125em;
-      }
-
-      &:hover {
-        text-decoration: underline;
-      }
+      color: inherit;
     }
-  }
-}
 
-.nav__list .nav__items {
-  margin: 0;
-  font-size: 1.25rem;
+    .active {
+      margin-left: -0.5em;
+      padding-left: 0.5em;
+      padding-right: 0.5em;
+      font-weight: bold;
+    }
 
-  a {
-    color: inherit;
-  }
-
-  .active {
-    margin-left: -0.5em;
-    padding-left: 0.5em;
-    padding-right: 0.5em;
-    font-weight: bold;
+    @include breakpoint(max-width ($large - 1px)) {
+      position: relative;
+      max-height: 0;
+      opacity: 0%;
+      overflow: hidden;
+      z-index: 10;
+      -webkit-transition: 0.3s ease-in-out;
+      transition: 0.3s ease-in-out;
+      -webkit-transform: translate(0, 10%);
+              -ms-transform: translate(0, 10%);
+          transform: translate(0, 10%);
+    }
   }
 
   @include breakpoint(max-width ($large - 1px)) {
-    position: relative;
-    max-height: 0;
-    opacity: 0%;
-    overflow: hidden;
-    z-index: 10;
-    -webkit-transition: 0.3s ease-in-out;
-    transition: 0.3s ease-in-out;
-    -webkit-transform: translate(0, 10%);
-            -ms-transform: translate(0, 10%);
-        transform: translate(0, 10%);
+    .nav__list input:checked ~ .nav__items {
+      -webkit-transition: 0.5s ease-in-out;
+      transition: 0.5s ease-in-out;
+      max-height: 9999px; /* exaggerate max-height to accommodate tall lists*/
+      overflow: visible;
+      opacity: 1;
+      margin-top: 1em;
+      -webkit-transform: translate(0, 0);
+              -ms-transform: translate(0, 0);
+          transform: translate(0, 0);
+    }
   }
-}
-
-@include breakpoint(max-width ($large - 1px)) {
-  .nav__list input:checked ~ .nav__items {
-    -webkit-transition: 0.5s ease-in-out;
-    transition: 0.5s ease-in-out;
-    max-height: 9999px; /* exaggerate max-height to accommodate tall lists*/
-    overflow: visible;
-    opacity: 1;
-    margin-top: 1em;
-    -webkit-transform: translate(0, 0);
-            -ms-transform: translate(0, 0);
-        transform: translate(0, 0);
-  }
-}
-
-.nav__title {
-  margin: 0;
-  padding: 0.5rem 1rem;
-  font-family: $sans-serif-narrow;
-  font-size: $type-size-5;
-  font-weight: bold;
-}
-
-.nav__sub-title {
-  display: block;
-  margin: 0.5rem 0;
-  padding: 0.5rem 0;
-  font-family: $sans-serif-narrow;
-  font-size: $type-size-6;
-  font-weight: bold;
-  text-transform: uppercase;
-  border-bottom: 1px solid $border-color;
-}
-
-
-/*
-   Table of contents navigation
-   ========================================================================== */
-
-.toc {
-  font-family: $sans-serif-narrow;
-  color: $gray;
-  text-transform: uppercase;
-  letter-spacing: 1px;
-  background-color: #fff;
-  border: 1px solid $border-color;
-  border-radius: $border-radius;
-  box-shadow: $box-shadow;
 
   .nav__title {
-    color: #fff;
-    font-size: $type-size-6;
-    background: $primary-color;
-    border-top-left-radius: $border-radius;
-    border-top-right-radius: $border-radius;
-  }
-}
-
-.toc__menu {
-  margin: 0;
-  padding: 0;
-  width: 100%;
-  list-style: none;
-  font-size: 0.8rem;
-
-  a {
-    display: block;
+    margin: 0;
     padding: 0.5rem 1rem;
-    color: $gray;
-    font-size: $type-size-7;
+    font-family: $sans-serif-narrow;
+    font-size: $type-size-5;
     font-weight: bold;
-    line-height: 1.5;
+  }
+
+  .nav__sub-title {
+    display: block;
+    margin: 0.5rem 0;
+    padding: 0.5rem 0;
+    font-family: $sans-serif-narrow;
+    font-size: $type-size-6;
+    font-weight: bold;
+    text-transform: uppercase;
     border-bottom: 1px solid $border-color;
+  }
 
-    &:hover {
-      color: #000;
-      background: $lighter-gray;
+
+  /*
+     Table of contents navigation
+     ========================================================================== */
+
+  .toc {
+    font-family: $sans-serif-narrow;
+    color: $gray;
+    text-transform: uppercase;
+    letter-spacing: 1px;
+    background-color: $background-color;
+    border: 1px solid $border-color;
+    border-radius: $border-radius;
+    box-shadow: $box-shadow;
+
+    .nav__title {
+      color: #fff;
+      font-size: $type-size-6;
+      background: $primary-color;
+      border-top-left-radius: $border-radius;
+      border-top-right-radius: $border-radius;
     }
   }
 
-  > li:last-child {
+  .toc__menu {
+    margin: 0;
+    padding: 0;
+    width: 100%;
+    list-style: none;
+    font-size: 0.8rem;
+
     a {
-      border-bottom: none;
-    }
-  }
-
-  li ul > li a {
-    padding-left: 1.75rem;
-    font-weight: normal;
-  }
-
-  /* hide sub sub links on small screens*/
-  li > ul li {
-    display: none;
-
-    @include breakpoint($medium) {
       display: block;
+      padding: 0.5rem 1rem;
+      color: $muted-text-color;
+      font-size: $type-size-7;
+      font-weight: bold;
+      line-height: 1.5;
+      border-bottom: 1px solid $border-color;
+
+      &:hover {
+        color: $text-color;
+      }
+    }
+
+    > li:last-child {
+      a {
+        border-bottom: none;
+      }
+    }
+
+    li ul > li a {
+      padding-left: 1.75rem;
+      font-weight: normal;
+    }
+
+    /* hide sub sub links on small screens*/
+    li > ul li {
+      display: none;
+
+      @include breakpoint($medium) {
+        display: block;
+      }
     }
   }
-}
diff --git a/_sass/minimal-mistakes/_notices.scss b/_sass/minimal-mistakes/_notices.scss
index 26afa319..7f9b733f 100644
--- a/_sass/minimal-mistakes/_notices.scss
+++ b/_sass/minimal-mistakes/_notices.scss
@@ -13,6 +13,7 @@
 @mixin notice($notice-color) {
   margin: 2em 0 !important;  /* override*/
   padding: 1em;
+  color: $dark-gray;
   font-family: $global-font-family;
   font-size: $type-size-6 !important;
   text-indent: initial; /* override*/
diff --git a/_sass/minimal-mistakes/_page.scss b/_sass/minimal-mistakes/_page.scss
index 443a0de1..32696229 100644
--- a/_sass/minimal-mistakes/_page.scss
+++ b/_sass/minimal-mistakes/_page.scss
@@ -91,8 +91,7 @@
     }
   }
 
-  a {
-    text-decoration: none;
+  a:not(.btn) {
 
     &:hover {
       text-decoration: underline;
@@ -250,7 +249,7 @@
 
 .page__meta {
   margin-top: 2em;
-  color: mix(#fff, $gray, 25%);
+  color: $muted-text-color;
   font-family: $sans-serif;
   font-size: $type-size-6;
 
@@ -290,7 +289,7 @@
   margin-bottom: 8px;
   padding: 5px 10px;
   text-decoration: none;
-  border: 1px solid $light-gray;
+  border: 1px solid mix(#000, $border-color, 25%);
   border-radius: $border-radius;
 
   &:hover {
@@ -322,8 +321,6 @@
 }
 
 .page__comments-form {
-  padding: 1em;
-  background: $lighter-gray;
   -webkit-transition: $global-transition;
   transition: $global-transition;
 
diff --git a/_sass/minimal-mistakes/_sidebar.scss b/_sass/minimal-mistakes/_sidebar.scss
index 713d5cb5..8e7d70b5 100644
--- a/_sass/minimal-mistakes/_sidebar.scss
+++ b/_sass/minimal-mistakes/_sidebar.scss
@@ -189,7 +189,7 @@
   list-style-type: none;
   border: 1px solid $border-color;
   border-radius: $border-radius;
-  background: #fff;
+  background: $background-color;
   z-index: -1;
   box-shadow: 0 2px 4px 0 rgba(#000, 0.16), 0 2px 10px 0 rgba(#000, 0.12);
   cursor: default;
@@ -234,7 +234,7 @@
     width: 0;
     border-style: solid;
     border-width: 0 10px 10px;
-    border-color: #fff transparent;
+    border-color: $background-color transparent;
     z-index: 1;
 
     @include breakpoint($large) {
diff --git a/_sass/minimal-mistakes/_syntax.scss b/_sass/minimal-mistakes/_syntax.scss
index 089c2467..e7a75540 100644
--- a/_sass/minimal-mistakes/_syntax.scss
+++ b/_sass/minimal-mistakes/_syntax.scss
@@ -19,7 +19,7 @@ figure.highlight {
     top: 0;
     right: 0;
     padding: 0.5em;
-    background-color: $lighter-gray;
+    background-color: $border-color;
     content: "\f121";
     font-family: "fontawesome" !important;
     line-height: 1;
@@ -49,7 +49,7 @@ figure.highlight {
     /* line numbers*/
     &.gutter {
       padding-right: 1em;
-      color: $light-gray;
+      color: rgba($muted-text-color, 0.5);
     }
   }
 
diff --git a/_sass/minimal-mistakes/_tables.scss b/_sass/minimal-mistakes/_tables.scss
index 0c9da82e..05211df0 100644
--- a/_sass/minimal-mistakes/_tables.scss
+++ b/_sass/minimal-mistakes/_tables.scss
@@ -15,8 +15,8 @@ table {
 }
 
 thead {
-  background-color: $lighter-gray;
-  border-bottom: 2px solid $light-gray;
+  background-color: $border-color;
+  border-bottom: 2px solid mix(#000, $border-color, 25%);
 }
 
 th {
@@ -27,7 +27,7 @@ th {
 
 td {
   padding: 0.5em;
-  border-bottom: 1px solid $light-gray;
+  border-bottom: 1px solid mix(#000, $border-color, 25%);
 }
 
 tr,
diff --git a/_sass/minimal-mistakes/_utilities.scss b/_sass/minimal-mistakes/_utilities.scss
index d44e886a..bbc310e8 100644
--- a/_sass/minimal-mistakes/_utilities.scss
+++ b/_sass/minimal-mistakes/_utilities.scss
@@ -57,7 +57,7 @@ body:hover .visually-hidden button {
   background: #fff;
   z-index: 100000;
   text-decoration: none;
-  box-shadow: 0 0 2px 2px rgba(0,0,0,.6);
+  box-shadow: 0 0 2px 2px rgba(0, 0, 0, 0.6);
 }
 
 
@@ -185,7 +185,7 @@ body:hover .visually-hidden button {
 
 .social-icons {
   .fa {
-    color: #000;
+    color: $text-color;
   }
 
   .fa-behance,
diff --git a/_sass/minimal-mistakes/_variables.scss b/_sass/minimal-mistakes/_variables.scss
index 5ded6292..8bae93ae 100644
--- a/_sass/minimal-mistakes/_variables.scss
+++ b/_sass/minimal-mistakes/_variables.scss
@@ -6,125 +6,132 @@
    Typography
    ========================================================================== */
 
-$doc-font-size              : 16 !default;
+$doc-font-size                : 16 !default;
 
 /* paragraph indention */
-$paragraph-indent           : false !default; // true, false (default)
-$indent-var                 : 1.3em !default;
+$paragraph-indent             : false !default; // true, false (default)
+$indent-var                   : 1.3em !default;
 
 /* system typefaces */
-$serif                      : Georgia, Times, serif !default;
-$sans-serif                 : -apple-system, ".SFNSText-Regular", "San Francisco", "Roboto", "Segoe UI", "Helvetica Neue", "Lucida Grande", Arial, sans-serif !default;
-$monospace                  : Monaco, Consolas, "Lucida Console", monospace !default;
+$serif                        : Georgia, Times, serif !default;
+$sans-serif                   : -apple-system, ".SFNSText-Regular", "San Francisco", "Roboto", "Segoe UI", "Helvetica Neue", "Lucida Grande", Arial, sans-serif !default;
+$monospace                    : Monaco, Consolas, "Lucida Console", monospace !default;
 
 /* sans serif typefaces */
-$sans-serif-narrow          : $sans-serif !default;
-$helvetica                  : Helvetica, "Helvetica Neue", Arial, sans-serif !default;
+$sans-serif-narrow            : $sans-serif !default;
+$helvetica                    : Helvetica, "Helvetica Neue", Arial, sans-serif !default;
 
 /* serif typefaces */
-$georgia                    : Georgia, serif !default;
-$times                      : Times, serif !default;
-$bodoni                     : "Bodoni MT", serif !default;
-$calisto                    : "Calisto MT", serif !default;
-$garamond                   : Garamond, serif !default;
+$georgia                      : Georgia, serif !default;
+$times                        : Times, serif !default;
+$bodoni                       : "Bodoni MT", serif !default;
+$calisto                      : "Calisto MT", serif !default;
+$garamond                     : Garamond, serif !default;
 
-$global-font-family         : $sans-serif !default;
-$header-font-family         : $sans-serif !default;
-$caption-font-family        : $serif !default;
+$global-font-family           : $sans-serif !default;
+$header-font-family           : $sans-serif !default;
+$caption-font-family          : $serif !default;
 
 /* type scale */
-$type-size-1                : 2.441em !default;  // ~39.056px
-$type-size-2                : 1.953em !default;  // ~31.248px
-$type-size-3                : 1.563em !default;  // ~25.008px
-$type-size-4                : 1.25em !default;   // ~20px
-$type-size-5                : 1em !default;      // ~16px
-$type-size-6                : 0.75em !default;   // ~12px
-$type-size-7                : 0.6875em !default; // ~11px
-$type-size-8                : 0.625em !default;  // ~10px
+$type-size-1                  : 2.441em !default;  // ~39.056px
+$type-size-2                  : 1.953em !default;  // ~31.248px
+$type-size-3                  : 1.563em !default;  // ~25.008px
+$type-size-4                  : 1.25em !default;   // ~20px
+$type-size-5                  : 1em !default;      // ~16px
+$type-size-6                  : 0.75em !default;   // ~12px
+$type-size-7                  : 0.6875em !default; // ~11px
+$type-size-8                  : 0.625em !default;  // ~10px
 
 
 /*
    Colors
    ========================================================================== */
 
-$gray                       : #7a8288 !default;
-$dark-gray                  : mix(#000, $gray, 40%) !default;
-$darker-gray                : mix(#000, $gray, 60%) !default;
-$light-gray                 : mix(#fff, $gray, 50%) !default;
-$lighter-gray               : mix(#fff, $gray, 90%) !default;
+$gray                         : #7a8288 !default;
+$dark-gray                    : mix(#000, $gray, 40%) !default;
+$darker-gray                  : mix(#000, $gray, 60%) !default;
+$light-gray                   : mix(#fff, $gray, 50%) !default;
+$lighter-gray                 : mix(#fff, $gray, 90%) !default;
 
-$body-color                 : #fff !default;
-$background-color           : #fff !default;
-$code-background-color      : #fafafa !default;
-$code-background-color-dark : $light-gray !default;
-$text-color                 : $dark-gray !default;
-$border-color               : $lighter-gray !default;
+$background-color             : #fff !default;
+$code-background-color        : #fafafa !default;
+$code-background-color-dark   : $light-gray !default;
+$text-color                   : $dark-gray !default;
+$muted-text-color             : mix(#fff, $text-color, 35%) !default;
+$border-color                 : $lighter-gray !default;
+$form-background-color        : $lighter-gray !default;
+$footer-background-color      : $lighter-gray !default;
 
-$primary-color              : #7a8288 !default;
-$success-color              : #62c462 !default;
-$warning-color              : #f89406 !default;
-$danger-color               : #ee5f5b !default;
-$info-color                 : #52adc8 !default;
+$primary-color                : #7a8288 !default;
+$success-color                : #62c462 !default;
+$warning-color                : #f89406 !default;
+$danger-color                 : #ee5f5b !default;
+$info-color                   : #52adc8 !default;
+
+/* YIQ color contrast */
+$yiq-contrasted-dark-default  : $dark-gray !default;
+$yiq-contrasted-light-default : #fff !default;
+$yiq-contrasted-threshold     : 175 !default;
+$yiq-debug                    : false !default;
 
 /* brands */
-$behance-color              : #1769FF !default;
-$bitbucket-color            : #205081 !default;
-$dribbble-color             : #ea4c89 !default;
-$facebook-color             : #3b5998 !default;
-$flickr-color               : #ff0084 !default;
-$foursquare-color           : #0072b1 !default;
-$github-color               : #171516 !default;
-$google-plus-color          : #dd4b39 !default;
-$instagram-color            : #517fa4 !default;
-$lastfm-color               : #d51007 !default;
-$linkedin-color             : #007bb6 !default;
-$pinterest-color            : #cb2027 !default;
-$rss-color                  : #fa9b39 !default;
-$soundcloud-color           : #ff3300 !default;
-$stackoverflow-color        : #fe7a15 !default;
-$tumblr-color               : #32506d !default;
-$twitter-color              : #55acee !default;
-$vimeo-color                : #1ab7ea !default;
-$vine-color                 : #00bf8f !default;
-$youtube-color              : #bb0000 !default;
-$xing-color                 : #006567 !default;
-
+$behance-color                : #1769FF !default;
+$bitbucket-color              : #205081 !default;
+$dribbble-color               : #ea4c89 !default;
+$facebook-color               : #3b5998 !default;
+$flickr-color                 : #ff0084 !default;
+$foursquare-color             : #0072b1 !default;
+$github-color                 : #171516 !default;
+$google-plus-color            : #dd4b39 !default;
+$instagram-color              : #517fa4 !default;
+$lastfm-color                 : #d51007 !default;
+$linkedin-color               : #007bb6 !default;
+$pinterest-color              : #cb2027 !default;
+$rss-color                    : #fa9b39 !default;
+$soundcloud-color             : #ff3300 !default;
+$stackoverflow-color          : #fe7a15 !default;
+$tumblr-color                 : #32506d !default;
+$twitter-color                : #55acee !default;
+$vimeo-color                  : #1ab7ea !default;
+$vine-color                   : #00bf8f !default;
+$youtube-color                : #bb0000 !default;
+$xing-color                   : #006567 !default;
 
 /* links */
-$link-color                 : $info-color !default;
-$link-color-hover           : mix(#000, $link-color, 25%) !default;
-$link-color-visited         : mix(#fff, $link-color, 25%) !default;
-$masthead-link-color        : $primary-color !default;
-$masthead-link-color-hover  : mix(#000, $primary-color, 25%) !default;
-$navicon-link-color-hover   : mix(#fff, $primary-color, 75%) !default;
+$link-color                   : $info-color !default;
+$link-color-hover             : mix(#000, $link-color, 25%) !default;
+$link-color-visited           : mix(#fff, $link-color, 25%) !default;
+$masthead-link-color          : $primary-color !default;
+$masthead-link-color-hover    : mix(#000, $primary-color, 25%) !default;
+$navicon-link-color-hover     : mix(#fff, $primary-color, 75%) !default;
 
 /*
    Breakpoints
    ========================================================================== */
 
-$small                      : 600px !default;
-$medium                     : 768px !default;
-$medium-wide                : 900px !default;
-$large                      : 1024px !default;
-$x-large                    : 1280px !default;
+$small                        : 600px !default;
+$medium                       : 768px !default;
+$medium-wide                  : 900px !default;
+$large                        : 1024px !default;
+$x-large                      : 1280px !default;
 
 
 /*
    Grid
    ========================================================================== */
 
-$right-sidebar-width-narrow : 200px !default;
-$right-sidebar-width        : 300px !default;
-$right-sidebar-width-wide   : 400px !default;
+$right-sidebar-width-narrow   : 200px !default;
+$right-sidebar-width          : 300px !default;
+$right-sidebar-width-wide     : 400px !default;
 
 
 /*
    Other
    ========================================================================== */
 
-$border-radius              : 4px !default;
-$box-shadow                 : 0 1px 1px rgba(0, 0, 0, 0.125) !default;
-$navicon-width              : 1.5rem !default;
-$navicon-height             : 0.25rem !default;
-$global-transition          : all 0.2s ease-in-out !default;
-$intro-transition           : intro 0.3s both !default;
+$border-radius                : 4px !default;
+$box-shadow                   : 0 1px 1px rgba(0, 0, 0, 0.125) !default;
+$navicon-width                : 1.5rem !default;
+$navicon-height               : 0.25rem !default;
+$global-transition            : all 0.2s ease-in-out !default;
+$intro-transition             : intro 0.3s both !default;
diff --git a/_sass/minimal-mistakes/skins/_air.scss b/_sass/minimal-mistakes/skins/_air.scss
new file mode 100644
index 00000000..bdbca84f
--- /dev/null
+++ b/_sass/minimal-mistakes/skins/_air.scss
@@ -0,0 +1,23 @@
+/* ==========================================================================
+   Air skin
+   ========================================================================== */
+
+/* Colors */
+$background-color: #eeeeee !default;
+$text-color: #222831 !default;
+$muted-text-color: #393e46 !default;
+$primary-color: #0092ca !default;
+$border-color: mix(#fff, #393e46, 75%) !default;
+$footer-background-color: $primary-color !default;
+$link-color: #393e46 !default;
+$masthead-link-color: $text-color !default;
+$masthead-link-color-hover: $text-color !default;
+$navicon-link-color-hover: mix(#fff, $text-color, 80%) !default;
+
+.page__footer {
+  color: #fff !important; // override
+}
+
+.page__footer-follow .social-icons .fa {
+  color: inherit;
+}
\ No newline at end of file
diff --git a/_sass/minimal-mistakes/skins/_contrast.scss b/_sass/minimal-mistakes/skins/_contrast.scss
new file mode 100644
index 00000000..431c7131
--- /dev/null
+++ b/_sass/minimal-mistakes/skins/_contrast.scss
@@ -0,0 +1,34 @@
+/* ==========================================================================
+   Contrast skin
+   ========================================================================== */
+
+/* Colors */
+$text-color: #000 !default;
+$muted-text-color: $text-color !default;
+$primary-color: #ff0000 !default;
+$border-color: mix(#fff, $text-color, 75%) !default;
+$footer-background-color: #000 !default;
+$link-color: #0000ff !default;
+$masthead-link-color: $text-color !default;
+$masthead-link-color-hover: $text-color !default;
+$navicon-link-color-hover: mix(#fff, $text-color, 80%) !default;
+
+.page__content {
+
+  .notice,
+  .notice--primary,
+  .notice--info,
+  .notice--warning,
+  .notice--success,
+  .notice--danger {
+    color: $text-color;
+  }
+}
+
+.page__footer {
+  color: #fff !important; // override
+}
+
+.page__footer-follow .social-icons .fa {
+  color: inherit;
+}
\ No newline at end of file
diff --git a/_sass/minimal-mistakes/skins/_dark.scss b/_sass/minimal-mistakes/skins/_dark.scss
new file mode 100644
index 00000000..8ccfc25b
--- /dev/null
+++ b/_sass/minimal-mistakes/skins/_dark.scss
@@ -0,0 +1,24 @@
+/* ==========================================================================
+   Dark skin
+   ========================================================================== */
+
+/* Colors */
+$background-color: #252a34 !default;
+$text-color: #eaeaea !default;
+$primary-color: #00adb5 !default;
+$border-color: mix(#fff, $background-color, 20%) !default;
+$code-background-color: mix(#000, $background-color, 15%) !default;
+$code-background-color-dark: mix(#000, $background-color, 20%) !default;
+$form-background-color: mix(#000, $background-color, 15%) !default;
+$footer-background-color: mix(#000, $background-color, 30%) !default;
+$link-color: mix($primary-color, $text-color, 40%) !default;
+$link-color-hover: mix(#fff, $link-color, 25%) !default;
+$link-color-visited: mix(#000, $link-color, 25%) !default;
+$masthead-link-color: $text-color !default;
+$masthead-link-color-hover: mix(#000, $text-color, 20%) !default;
+$navicon-link-color-hover: mix(#000, $background-color, 30%) !default;
+
+.author__urls.social-icons .fa,
+.page__footer-follow .social-icons .fa {
+  color: inherit;
+}
\ No newline at end of file
diff --git a/_sass/minimal-mistakes/skins/_default.scss b/_sass/minimal-mistakes/skins/_default.scss
new file mode 100644
index 00000000..7489b584
--- /dev/null
+++ b/_sass/minimal-mistakes/skins/_default.scss
@@ -0,0 +1,5 @@
+/* ==========================================================================
+   Default skin
+   ========================================================================== */
+
+// Intentionally left blank
diff --git a/_sass/minimal-mistakes/skins/_dirt.scss b/_sass/minimal-mistakes/skins/_dirt.scss
new file mode 100644
index 00000000..e7993737
--- /dev/null
+++ b/_sass/minimal-mistakes/skins/_dirt.scss
@@ -0,0 +1,15 @@
+/* ==========================================================================
+   Dirt skin
+   ========================================================================== */
+
+/* Colors */
+$background-color: #f3f3f3 !default;
+$text-color: #343434 !default;
+$muted-text-color: #8e8b82 !default;
+$primary-color: #343434 !default;
+$border-color: #e9dcbe !default;
+$footer-background-color: #e9dcbe !default;
+$link-color: #343434 !default;
+$masthead-link-color: $text-color !default;
+$masthead-link-color-hover: $text-color !default;
+$navicon-link-color-hover: mix(#fff, $text-color, 80%) !default;
\ No newline at end of file
diff --git a/_sass/minimal-mistakes/skins/_mint.scss b/_sass/minimal-mistakes/skins/_mint.scss
new file mode 100644
index 00000000..d0e86c8f
--- /dev/null
+++ b/_sass/minimal-mistakes/skins/_mint.scss
@@ -0,0 +1,23 @@
+/* ==========================================================================
+   Mint skin
+   ========================================================================== */
+
+/* Colors */
+$background-color: #f3f6f6 !default;
+$text-color: #40514e !default;
+$muted-text-color: #40514e !default;
+$primary-color: #11999e !default;
+$border-color: mix(#fff, #40514e, 75%) !default;
+$footer-background-color: #30e3ca !default;
+$link-color: #11999e !default;
+$masthead-link-color: $text-color !default;
+$masthead-link-color-hover: $text-color !default;
+$navicon-link-color-hover: mix(#fff, $text-color, 80%) !default;
+
+.page__footer {
+  color: #fff !important; // override
+}
+
+.page__footer-follow .social-icons .fa {
+  color: inherit;
+}
\ No newline at end of file
diff --git a/_sass/minimal-mistakes/skins/_sunrise.scss b/_sass/minimal-mistakes/skins/_sunrise.scss
new file mode 100644
index 00000000..9c3c4d08
--- /dev/null
+++ b/_sass/minimal-mistakes/skins/_sunrise.scss
@@ -0,0 +1,26 @@
+/* ==========================================================================
+   Sunrise skin
+   ========================================================================== */
+
+/* Colors */
+$dark-gray: #0e2431 !default;
+$background-color: #e8d5b7 !default;
+$text-color: #000 !default;
+$muted-text-color: $dark-gray !default;
+$primary-color: #fc3a52 !default;
+$border-color: mix(#000, $background-color, 20%) !default;
+$code-background-color: mix(#fff, $background-color, 20%) !default;
+$code-background-color-dark: mix(#000, $background-color, 10%) !default;
+$form-background-color: mix(#fff, $background-color, 15%) !default;
+$footer-background-color: #f9b248 !default;
+$link-color: mix(#000, $primary-color, 10%) !default;
+$link-color-hover: mix(#fff, $link-color, 25%) !default;
+$link-color-visited: mix(#000, $link-color, 25%) !default;
+$masthead-link-color: $text-color !default;
+$masthead-link-color-hover: mix(#000, $text-color, 20%) !default;
+$navicon-link-color-hover: mix(#000, $background-color, 30%) !default;
+
+.author__urls.social-icons .fa,
+.page__footer-follow .social-icons .fa {
+  color: inherit;
+}
\ No newline at end of file
diff --git a/assets/css/main.scss b/assets/css/main.scss
index 61c73433..23346e77 100644
--- a/assets/css/main.scss
+++ b/assets/css/main.scss
@@ -4,4 +4,5 @@
 
 @charset "utf-8";
 
-@import "minimal-mistakes";
\ No newline at end of file
+@import "minimal-mistakes/skins/{{ site.minimal_mistakes_skin | default: 'default' }}"; // skin
+@import "minimal-mistakes"; // main partials
\ No newline at end of file
diff --git a/docs/_config.yml b/docs/_config.yml
index 8e59483a..d8e7c0d7 100644
--- a/docs/_config.yml
+++ b/docs/_config.yml
@@ -5,6 +5,8 @@
 # For technical reasons, this file is *NOT* reloaded automatically when you use
 # `jekyll serve`. If you change this file, please restart the server process.
 
+minimal_mistakes_skin    : "default" # "air", "contrast", "dark", "dirt", "mint", "sunrise"
+
 # Site Settings
 locale                   : "en-US"
 title                    : "Minimal Mistakes"
diff --git a/docs/_docs/05-configuration.md b/docs/_docs/05-configuration.md
index 1319959f..97cede02 100644
--- a/docs/_docs/05-configuration.md
+++ b/docs/_docs/05-configuration.md
@@ -2,7 +2,7 @@
 title: "Configuration"
 permalink: /docs/configuration/
 excerpt: "Settings for configuring and customizing the theme."
-last_modified_at: 2017-09-05T12:06:30-04:00
+last_modified_at: 2017-09-12T10:38:09-04:00
 ---
 
 Settings that affect your entire site can be changed in [Jekyll's configuration file](https://jekyllrb.com/docs/configuration/): `_config.yml`, found in the root of your project. If you don't have this file you'll need to copy or create one using the theme's [default `_config.yml`](https://github.com/mmistakes/minimal-mistakes/blob/master/_config.yml) as a base.
@@ -24,6 +24,71 @@ If you're using the Ruby gem version of the theme you'll need this line to activ
 theme: minimal-mistakes-jekyll
 ```
 
+### Skin
+
+Easily change the color scheme of the theme using one of the provided "skins":
+
+```yaml
+minimal_mistakes_skin : "default" # "air", "contrast", "dark", "dirt", "mint", "sunrise"
+```
+
+**Note:** If you have made edits to the theme's CSS files be sure to update [`/assets/css/main.scss`](https://github.com/mmistakes/minimal-mistakes/blob/master/assets/css/main.scss) to include `@import "minimal-mistakes/skins/{{ site.minimal_mistakes_skin | default: 'default' }}"; // skin` before the `minimal-mistakes` import.
+{: .notice--warning}
+
+#### Air skin: `air`
+{:.no_toc}
+
+<figure class="half">
+    <a href="{{ site.baseurl }}/assets/images/air-skin-archive-large.png"><img src="{{ site.baseurl }}/assets/images/air-skin-archive.png"></a>
+    <a href="{{ site.baseurl }}/assets/images/air-skin-post-large.png"><img src="{{ site.baseurl }}/assets/images/air-skin-post.png"></a>
+    <figcaption>Calm and blue.</figcaption>
+</figure>
+
+#### Contrast skin: `contrast`
+{:.no_toc}
+
+<figure class="half">
+    <a href="{{ site.baseurl }}/assets/images/contrast-skin-archive-large.png"><img src="{{ site.baseurl }}/assets/images/contrast-skin-archive.png"></a>
+    <a href="{{ site.baseurl }}/assets/images/contrast-skin-post-large.png"><img src="{{ site.baseurl }}/assets/images/contrast-skin-post.png"></a>
+    <figcaption>Retro feel with bold blue links and inverted footer.</figcaption>
+</figure>
+
+#### Dark skin: `dark`
+{:.no_toc}
+
+<figure class="half">
+    <a href="{{ site.baseurl }}/assets/images/dark-skin-archive-large.png"><img src="{{ site.baseurl }}/assets/images/dark-skin-archive.png"></a>
+    <a href="{{ site.baseurl }}/assets/images/dark-skin-post-large.png"><img src="{{ site.baseurl }}/assets/images/dark-skin-post.png"></a>
+    <figcaption>Inverted palette, white text on a dark background.</figcaption>
+</figure>
+
+#### Dirt skin: `dirt`
+{:.no_toc}
+
+<figure class="half">
+    <a href="{{ site.baseurl }}/assets/images/dirt-skin-archive-large.png"><img src="{{ site.baseurl }}/assets/images/dirt-skin-archive.png"></a>
+    <a href="{{ site.baseurl }}/assets/images/dirt-skin-post-large.png"><img src="{{ site.baseurl }}/assets/images/dirt-skin-post.png"></a>
+    <figcaption>Earthy tones.</figcaption>
+</figure>
+
+#### Mint skin: `mint`
+{:.no_toc}
+
+<figure class="half">
+    <a href="{{ site.baseurl }}/assets/images/mint-skin-archive-large.png"><img src="{{ site.baseurl }}/assets/images/mint-skin-archive.png"></a>
+    <a href="{{ site.baseurl }}/assets/images/mint-skin-post-large.png"><img src="{{ site.baseurl }}/assets/images/mint-skin-post.png"></a>
+    <figcaption>Minty fresh green.</figcaption>
+</figure>
+
+#### Sunrise skin: `sunrise`
+{:.no_toc}
+
+<figure class="half">
+    <a href="{{ site.baseurl }}/assets/images/sunrise-skin-archive-large.png"><img src="{{ site.baseurl }}/assets/images/sunrise-skin-archive.png"></a>
+    <a href="{{ site.baseurl }}/assets/images/sunrise-skin-post-large.png"><img src="{{ site.baseurl }}/assets/images/sunrise-skin-post.png"></a>
+    <figcaption>Oranges and red.</figcaption>
+</figure>
+
 ### Site Locale
 
 `site.locale` is used to declare the primary language for each web page within the site.
diff --git a/docs/_docs/15-utility-classes.md b/docs/_docs/15-utility-classes.md
index 76c262e8..56de4560 100644
--- a/docs/_docs/15-utility-classes.md
+++ b/docs/_docs/15-utility-classes.md
@@ -2,7 +2,7 @@
 title: "Utility Classes"
 permalink: /docs/utility-classes/
 excerpt: "CSS classes for aligning text/image, styling buttons and notices, and more."
-last_modified_at: 2016-11-03T11:32:25-04:00
+last_modified_at: 2017-09-01T11:54:44-04:00
 ---
 
 {% include toc icon="gears" title="Utility Classes" %}
@@ -108,15 +108,16 @@ The image above should extend outside of the parent container on right.
 
 ## Buttons
 
-Make any link standout more when applying the `.btn` class.
+Make any link standout more when applying the `.btn .btn--primary` classes.
 
 ```html
-<a href="#" class="btn">Link Text</a>
+<a href="#" class="btn btn--primary">Link Text</a>
 ```
 
 | Button Type   | Example | Class | Kramdown |
 | ------        | ------- | ----- | ------- |
 | Default       | [Text](#link){: .btn} | `.btn` | `[Text](#link){: .btn}` |
+| Primary       | [Text](#link){: .btn .btn--primary} | `.btn .btn--primary` | `[Text](#link){: .btn .btn--primary}` |
 | Success       | [Text](#link){: .btn .btn--success} | `.btn .btn--success` | `[Text](#link){: .btn .btn--success}` |
 | Warning       | [Text](#link){: .btn .btn--warning} | `.btn .btn--warning` | `[Text](#link){: .btn .btn--warning}` |
 | Danger        | [Text](#link){: .btn .btn--danger} | `.btn .btn--danger` | `[Text](#link){: .btn .btn--danger}` |
@@ -126,10 +127,10 @@ Make any link standout more when applying the `.btn` class.
 
 | Button Size | Example | Class | Kramdown |
 | ----------- | ------- | ----- | -------- |
-| X-Large     | [X-Large Button](#){: .btn .btn--x-large} | `.btn .btn--x-large` | `[Text](#link){: .btn .btn--x-large}` |
-| Large       | [Large Button](#){: .btn .btn--large} | `.btn .btn--large` | `[Text](#link){: .btn .btn--large}` |
-| Default     | [Default Button](#){: .btn} | `.btn` | `[Text](#link){: .btn}` |
-| Small       | [Small Button](#){: .btn .btn--small} | `.btn .btn--small` | `[Text](#link){: .btn .btn--small}` |
+| X-Large     | [X-Large Button](#){: .btn .btn--primary .btn--x-large} | `.btn .btn--primary .btn--x-large` | `[Text](#link){: .btn .btn--primary .btn--x-large}` |
+| Large       | [Large Button](#){: .btn .btn--primary .btn--large} | `.btn .btn--primary .btn--large` | `[Text](#link){: .btn .btn--primary .btn--large}` |
+| Default     | [Default Button](#){: .btn .btn--primary} | `.btn .btn--primary` | `[Text](#link){: .btn .btn--primary }` |
+| Small       | [Small Button](#){: .btn .btn--primary .btn--small} | `.btn .btn--primary .btn--small` | `[Text](#link){: .btn .btn--primary .btn--small}` |
 
 ## Notices
 
@@ -144,22 +145,22 @@ Call attention to a block of text.
 | Success     | `.notice--success` |
 | Danger      | `.notice--danger`  |
 
-**Watch out!** This paragraph of text has been emphasized with the `{: .notice}` class.
+**Watch out!** This paragraph of text has been [emphasized](#) with the `{: .notice}` class.
 {: .notice}
 
-**Watch out!** This paragraph of text has been emphasized with the `{: .notice--primary}` class.
+**Watch out!** This paragraph of text has been [emphasized](#) with the `{: .notice--primary}` class.
 {: .notice--primary}
 
-**Watch out!** This paragraph of text has been emphasized with the `{: .notice--info}` class.
+**Watch out!** This paragraph of text has been [emphasized](#) with the `{: .notice--info}` class.
 {: .notice--info}
 
-**Watch out!** This paragraph of text has been emphasized with the `{: .notice--warning}` class.
+**Watch out!** This paragraph of text has been [emphasized](#) with the `{: .notice--warning}` class.
 {: .notice--warning}
 
-**Watch out!** This paragraph of text has been emphasized with the `{: .notice--success}` class.
+**Watch out!** This paragraph of text has been [emphasized](#) with the `{: .notice--success}` class.
 {: .notice--success}
 
-**Watch out!** This paragraph of text has been emphasized with the `{: .notice--danger}` class.
+**Watch out!** This paragraph of text has been [emphasized](#) with the `{: .notice--danger}` class.
 {: .notice--danger}
 
 {% capture notice-text %}
diff --git a/docs/_docs/18-history.md b/docs/_docs/18-history.md
index b813c389..b4c8069e 100644
--- a/docs/_docs/18-history.md
+++ b/docs/_docs/18-history.md
@@ -4,7 +4,7 @@ permalink: /docs/history/
 excerpt: "Change log of enhancements and bug fixes made to the theme."
 sidebar:
   nav: docs
-last_modified_at: 2017-09-12T08:44:28-04:00
+last_modified_at: 2017-09-12T08:49:12-04:00
 ---
 
 ## Unreleased
@@ -13,6 +13,10 @@ last_modified_at: 2017-09-12T08:44:28-04:00
 
 - Test strict Front Matter in `/test` site. [#1236](https://github.com/mmistakes/minimal-mistakes/pull/1236)
 - Rename `gems` key to `plugins`. [#1239](https://github.com/mmistakes/minimal-mistakes/pull/1239)
+- Add [YIQ Color Contrast](https://github.com/easy-designs/yiq-color-contrast) mixin for determining lightness of a color.
+- DRY up button CSS using Sass lists and YIQ Color Contrast mixin.
+- Add `btn--primary` button class. **Note:** elements that were previously using only a `.btn` class will now also need `.btn--primary` (eg. `<a class="btn btn--primary" href="#">my link</a>`).
+- Add `air`, `contrast`, `dark`, `dirt`, `mint`, and `sunrise` skin color options. [#1208](https://github.com/mmistakes/minimal-mistakes/issues/1208)
 
 ## [4.5.2](https://github.com/mmistakes/minimal-mistakes/releases/tag/4.5.2)
 
@@ -29,8 +33,6 @@ last_modified_at: 2017-09-12T08:44:28-04:00
 - Add note to configuration documentation about Cloudflare minification as an alternative to `layout: compress`. [#1217](https://github.com/mmistakes/minimal-mistakes/pull/1217)
 - Show 4 latest posts in "You May Also Enjoy" module when `related: true` and no related posts are found due to `lsi` ([latent semantic indexing](https://en.wikipedia.org/wiki/Latent_semantic_analysis#Latent_semantic_indexing)) being disabled on GitHub Pages. [#554](https://github.com/mmistakes/minimal-mistakes/issues/554)
 - Truncate archive item titles' that overflow with an ellipsis. [#1213](https://github.com/mmistakes/minimal-mistakes/issues/1213)
-- Test strict Front Matter in `/test` site. [#1236](https://github.com/mmistakes/minimal-mistakes/pull/1236)
-- Rename `gems` key to `plugins`. [#1239](https://github.com/mmistakes/minimal-mistakes/pull/1239)
 
 ### Bug Fixes
 
@@ -38,7 +40,7 @@ last_modified_at: 2017-09-12T08:44:28-04:00
 - Reduce amount of blank pages when printing in Chrome. [#1196](https://github.com/mmistakes/minimal-mistakes/issues/1196)
 - Remove `#disqus_thread` duplicate  from `comments-providers/disqus.html` as it is already in `comments.html` include. [#1199](https://github.com/mmistakes/minimal-mistakes/issues/1199)
 - Fix Liquid syntax errors in `tag-list.html` and `category-list.html` includes by removing parenthesis in `assign`s. [#1223](https://github.com/mmistakes/minimal-mistakes/issues/1223)
-- Fix Liquid syntax error: "Expected id but found open_square in {% raw %}`"{{page.[include.id] }}"`"{% endraw %} in `gallery` and `feature_row` includes.
+- Fix Liquid syntax error: "Expected id but found open_square in {% raw %}`"{{ page.[include.id] }}"`"{% endraw %} in `gallery` and `feature_row` includes.
 - Fix Liquid syntax error: "Expected end_of_string but found pipe in `"name in __names | sort"`" in `group-by-array` include.
 
 ## [4.5.1](https://github.com/mmistakes/minimal-mistakes/releases/tag/4.5.1)
diff --git a/docs/_includes/author-profile.html b/docs/_includes/author-profile.html
index dfc713a4..2d105431 100644
--- a/docs/_includes/author-profile.html
+++ b/docs/_includes/author-profile.html
@@ -131,6 +131,14 @@
         </li>
       {% endif %}
 
+      {% if author.gitlab %}
+        <li>
+          <a href="https://gitlab.com/{{ author.gitlab }}" itemprop="sameAs">
+            <i class="fa fa-fw fa-gitlab" aria-hidden="true"></i> Gitlab
+          </a>
+        </li>
+      {% endif %}
+
       {% if author.stackoverflow %}
         <li>
           <a href="https://www.stackoverflow.com/users/{{ author.stackoverflow }}" itemprop="sameAs">
diff --git a/docs/_includes/comments.html b/docs/_includes/comments.html
index 6f57edc9..332374ee 100644
--- a/docs/_includes/comments.html
+++ b/docs/_includes/comments.html
@@ -47,45 +47,47 @@
             <!-- End static comments -->
 
             <!-- Start new comment form -->
-            <h4 class="page__comments-title">{{ site.data.ui-text[site.locale].comments_label | default: "Leave a Comment" }}</h4>
-            <p class="small">{{ site.data.ui-text[site.locale].comment_form_info | default: "Your email address will not be published. Required fields are marked" }} <span class="required">*</span></p>
-            <form id="new_comment" class="page__comments-form js-form form" method="post" action="https://api.staticman.net/v1/entry/{{ site.repository }}/{{ site.staticman.branch }}">
-              <div class="form__spinner">
-                <i class="fa fa-spinner fa-spin fa-3x fa-fw"></i>
-                <span class="sr-only">{{ site.data.ui-text[site.locale].loading_label | default: "Loading..." }}</span>
-              </div>
+            <div class="page__comments-form">
+              <h4 class="page__comments-title">{{ site.data.ui-text[site.locale].comments_label | default: "Leave a Comment" }}</h4>
+              <p class="small">{{ site.data.ui-text[site.locale].comment_form_info | default: "Your email address will not be published. Required fields are marked" }} <span class="required">*</span></p>
+              <form id="new_comment" class="page__comments-form js-form form" method="post" action="https://api.staticman.net/v1/entry/{{ site.repository }}/{{ site.staticman.branch }}">
+                <div class="form__spinner">
+                  <i class="fa fa-spinner fa-spin fa-3x fa-fw"></i>
+                  <span class="sr-only">{{ site.data.ui-text[site.locale].loading_label | default: "Loading..." }}</span>
+                </div>
 
-              <fieldset>
-                <label for="comment-form-message">{{ site.data.ui-text[site.locale].comment_form_comment_label | default: "Comment" }} <small class="required">*</small></label>
-                <textarea type="text" rows="3" id="comment-form-message" name="fields[message]" tabindex="1"></textarea>
-                <div class="small help-block"><a href="https://daringfireball.net/projects/markdown/">{{ site.data.ui-text[site.locale].comment_form_md_info | default: "Markdown is supported." }}</a></div>
-              </fieldset>
-              <fieldset>
-                <label for="comment-form-name">{{ site.data.ui-text[site.locale].comment_form_name_label | default: "Name" }} <small class="required">*</small></label>
-                <input type="text" id="comment-form-name" name="fields[name]" tabindex="2" />
-              </fieldset>
-              <fieldset>
-                <label for="comment-form-email">{{ site.data.ui-text[site.locale].comment_form_email_label | default: "Email address" }} <small class="required">*</small></label>
-                <input type="email" id="comment-form-email" name="fields[email]" tabindex="3" />
-              </fieldset>
-              <fieldset>
-                <label for="comment-form-url">{{ site.data.ui-text[site.locale].comment_form_website_label | default: "Website (optional)" }}</label>
-                <input type="url" id="comment-form-url" name="fields[url]" tabindex="4"/>
-              </fieldset>
-              <fieldset class="hidden" style="display: none;">
-                <input type="hidden" name="options[slug]" value="{{ page.slug }}">
-                <label for="comment-form-location">Not used. Leave blank if you are a human.</label>
-                <input type="text" id="comment-form-location" name="fields[hidden]" autocomplete="off"/>
-              </fieldset>
-              <!-- Start comment form alert messaging -->
-              <p class="hidden js-notice">
-                <strong class="js-notice-text"></strong>
-              </p>
-              <!-- End comment form alert messaging -->
-              <fieldset>
-                <button type="submit" id="comment-form-submit" tabindex="5" class="btn btn--large">{{ site.data.ui-text[site.locale].comment_btn_submit | default: "Submit Comment" }}</button>
-              </fieldset>
-            </form>
+                <fieldset>
+                  <label for="comment-form-message">{{ site.data.ui-text[site.locale].comment_form_comment_label | default: "Comment" }} <small class="required">*</small></label>
+                  <textarea type="text" rows="3" id="comment-form-message" name="fields[message]" tabindex="1"></textarea>
+                  <div class="small help-block"><a href="https://daringfireball.net/projects/markdown/">{{ site.data.ui-text[site.locale].comment_form_md_info | default: "Markdown is supported." }}</a></div>
+                </fieldset>
+                <fieldset>
+                  <label for="comment-form-name">{{ site.data.ui-text[site.locale].comment_form_name_label | default: "Name" }} <small class="required">*</small></label>
+                  <input type="text" id="comment-form-name" name="fields[name]" tabindex="2" />
+                </fieldset>
+                <fieldset>
+                  <label for="comment-form-email">{{ site.data.ui-text[site.locale].comment_form_email_label | default: "Email address" }} <small class="required">*</small></label>
+                  <input type="email" id="comment-form-email" name="fields[email]" tabindex="3" />
+                </fieldset>
+                <fieldset>
+                  <label for="comment-form-url">{{ site.data.ui-text[site.locale].comment_form_website_label | default: "Website (optional)" }}</label>
+                  <input type="url" id="comment-form-url" name="fields[url]" tabindex="4"/>
+                </fieldset>
+                <fieldset class="hidden" style="display: none;">
+                  <input type="hidden" name="options[slug]" value="{{ page.slug }}">
+                  <label for="comment-form-location">Not used. Leave blank if you are a human.</label>
+                  <input type="text" id="comment-form-location" name="fields[hidden]" autocomplete="off"/>
+                </fieldset>
+                <!-- Start comment form alert messaging -->
+                <p class="hidden js-notice">
+                  <strong class="js-notice-text"></strong>
+                </p>
+                <!-- End comment form alert messaging -->
+                <fieldset>
+                  <button type="submit" id="comment-form-submit" tabindex="5" class="btn btn--primary btn--large">{{ site.data.ui-text[site.locale].comment_btn_submit | default: "Submit Comment" }}</button>
+                </fieldset>
+              </form>
+            </div>
             <!-- End new comment form -->
           {% endif %}
         </section>
diff --git a/docs/_includes/footer.html b/docs/_includes/footer.html
index 8fe13bbd..e727e0b2 100644
--- a/docs/_includes/footer.html
+++ b/docs/_includes/footer.html
@@ -12,6 +12,9 @@
     {% if site.author.github %}
       <li><a href="http://github.com/{{ site.author.github }}"><i class="fa fa-fw fa-github" aria-hidden="true"></i> GitHub</a></li>
     {% endif %}
+    {% if site.author.gitlab %}
+      <li><a href="http://gitlab.com/{{ site.author.gitlab }}"><i class="fa fa-fw fa-gitlab" aria-hidden="true"></i> Gitlab</a></li>
+    {% endif %}
     {% if site.author.bitbucket %}
       <li><a href="http://bitbucket.org/{{ site.author.bitbucket }}"><i class="fa fa-fw fa-bitbucket" aria-hidden="true"></i> Bitbucket</a></li>
     {% endif %}
@@ -19,4 +22,4 @@
   </ul>
 </div>
 
-<div class="page__footer-copyright">&copy; {{ site.time | date: '%Y' }} {{ site.name | default: site.title }}. {{ site.data.ui-text[site.locale].powered_by | default: "Powered by" }} <a href="http://jekyllrb.com" rel="nofollow">Jekyll</a> &amp; <a href="https://mademistakes.com/work/minimal-mistakes-jekyll-theme/" rel="nofollow">Minimal Mistakes</a>.</div>
\ No newline at end of file
+<div class="page__footer-copyright">&copy; {{ site.time | date: '%Y' }} {{ site.name | default: site.title }}. {{ site.data.ui-text[site.locale].powered_by | default: "Powered by" }} <a href="http://jekyllrb.com" rel="nofollow">Jekyll</a> &amp; <a href="https://mademistakes.com/work/minimal-mistakes-jekyll-theme/" rel="nofollow">Minimal Mistakes</a>.</div>
diff --git a/docs/_layouts/single.html b/docs/_layouts/single.html
index 7d327352..4a297941 100644
--- a/docs/_layouts/single.html
+++ b/docs/_layouts/single.html
@@ -35,7 +35,7 @@ layout: default
 
       <section class="page__content" itemprop="text">
         {{ content }}
-        {% if page.link %}<div><a href="{{ page.link }}" class="btn">{{ site.data.ui-text[site.locale].ext_link_label | default: "Direct Link" }}</a></div>{% endif %}
+        {% if page.link %}<div><a href="{{ page.link }}" class="btn btn--primary">{{ site.data.ui-text[site.locale].ext_link_label | default: "Direct Link" }}</a></div>{% endif %}
       </section>
 
       <footer class="page__meta">
diff --git a/docs/_pages/home.md b/docs/_pages/home.md
index bb449502..9f92cfd2 100644
--- a/docs/_pages/home.md
+++ b/docs/_pages/home.md
@@ -14,23 +14,26 @@ feature_row:
     title: "Super Customizable"
     excerpt: "Everything from the menus, sidebars, comments, and more can be configured or set with YAML Front Matter."
     url: "/docs/configuration/"
+    btn_class: "btn--primary"
     btn_label: "Learn More"
   - image_path: /assets/images/mm-responsive-feature.png
     alt: "fully responsive"
     title: "Responsive Layouts"
     excerpt: "Built on HTML5 + CSS3. All layouts are fully responsive with helpers to augment your content."
     url: "/docs/layouts/"
+    btn_class: "btn--primary"
     btn_label: "Learn More"
   - image_path: /assets/images/mm-free-feature.png
     alt: "100% free"
     title: "100% Free"
     excerpt: "Free to use however you want under the MIT License. Clone it, fork it, customize it, whatever!"
     url: "/docs/license/"
+    btn_class: "btn--primary"
     btn_label: "Learn More"
 github:
   - excerpt: '{::nomarkdown}<iframe style="display: inline-block;" src="https://ghbtns.com/github-btn.html?user=mmistakes&repo=minimal-mistakes&type=star&count=true&size=large" frameborder="0" scrolling="0" width="160px" height="30px"></iframe> <iframe style="display: inline-block;" src="https://ghbtns.com/github-btn.html?user=mmistakes&repo=minimal-mistakes&type=fork&count=true&size=large" frameborder="0" scrolling="0" width="158px" height="30px"></iframe>{:/nomarkdown}'
 intro:
-  - excerpt: 'Get notified when I add new stuff &nbsp; [<i class="fa fa-twitter"></i> @mmistakes](https://twitter.com/mmistakes){: .btn .btn--twitter} [<i class="fa fa-paypal"></i> Tip Me](https://www.paypal.me/mmistakes){: .btn}'
+  - excerpt: 'Get notified when I add new stuff &nbsp; [<i class="fa fa-twitter"></i> @mmistakes](https://twitter.com/mmistakes){: .btn .btn--twitter} [<i class="fa fa-paypal"></i> Tip Me](https://www.paypal.me/mmistakes){: .btn .btn--primary}'
 ---
 
 {% include feature_row id="intro" type="center" %}
diff --git a/docs/_pages/splash-page.md b/docs/_pages/splash-page.md
index 59933679..f0cd57b0 100644
--- a/docs/_pages/splash-page.md
+++ b/docs/_pages/splash-page.md
@@ -24,7 +24,7 @@ feature_row:
     excerpt: "This is some sample content that goes here with **Markdown** formatting."
     url: "#test-link"
     btn_label: "Read More"
-    btn_class: "btn--inverse"
+    btn_class: "btn--primary"
   - image_path: /assets/images/unsplash-gallery-image-3-th.jpg
     title: "Placeholder 3"
     excerpt: "This is some sample content that goes here with **Markdown** formatting."
@@ -35,7 +35,7 @@ feature_row2:
     excerpt: 'This is some sample content that goes here with **Markdown** formatting. Left aligned with `type="left"`'
     url: "#test-link"
     btn_label: "Read More"
-    btn_class: "btn--inverse"
+    btn_class: "btn--primary"
 feature_row3:
   - image_path: /assets/images/unsplash-gallery-image-2-th.jpg
     alt: "placeholder image 2"
@@ -43,7 +43,7 @@ feature_row3:
     excerpt: 'This is some sample content that goes here with **Markdown** formatting. Right aligned with `type="right"`'
     url: "#test-link"
     btn_label: "Read More"
-    btn_class: "btn--inverse"
+    btn_class: "btn--primary"
 feature_row4:
   - image_path: /assets/images/unsplash-gallery-image-2-th.jpg
     alt: "placeholder image 2"
@@ -51,7 +51,7 @@ feature_row4:
     excerpt: 'This is some sample content that goes here with **Markdown** formatting. Centered with `type="center"`'
     url: "#test-link"
     btn_label: "Read More"
-    btn_class: "btn--inverse"
+    btn_class: "btn--primary"
 ---
 
 {% include feature_row id="intro" type="center" %}
diff --git a/docs/_posts/2013-01-11-markup-html-tags-and-formatting.md b/docs/_posts/2013-01-11-markup-html-tags-and-formatting.md
index 2a34d618..eeca8f87 100644
--- a/docs/_posts/2013-01-11-markup-html-tags-and-formatting.md
+++ b/docs/_posts/2013-01-11-markup-html-tags-and-formatting.md
@@ -102,6 +102,17 @@ Do It Live
   3. List item three
   4. List item four
 
+## Forms
+
+<form>
+  <fieldset>
+    <legend>Personalia:</legend>
+    Name: <input type="text" size="30"><br>
+    Email: <input type="text" size="30"><br>
+    Date of birth: <input type="text" size="10">
+  </fieldset>
+</form>
+
 ## Buttons
 
 Make any link standout more when applying the `.btn` class.
diff --git a/docs/_sass/minimal-mistakes/_archive.scss b/docs/_sass/minimal-mistakes/_archive.scss
index d6ab5f66..70cb116e 100644
--- a/docs/_sass/minimal-mistakes/_archive.scss
+++ b/docs/_sass/minimal-mistakes/_archive.scss
@@ -26,7 +26,7 @@
   margin: 1.414em 0 0;
   padding-bottom: 0.5em;
   font-size: $type-size-5;
-  color: mix(#fff, $gray, 25%);
+  color: $muted-text-color;
   border-bottom: 1px solid $border-color;
 
   + .list__item .archive__item-title {
@@ -72,6 +72,7 @@
 }
 
 .archive__item:hover {
+
   .archive__item-teaser {
     box-shadow: 0 0 10px rgba(#000, 0.25);
   }
diff --git a/docs/_sass/minimal-mistakes/_base.scss b/docs/_sass/minimal-mistakes/_base.scss
index c5311a29..d9f7df30 100644
--- a/docs/_sass/minimal-mistakes/_base.scss
+++ b/docs/_sass/minimal-mistakes/_base.scss
@@ -118,8 +118,13 @@ a {
 
   &:hover,
   &:active {
+    color: $link-color-hover;
     outline: 0;
   }
+
+  &:visited {
+    color: $link-color-visited;
+  }
 }
 
 /* code */
@@ -141,7 +146,7 @@ td > code {
   padding-bottom: 0.1rem;
   font-size: $type-size-6;
   background: $code-background-color;
-  border: 1px solid $lighter-gray;
+  border: 1px solid $border-color;
   border-radius: $border-radius;
   box-shadow: $box-shadow;
 
@@ -236,20 +241,16 @@ figure {
 
 figcaption {
   margin-bottom: 0.5em;
-  color: mix(#fff, $text-color, 25%);
+  color: $muted-text-color;
   font-family: $caption-font-family;
   font-size: $type-size-6;
 
   a {
-    color: inherit;
-    text-decoration: none;
-    border-bottom: 1px solid $light-gray;
     -webkit-transition: $global-transition;
     transition: $global-transition;
 
     &:hover {
-      color: #000;
-      border-bottom-color: #000;
+      color: $link-color-hover;
     }
   }
 }
diff --git a/docs/_sass/minimal-mistakes/_buttons.scss b/docs/_sass/minimal-mistakes/_buttons.scss
index d6cf90ea..6027eac7 100644
--- a/docs/_sass/minimal-mistakes/_buttons.scss
+++ b/docs/_sass/minimal-mistakes/_buttons.scss
@@ -7,25 +7,19 @@
    ========================================================================== */
 
 .btn {
-  /* default button */
+  /* default */
   display: inline-block;
   margin-bottom: 0.25em;
   padding: 0.5em 1em;
-  color: #fff !important;
   font-family: $sans-serif;
   font-size: $type-size-6;
   font-weight: bold;
   text-align: center;
   text-decoration: none;
-  background-color: $primary-color;
-  border: 0 !important;
+  border-width: 0;
   border-radius: $border-radius;
   cursor: pointer;
 
-  &:hover {
-    background-color: mix(white, #000, 20%);
-  }
-
   .icon {
     margin-right: 0.5em;
   }
@@ -34,8 +28,41 @@
     margin-left: -0.5em; /* override for hidden text*/
   }
 
-  /* fills width of parent container */
+  /* button colors */
+  $buttoncolors:
+  (primary, $primary-color),
+  (inverse, #fff),
+  (light-outline, transparent),
+  (success, $success-color),
+  (warning, $warning-color),
+  (danger, $danger-color),
+  (info, $info-color),
+  (facebook, $facebook-color),
+  (twitter, $twitter-color),
+  (google-plus, $google-plus-color),
+  (linkedin, $linkedin-color);
 
+  @each $buttoncolor, $color in $buttoncolors {
+    &--#{$buttoncolor} {
+      @include yiq-contrasted($color);
+      @if ($buttoncolor == inverse) {
+        border: 1px solid $border-color;
+      }
+      @if ($buttoncolor == light-outline) {
+        border: 1px solid #fff;
+      }
+
+      &:hover {
+        @include yiq-contrasted(mix(#000, $color, 20%));
+      }
+
+      &:visited {
+        @include yiq-contrasted($color);
+      }
+    }
+  }
+
+  /* fills width of parent container */
   &--block {
     display: block;
     width: 100%;
@@ -45,68 +72,7 @@
     }
   }
 
-  /* for dark backgrounds */
-
-  &--inverse {
-    color: $gray !important;
-    border: 1px solid $light-gray !important; /* override*/
-    background-color: #fff;
-
-    &:hover {
-      color: #fff !important;
-      border-color: $gray;
-    }
-  }
-
-  /* light outline */
-
-  &--light-outline {
-    border: 1px solid #fff !important; /* override*/
-    background-color: transparent;
-  }
-
-  /* information */
-
-  &--info {
-    background-color: $info-color;
-
-    &:hover {
-      background-color: mix(#000, $info-color, 20%);
-    }
-  }
-
-  /* warning */
-
-  &--warning {
-    background-color: $warning-color;
-
-    &:hover {
-      background-color: mix(#000, $warning-color, 20%);
-    }
-  }
-
-  /* success */
-
-  &--success {
-    background-color: $success-color;
-
-    &:hover {
-      background-color: mix(#000, $success-color, 20%);
-    }
-  }
-
-  /* danger */
-
-  &--danger {
-    background-color: $danger-color;
-
-    &:hover {
-      background-color: mix(#000, $danger-color, 20%);
-    }
-  }
-
   /* disabled */
-
   &--disabled {
     pointer-events: none;
     cursor: not-allowed;
@@ -115,38 +81,17 @@
     opacity: 0.65;
   }
 
-  /* social buttons */
-
-  $social:
-  (facebook, $facebook-color),
-  (twitter, $twitter-color),
-  (google-plus, $google-plus-color),
-  (linkedin, $linkedin-color);
-
-  @each $socialnetwork, $color in $social {
-    &--#{$socialnetwork} {
-      background-color: $color;
-
-      &:hover {
-        background-color: mix(#000, $color, 20%);
-      }
-    }
-  }
-
   /* extra large button */
-
   &--x-large {
     font-size: $type-size-4;
   }
 
   /* large button */
-
   &--large {
     font-size: $type-size-5;
   }
 
   /* small button */
-
   &--small {
     font-size: $type-size-7;
   }
diff --git a/docs/_sass/minimal-mistakes/_footer.scss b/docs/_sass/minimal-mistakes/_footer.scss
index 9e2b5d2f..3b3ddd31 100644
--- a/docs/_sass/minimal-mistakes/_footer.scss
+++ b/docs/_sass/minimal-mistakes/_footer.scss
@@ -15,13 +15,12 @@
   height: auto;
   /* sticky footer fix end */
   margin-top: 3em;
-  color: mix(#fff, $gray, 25%);
+  color: $muted-text-color;
   -webkit-animation: $intro-transition;
           animation: $intro-transition;
   -webkit-animation-delay: 0.45s;
           animation-delay: 0.45s;
-  background-color: $lighter-gray;
-  border-top: 1px solid $light-gray;
+  background-color: $footer-background-color;
 
   footer {
     @include clearfix;
@@ -46,7 +45,7 @@
   }
 
   .fa {
-    color: mix(#fff, $gray, 25%);
+    color: $muted-text-color;
   }
 }
 
diff --git a/docs/_sass/minimal-mistakes/_forms.scss b/docs/_sass/minimal-mistakes/_forms.scss
index a1f0f146..dc521319 100644
--- a/docs/_sass/minimal-mistakes/_forms.scss
+++ b/docs/_sass/minimal-mistakes/_forms.scss
@@ -4,6 +4,8 @@
 
 form {
   margin: 0 0 5px 0;
+  padding: 1em;
+  background-color: $form-background-color;
 
   fieldset {
     margin-bottom: 5px;
@@ -19,7 +21,6 @@ form {
     padding: 0;
     color: $text-color;
     border: 0;
-    border-bottom: 1px solid mix(#fff, #000, 80%);
     white-space: normal;
   }
 
@@ -80,14 +81,10 @@ select {
   padding: 0.25em;
   margin-bottom: 0.5em;
   color: $text-color;
-  background-color: #fff;
-  border: 1px solid mix(#fff, #000, 80%);
+  background-color: $background-color;
+  border: $border-color;
   border-radius: $border-radius;
   box-shadow: $box-shadow;
-
-  &:hover {
-    border-color: mix(#fff, $primary-color, 50%);
-  }
 }
 
 .input-mini {
@@ -224,6 +221,7 @@ textarea:focus {
   border-color: $primary-color;
   outline: 0;
   outline: thin dotted \9;
+  box-shadow: inset 0 1px 3px rgba($text-color, 0.06), 0 0 5px rgba($primary-color, 0.7);
 }
 
 input[type="file"]:focus,
@@ -240,7 +238,7 @@ select:focus {
 
 .help-block,
 .help-inline {
-  color: $info-color;
+  color: $muted-text-color;
 }
 
 .help-block {
@@ -382,7 +380,7 @@ select:focus {
   color: #000;
   border-width: 2px !important;
   border-style: solid !important;
-  border-color: lighten(#000,50);
+  border-color: $border-color;
   border-radius: $border-radius;
 }
 
diff --git a/docs/_sass/minimal-mistakes/_mixins.scss b/docs/_sass/minimal-mistakes/_mixins.scss
index 14782b19..1d221fc8 100644
--- a/docs/_sass/minimal-mistakes/_mixins.scss
+++ b/docs/_sass/minimal-mistakes/_mixins.scss
@@ -50,4 +50,43 @@
     content: "";
     display: table;
   }
+}
+
+/*
+   Compass YIQ Color Contrast
+   https://github.com/easy-designs/yiq-color-contrast
+   ========================================================================== */
+
+@function yiq-is-light(
+  $color,
+  $threshold: $yiq-contrasted-threshold
+) {
+  $red: red($color);
+  $green: green($color);
+  $blue: blue($color);
+
+  $yiq: (($red*299)+($green*587)+($blue*114))/1000;
+
+  @if $yiq-debug { @debug $yiq, $threshold; }
+
+  @return if($yiq >= $threshold, true, false);
+}
+
+@function yiq-contrast-color(
+  $color,
+  $dark: $yiq-contrasted-dark-default,
+  $light: $yiq-contrasted-light-default,
+  $threshold: $yiq-contrasted-threshold
+) {
+  @return if(yiq-is-light($color, $threshold), $yiq-contrasted-dark-default, $yiq-contrasted-light-default);
+}
+
+@mixin yiq-contrasted(
+  $background-color,
+  $dark: $yiq-contrasted-dark-default,
+  $light: $yiq-contrasted-light-default,
+  $threshold: $yiq-contrasted-threshold
+) {
+  background-color: $background-color;
+  color: yiq-contrast-color($background-color, $dark, $light, $threshold);
 }
\ No newline at end of file
diff --git a/docs/_sass/minimal-mistakes/_navigation.scss b/docs/_sass/minimal-mistakes/_navigation.scss
index 74730ec9..99ff3811 100644
--- a/docs/_sass/minimal-mistakes/_navigation.scss
+++ b/docs/_sass/minimal-mistakes/_navigation.scss
@@ -85,21 +85,22 @@
       line-height: 1.5;
       text-align: center;
       text-decoration: none;
-      color: mix(#fff, $gray, 25%);
-      border: 1px solid $light-gray;
+      color: $muted-text-color;
+      border: 1px solid mix(#000, $border-color, 25%);
       border-radius: 0;
 
       &:hover {
         color: $link-color-hover;
       }
 
-      &.current {
+      &.current,
+      &.current.disabled {
         color: #fff;
         background: $primary-color;
       }
 
       &.disabled {
-        color: mix(#fff, $gray, 75%);
+        color: rgba($muted-text-color, 0.5);
         pointer-events: none;
         cursor: not-allowed;
       }
@@ -133,12 +134,12 @@
     font-weight: bold;
     text-align: center;
     text-decoration: none;
-    color: $link-color;
-    border: 1px solid $light-gray;
+    color: $muted-text-color;
+    border: 1px solid mix(#000, $border-color, 25%);
     border-radius: $border-radius;
 
     &:hover {
-      color: $link-color-hover;
+      @include yiq-contrasted($muted-text-color);
     }
 
     &:first-child {
@@ -153,7 +154,7 @@
     }
 
     &.disabled {
-      color: mix(#fff, $gray, 75%);
+      color: rgba($muted-text-color, 0.5);
       pointer-events: none;
       cursor: not-allowed;
     }
@@ -262,7 +263,7 @@
     padding: 5px;
     border: 1px solid $border-color;
     border-radius: $border-radius;
-    background: #fff;
+    background: $background-color;
     box-shadow: 0 2px 4px 0 rgba(#000, 0.16), 0 2px 10px 0 rgba(#000, 0.12);
 
     &.hidden {
@@ -301,7 +302,7 @@
       width: 0;
       border-style: solid;
       border-width: 0 10px 10px;
-      border-color: #fff transparent;
+      border-color: $background-color transparent;
       display: block;
       z-index: 1;
     }
@@ -494,7 +495,7 @@
   color: $gray;
   text-transform: uppercase;
   letter-spacing: 1px;
-  background-color: #fff;
+  background-color: $background-color;
   border: 1px solid $border-color;
   border-radius: $border-radius;
   box-shadow: $box-shadow;
@@ -518,15 +519,14 @@
   a {
     display: block;
     padding: 0.5rem 1rem;
-    color: $gray;
+    color: $muted-text-color;
     font-size: $type-size-7;
     font-weight: bold;
     line-height: 1.5;
     border-bottom: 1px solid $border-color;
 
     &:hover {
-      color: #000;
-      background: $lighter-gray;
+      color: $text-color;
     }
   }
 
diff --git a/docs/_sass/minimal-mistakes/_notices.scss b/docs/_sass/minimal-mistakes/_notices.scss
index 26afa319..7f9b733f 100644
--- a/docs/_sass/minimal-mistakes/_notices.scss
+++ b/docs/_sass/minimal-mistakes/_notices.scss
@@ -13,6 +13,7 @@
 @mixin notice($notice-color) {
   margin: 2em 0 !important;  /* override*/
   padding: 1em;
+  color: $dark-gray;
   font-family: $global-font-family;
   font-size: $type-size-6 !important;
   text-indent: initial; /* override*/
diff --git a/docs/_sass/minimal-mistakes/_page.scss b/docs/_sass/minimal-mistakes/_page.scss
index 443a0de1..32696229 100644
--- a/docs/_sass/minimal-mistakes/_page.scss
+++ b/docs/_sass/minimal-mistakes/_page.scss
@@ -91,8 +91,7 @@
     }
   }
 
-  a {
-    text-decoration: none;
+  a:not(.btn) {
 
     &:hover {
       text-decoration: underline;
@@ -250,7 +249,7 @@
 
 .page__meta {
   margin-top: 2em;
-  color: mix(#fff, $gray, 25%);
+  color: $muted-text-color;
   font-family: $sans-serif;
   font-size: $type-size-6;
 
@@ -290,7 +289,7 @@
   margin-bottom: 8px;
   padding: 5px 10px;
   text-decoration: none;
-  border: 1px solid $light-gray;
+  border: 1px solid mix(#000, $border-color, 25%);
   border-radius: $border-radius;
 
   &:hover {
@@ -322,8 +321,6 @@
 }
 
 .page__comments-form {
-  padding: 1em;
-  background: $lighter-gray;
   -webkit-transition: $global-transition;
   transition: $global-transition;
 
diff --git a/docs/_sass/minimal-mistakes/_sidebar.scss b/docs/_sass/minimal-mistakes/_sidebar.scss
index 713d5cb5..8e7d70b5 100644
--- a/docs/_sass/minimal-mistakes/_sidebar.scss
+++ b/docs/_sass/minimal-mistakes/_sidebar.scss
@@ -189,7 +189,7 @@
   list-style-type: none;
   border: 1px solid $border-color;
   border-radius: $border-radius;
-  background: #fff;
+  background: $background-color;
   z-index: -1;
   box-shadow: 0 2px 4px 0 rgba(#000, 0.16), 0 2px 10px 0 rgba(#000, 0.12);
   cursor: default;
@@ -234,7 +234,7 @@
     width: 0;
     border-style: solid;
     border-width: 0 10px 10px;
-    border-color: #fff transparent;
+    border-color: $background-color transparent;
     z-index: 1;
 
     @include breakpoint($large) {
diff --git a/docs/_sass/minimal-mistakes/_syntax.scss b/docs/_sass/minimal-mistakes/_syntax.scss
index 089c2467..e7a75540 100644
--- a/docs/_sass/minimal-mistakes/_syntax.scss
+++ b/docs/_sass/minimal-mistakes/_syntax.scss
@@ -19,7 +19,7 @@ figure.highlight {
     top: 0;
     right: 0;
     padding: 0.5em;
-    background-color: $lighter-gray;
+    background-color: $border-color;
     content: "\f121";
     font-family: "fontawesome" !important;
     line-height: 1;
@@ -49,7 +49,7 @@ figure.highlight {
     /* line numbers*/
     &.gutter {
       padding-right: 1em;
-      color: $light-gray;
+      color: rgba($muted-text-color, 0.5);
     }
   }
 
diff --git a/docs/_sass/minimal-mistakes/_tables.scss b/docs/_sass/minimal-mistakes/_tables.scss
index 0c9da82e..05211df0 100644
--- a/docs/_sass/minimal-mistakes/_tables.scss
+++ b/docs/_sass/minimal-mistakes/_tables.scss
@@ -15,8 +15,8 @@ table {
 }
 
 thead {
-  background-color: $lighter-gray;
-  border-bottom: 2px solid $light-gray;
+  background-color: $border-color;
+  border-bottom: 2px solid mix(#000, $border-color, 25%);
 }
 
 th {
@@ -27,7 +27,7 @@ th {
 
 td {
   padding: 0.5em;
-  border-bottom: 1px solid $light-gray;
+  border-bottom: 1px solid mix(#000, $border-color, 25%);
 }
 
 tr,
diff --git a/docs/_sass/minimal-mistakes/_utilities.scss b/docs/_sass/minimal-mistakes/_utilities.scss
index d44e886a..bbc310e8 100644
--- a/docs/_sass/minimal-mistakes/_utilities.scss
+++ b/docs/_sass/minimal-mistakes/_utilities.scss
@@ -57,7 +57,7 @@ body:hover .visually-hidden button {
   background: #fff;
   z-index: 100000;
   text-decoration: none;
-  box-shadow: 0 0 2px 2px rgba(0,0,0,.6);
+  box-shadow: 0 0 2px 2px rgba(0, 0, 0, 0.6);
 }
 
 
@@ -185,7 +185,7 @@ body:hover .visually-hidden button {
 
 .social-icons {
   .fa {
-    color: #000;
+    color: $text-color;
   }
 
   .fa-behance,
diff --git a/docs/_sass/minimal-mistakes/_variables.scss b/docs/_sass/minimal-mistakes/_variables.scss
index 5ded6292..1f3311a1 100644
--- a/docs/_sass/minimal-mistakes/_variables.scss
+++ b/docs/_sass/minimal-mistakes/_variables.scss
@@ -6,125 +6,132 @@
    Typography
    ========================================================================== */
 
-$doc-font-size              : 16 !default;
+$doc-font-size                : 16 !default;
 
 /* paragraph indention */
-$paragraph-indent           : false !default; // true, false (default)
-$indent-var                 : 1.3em !default;
+$paragraph-indent             : false !default; // true, false (default)
+$indent-var                   : 1.3em !default;
 
 /* system typefaces */
-$serif                      : Georgia, Times, serif !default;
-$sans-serif                 : -apple-system, ".SFNSText-Regular", "San Francisco", "Roboto", "Segoe UI", "Helvetica Neue", "Lucida Grande", Arial, sans-serif !default;
-$monospace                  : Monaco, Consolas, "Lucida Console", monospace !default;
+$serif                        : Georgia, Times, serif !default;
+$sans-serif                   : -apple-system, ".SFNSText-Regular", "San Francisco", "Roboto", "Segoe UI", "Helvetica Neue", "Lucida Grande", Arial, sans-serif !default;
+$monospace                    : Monaco, Consolas, "Lucida Console", monospace !default;
 
 /* sans serif typefaces */
-$sans-serif-narrow          : $sans-serif !default;
-$helvetica                  : Helvetica, "Helvetica Neue", Arial, sans-serif !default;
+$sans-serif-narrow            : $sans-serif !default;
+$helvetica                    : Helvetica, "Helvetica Neue", Arial, sans-serif !default;
 
 /* serif typefaces */
-$georgia                    : Georgia, serif !default;
-$times                      : Times, serif !default;
-$bodoni                     : "Bodoni MT", serif !default;
-$calisto                    : "Calisto MT", serif !default;
-$garamond                   : Garamond, serif !default;
+$georgia                      : Georgia, serif !default;
+$times                        : Times, serif !default;
+$bodoni                       : "Bodoni MT", serif !default;
+$calisto                      : "Calisto MT", serif !default;
+$garamond                     : Garamond, serif !default;
 
-$global-font-family         : $sans-serif !default;
-$header-font-family         : $sans-serif !default;
-$caption-font-family        : $serif !default;
+$global-font-family           : $sans-serif !default;
+$header-font-family           : $sans-serif !default;
+$caption-font-family          : $serif !default;
 
 /* type scale */
-$type-size-1                : 2.441em !default;  // ~39.056px
-$type-size-2                : 1.953em !default;  // ~31.248px
-$type-size-3                : 1.563em !default;  // ~25.008px
-$type-size-4                : 1.25em !default;   // ~20px
-$type-size-5                : 1em !default;      // ~16px
-$type-size-6                : 0.75em !default;   // ~12px
-$type-size-7                : 0.6875em !default; // ~11px
-$type-size-8                : 0.625em !default;  // ~10px
+$type-size-1                  : 2.441em !default;  // ~39.056px
+$type-size-2                  : 1.953em !default;  // ~31.248px
+$type-size-3                  : 1.563em !default;  // ~25.008px
+$type-size-4                  : 1.25em !default;   // ~20px
+$type-size-5                  : 1em !default;      // ~16px
+$type-size-6                  : 0.75em !default;   // ~12px
+$type-size-7                  : 0.6875em !default; // ~11px
+$type-size-8                  : 0.625em !default;  // ~10px
 
 
 /*
    Colors
    ========================================================================== */
 
-$gray                       : #7a8288 !default;
-$dark-gray                  : mix(#000, $gray, 40%) !default;
-$darker-gray                : mix(#000, $gray, 60%) !default;
-$light-gray                 : mix(#fff, $gray, 50%) !default;
-$lighter-gray               : mix(#fff, $gray, 90%) !default;
+$gray                         : #7a8288 !default;
+$dark-gray                    : mix(#000, $gray, 40%) !default;
+$darker-gray                  : mix(#000, $gray, 60%) !default;
+$light-gray                   : mix(#fff, $gray, 50%) !default;
+$lighter-gray                 : mix(#fff, $gray, 90%) !default;
 
-$body-color                 : #fff !default;
-$background-color           : #fff !default;
-$code-background-color      : #fafafa !default;
-$code-background-color-dark : $light-gray !default;
-$text-color                 : $dark-gray !default;
-$border-color               : $lighter-gray !default;
+$background-color             : #fff !default;
+$code-background-color        : #fafafa !default;
+$code-background-color-dark   : $light-gray !default;
+$text-color                   : $dark-gray !default;
+$muted-text-color             : mix(#fff, $text-color, 35%);
+$border-color                 : $lighter-gray !default;
+$form-background-color        : $lighter-gray !default;
+$footer-background-color      : $lighter-gray !default;
 
-$primary-color              : #7a8288 !default;
-$success-color              : #62c462 !default;
-$warning-color              : #f89406 !default;
-$danger-color               : #ee5f5b !default;
-$info-color                 : #52adc8 !default;
+$primary-color                : #7a8288 !default;
+$success-color                : #62c462 !default;
+$warning-color                : #f89406 !default;
+$danger-color                 : #ee5f5b !default;
+$info-color                   : #52adc8 !default;
+
+/* YIQ color contrast */
+$yiq-contrasted-dark-default  : $dark-gray !default;
+$yiq-contrasted-light-default : #fff !default;
+$yiq-contrasted-threshold     : 175 !default;
+$yiq-debug                    : false !default;
 
 /* brands */
-$behance-color              : #1769FF !default;
-$bitbucket-color            : #205081 !default;
-$dribbble-color             : #ea4c89 !default;
-$facebook-color             : #3b5998 !default;
-$flickr-color               : #ff0084 !default;
-$foursquare-color           : #0072b1 !default;
-$github-color               : #171516 !default;
-$google-plus-color          : #dd4b39 !default;
-$instagram-color            : #517fa4 !default;
-$lastfm-color               : #d51007 !default;
-$linkedin-color             : #007bb6 !default;
-$pinterest-color            : #cb2027 !default;
-$rss-color                  : #fa9b39 !default;
-$soundcloud-color           : #ff3300 !default;
-$stackoverflow-color        : #fe7a15 !default;
-$tumblr-color               : #32506d !default;
-$twitter-color              : #55acee !default;
-$vimeo-color                : #1ab7ea !default;
-$vine-color                 : #00bf8f !default;
-$youtube-color              : #bb0000 !default;
-$xing-color                 : #006567 !default;
-
+$behance-color                : #1769FF !default;
+$bitbucket-color              : #205081 !default;
+$dribbble-color               : #ea4c89 !default;
+$facebook-color               : #3b5998 !default;
+$flickr-color                 : #ff0084 !default;
+$foursquare-color             : #0072b1 !default;
+$github-color                 : #171516 !default;
+$google-plus-color            : #dd4b39 !default;
+$instagram-color              : #517fa4 !default;
+$lastfm-color                 : #d51007 !default;
+$linkedin-color               : #007bb6 !default;
+$pinterest-color              : #cb2027 !default;
+$rss-color                    : #fa9b39 !default;
+$soundcloud-color             : #ff3300 !default;
+$stackoverflow-color          : #fe7a15 !default;
+$tumblr-color                 : #32506d !default;
+$twitter-color                : #55acee !default;
+$vimeo-color                  : #1ab7ea !default;
+$vine-color                   : #00bf8f !default;
+$youtube-color                : #bb0000 !default;
+$xing-color                   : #006567 !default;
 
 /* links */
-$link-color                 : $info-color !default;
-$link-color-hover           : mix(#000, $link-color, 25%) !default;
-$link-color-visited         : mix(#fff, $link-color, 25%) !default;
-$masthead-link-color        : $primary-color !default;
-$masthead-link-color-hover  : mix(#000, $primary-color, 25%) !default;
-$navicon-link-color-hover   : mix(#fff, $primary-color, 75%) !default;
+$link-color                   : $info-color !default;
+$link-color-hover             : mix(#000, $link-color, 25%) !default;
+$link-color-visited           : mix(#fff, $link-color, 25%) !default;
+$masthead-link-color          : $primary-color !default;
+$masthead-link-color-hover    : mix(#000, $primary-color, 25%) !default;
+$navicon-link-color-hover     : mix(#fff, $primary-color, 75%) !default;
 
 /*
    Breakpoints
    ========================================================================== */
 
-$small                      : 600px !default;
-$medium                     : 768px !default;
-$medium-wide                : 900px !default;
-$large                      : 1024px !default;
-$x-large                    : 1280px !default;
+$small                        : 600px !default;
+$medium                       : 768px !default;
+$medium-wide                  : 900px !default;
+$large                        : 1024px !default;
+$x-large                      : 1280px !default;
 
 
 /*
    Grid
    ========================================================================== */
 
-$right-sidebar-width-narrow : 200px !default;
-$right-sidebar-width        : 300px !default;
-$right-sidebar-width-wide   : 400px !default;
+$right-sidebar-width-narrow   : 200px !default;
+$right-sidebar-width          : 300px !default;
+$right-sidebar-width-wide     : 400px !default;
 
 
 /*
    Other
    ========================================================================== */
 
-$border-radius              : 4px !default;
-$box-shadow                 : 0 1px 1px rgba(0, 0, 0, 0.125) !default;
-$navicon-width              : 1.5rem !default;
-$navicon-height             : 0.25rem !default;
-$global-transition          : all 0.2s ease-in-out !default;
-$intro-transition           : intro 0.3s both !default;
+$border-radius                : 4px !default;
+$box-shadow                   : 0 1px 1px rgba(0, 0, 0, 0.125) !default;
+$navicon-width                : 1.5rem !default;
+$navicon-height               : 0.25rem !default;
+$global-transition            : all 0.2s ease-in-out !default;
+$intro-transition             : intro 0.3s both !default;
diff --git a/docs/_sass/minimal-mistakes/skins/_air.scss b/docs/_sass/minimal-mistakes/skins/_air.scss
new file mode 100644
index 00000000..bdbca84f
--- /dev/null
+++ b/docs/_sass/minimal-mistakes/skins/_air.scss
@@ -0,0 +1,23 @@
+/* ==========================================================================
+   Air skin
+   ========================================================================== */
+
+/* Colors */
+$background-color: #eeeeee !default;
+$text-color: #222831 !default;
+$muted-text-color: #393e46 !default;
+$primary-color: #0092ca !default;
+$border-color: mix(#fff, #393e46, 75%) !default;
+$footer-background-color: $primary-color !default;
+$link-color: #393e46 !default;
+$masthead-link-color: $text-color !default;
+$masthead-link-color-hover: $text-color !default;
+$navicon-link-color-hover: mix(#fff, $text-color, 80%) !default;
+
+.page__footer {
+  color: #fff !important; // override
+}
+
+.page__footer-follow .social-icons .fa {
+  color: inherit;
+}
\ No newline at end of file
diff --git a/docs/_sass/minimal-mistakes/skins/_contrast.scss b/docs/_sass/minimal-mistakes/skins/_contrast.scss
new file mode 100644
index 00000000..431c7131
--- /dev/null
+++ b/docs/_sass/minimal-mistakes/skins/_contrast.scss
@@ -0,0 +1,34 @@
+/* ==========================================================================
+   Contrast skin
+   ========================================================================== */
+
+/* Colors */
+$text-color: #000 !default;
+$muted-text-color: $text-color !default;
+$primary-color: #ff0000 !default;
+$border-color: mix(#fff, $text-color, 75%) !default;
+$footer-background-color: #000 !default;
+$link-color: #0000ff !default;
+$masthead-link-color: $text-color !default;
+$masthead-link-color-hover: $text-color !default;
+$navicon-link-color-hover: mix(#fff, $text-color, 80%) !default;
+
+.page__content {
+
+  .notice,
+  .notice--primary,
+  .notice--info,
+  .notice--warning,
+  .notice--success,
+  .notice--danger {
+    color: $text-color;
+  }
+}
+
+.page__footer {
+  color: #fff !important; // override
+}
+
+.page__footer-follow .social-icons .fa {
+  color: inherit;
+}
\ No newline at end of file
diff --git a/docs/_sass/minimal-mistakes/skins/_dark.scss b/docs/_sass/minimal-mistakes/skins/_dark.scss
new file mode 100644
index 00000000..8ccfc25b
--- /dev/null
+++ b/docs/_sass/minimal-mistakes/skins/_dark.scss
@@ -0,0 +1,24 @@
+/* ==========================================================================
+   Dark skin
+   ========================================================================== */
+
+/* Colors */
+$background-color: #252a34 !default;
+$text-color: #eaeaea !default;
+$primary-color: #00adb5 !default;
+$border-color: mix(#fff, $background-color, 20%) !default;
+$code-background-color: mix(#000, $background-color, 15%) !default;
+$code-background-color-dark: mix(#000, $background-color, 20%) !default;
+$form-background-color: mix(#000, $background-color, 15%) !default;
+$footer-background-color: mix(#000, $background-color, 30%) !default;
+$link-color: mix($primary-color, $text-color, 40%) !default;
+$link-color-hover: mix(#fff, $link-color, 25%) !default;
+$link-color-visited: mix(#000, $link-color, 25%) !default;
+$masthead-link-color: $text-color !default;
+$masthead-link-color-hover: mix(#000, $text-color, 20%) !default;
+$navicon-link-color-hover: mix(#000, $background-color, 30%) !default;
+
+.author__urls.social-icons .fa,
+.page__footer-follow .social-icons .fa {
+  color: inherit;
+}
\ No newline at end of file
diff --git a/docs/_sass/minimal-mistakes/skins/_default.scss b/docs/_sass/minimal-mistakes/skins/_default.scss
new file mode 100644
index 00000000..7489b584
--- /dev/null
+++ b/docs/_sass/minimal-mistakes/skins/_default.scss
@@ -0,0 +1,5 @@
+/* ==========================================================================
+   Default skin
+   ========================================================================== */
+
+// Intentionally left blank
diff --git a/docs/_sass/minimal-mistakes/skins/_dirt.scss b/docs/_sass/minimal-mistakes/skins/_dirt.scss
new file mode 100644
index 00000000..e7993737
--- /dev/null
+++ b/docs/_sass/minimal-mistakes/skins/_dirt.scss
@@ -0,0 +1,15 @@
+/* ==========================================================================
+   Dirt skin
+   ========================================================================== */
+
+/* Colors */
+$background-color: #f3f3f3 !default;
+$text-color: #343434 !default;
+$muted-text-color: #8e8b82 !default;
+$primary-color: #343434 !default;
+$border-color: #e9dcbe !default;
+$footer-background-color: #e9dcbe !default;
+$link-color: #343434 !default;
+$masthead-link-color: $text-color !default;
+$masthead-link-color-hover: $text-color !default;
+$navicon-link-color-hover: mix(#fff, $text-color, 80%) !default;
\ No newline at end of file
diff --git a/docs/_sass/minimal-mistakes/skins/_mint.scss b/docs/_sass/minimal-mistakes/skins/_mint.scss
new file mode 100644
index 00000000..d0e86c8f
--- /dev/null
+++ b/docs/_sass/minimal-mistakes/skins/_mint.scss
@@ -0,0 +1,23 @@
+/* ==========================================================================
+   Mint skin
+   ========================================================================== */
+
+/* Colors */
+$background-color: #f3f6f6 !default;
+$text-color: #40514e !default;
+$muted-text-color: #40514e !default;
+$primary-color: #11999e !default;
+$border-color: mix(#fff, #40514e, 75%) !default;
+$footer-background-color: #30e3ca !default;
+$link-color: #11999e !default;
+$masthead-link-color: $text-color !default;
+$masthead-link-color-hover: $text-color !default;
+$navicon-link-color-hover: mix(#fff, $text-color, 80%) !default;
+
+.page__footer {
+  color: #fff !important; // override
+}
+
+.page__footer-follow .social-icons .fa {
+  color: inherit;
+}
\ No newline at end of file
diff --git a/docs/_sass/minimal-mistakes/skins/_sunrise.scss b/docs/_sass/minimal-mistakes/skins/_sunrise.scss
new file mode 100644
index 00000000..9c3c4d08
--- /dev/null
+++ b/docs/_sass/minimal-mistakes/skins/_sunrise.scss
@@ -0,0 +1,26 @@
+/* ==========================================================================
+   Sunrise skin
+   ========================================================================== */
+
+/* Colors */
+$dark-gray: #0e2431 !default;
+$background-color: #e8d5b7 !default;
+$text-color: #000 !default;
+$muted-text-color: $dark-gray !default;
+$primary-color: #fc3a52 !default;
+$border-color: mix(#000, $background-color, 20%) !default;
+$code-background-color: mix(#fff, $background-color, 20%) !default;
+$code-background-color-dark: mix(#000, $background-color, 10%) !default;
+$form-background-color: mix(#fff, $background-color, 15%) !default;
+$footer-background-color: #f9b248 !default;
+$link-color: mix(#000, $primary-color, 10%) !default;
+$link-color-hover: mix(#fff, $link-color, 25%) !default;
+$link-color-visited: mix(#000, $link-color, 25%) !default;
+$masthead-link-color: $text-color !default;
+$masthead-link-color-hover: mix(#000, $text-color, 20%) !default;
+$navicon-link-color-hover: mix(#000, $background-color, 30%) !default;
+
+.author__urls.social-icons .fa,
+.page__footer-follow .social-icons .fa {
+  color: inherit;
+}
\ No newline at end of file
diff --git a/docs/assets/css/main.scss b/docs/assets/css/main.scss
index 61c73433..23346e77 100644
--- a/docs/assets/css/main.scss
+++ b/docs/assets/css/main.scss
@@ -4,4 +4,5 @@
 
 @charset "utf-8";
 
-@import "minimal-mistakes";
\ No newline at end of file
+@import "minimal-mistakes/skins/{{ site.minimal_mistakes_skin | default: 'default' }}"; // skin
+@import "minimal-mistakes"; // main partials
\ No newline at end of file
diff --git a/docs/assets/images/air-skin-archive-large.png b/docs/assets/images/air-skin-archive-large.png
new file mode 100644
index 00000000..ffb8e882
Binary files /dev/null and b/docs/assets/images/air-skin-archive-large.png differ
diff --git a/docs/assets/images/air-skin-archive.png b/docs/assets/images/air-skin-archive.png
new file mode 100644
index 00000000..4caedd6f
Binary files /dev/null and b/docs/assets/images/air-skin-archive.png differ
diff --git a/docs/assets/images/air-skin-post-large.png b/docs/assets/images/air-skin-post-large.png
new file mode 100644
index 00000000..3ea59681
Binary files /dev/null and b/docs/assets/images/air-skin-post-large.png differ
diff --git a/docs/assets/images/air-skin-post.png b/docs/assets/images/air-skin-post.png
new file mode 100644
index 00000000..65270523
Binary files /dev/null and b/docs/assets/images/air-skin-post.png differ
diff --git a/docs/assets/images/contrast-skin-archive-large.png b/docs/assets/images/contrast-skin-archive-large.png
new file mode 100644
index 00000000..7a1f3e6c
Binary files /dev/null and b/docs/assets/images/contrast-skin-archive-large.png differ
diff --git a/docs/assets/images/contrast-skin-archive.png b/docs/assets/images/contrast-skin-archive.png
new file mode 100644
index 00000000..5e189c18
Binary files /dev/null and b/docs/assets/images/contrast-skin-archive.png differ
diff --git a/docs/assets/images/contrast-skin-post-large.png b/docs/assets/images/contrast-skin-post-large.png
new file mode 100644
index 00000000..01377040
Binary files /dev/null and b/docs/assets/images/contrast-skin-post-large.png differ
diff --git a/docs/assets/images/contrast-skin-post.png b/docs/assets/images/contrast-skin-post.png
new file mode 100644
index 00000000..4923e3ab
Binary files /dev/null and b/docs/assets/images/contrast-skin-post.png differ
diff --git a/docs/assets/images/dark-skin-archive-large.png b/docs/assets/images/dark-skin-archive-large.png
new file mode 100644
index 00000000..4bd931bb
Binary files /dev/null and b/docs/assets/images/dark-skin-archive-large.png differ
diff --git a/docs/assets/images/dark-skin-archive.png b/docs/assets/images/dark-skin-archive.png
new file mode 100644
index 00000000..109f0b70
Binary files /dev/null and b/docs/assets/images/dark-skin-archive.png differ
diff --git a/docs/assets/images/dark-skin-post-large.png b/docs/assets/images/dark-skin-post-large.png
new file mode 100644
index 00000000..c18a7b5b
Binary files /dev/null and b/docs/assets/images/dark-skin-post-large.png differ
diff --git a/docs/assets/images/dark-skin-post.png b/docs/assets/images/dark-skin-post.png
new file mode 100644
index 00000000..a87f9033
Binary files /dev/null and b/docs/assets/images/dark-skin-post.png differ
diff --git a/docs/assets/images/dirt-skin-archive-large.png b/docs/assets/images/dirt-skin-archive-large.png
new file mode 100644
index 00000000..f31ef20f
Binary files /dev/null and b/docs/assets/images/dirt-skin-archive-large.png differ
diff --git a/docs/assets/images/dirt-skin-archive.png b/docs/assets/images/dirt-skin-archive.png
new file mode 100644
index 00000000..0ad8ea45
Binary files /dev/null and b/docs/assets/images/dirt-skin-archive.png differ
diff --git a/docs/assets/images/dirt-skin-post-large.png b/docs/assets/images/dirt-skin-post-large.png
new file mode 100644
index 00000000..62a62b04
Binary files /dev/null and b/docs/assets/images/dirt-skin-post-large.png differ
diff --git a/docs/assets/images/dirt-skin-post.png b/docs/assets/images/dirt-skin-post.png
new file mode 100644
index 00000000..68332de0
Binary files /dev/null and b/docs/assets/images/dirt-skin-post.png differ
diff --git a/docs/assets/images/mint-skin-archive-large.png b/docs/assets/images/mint-skin-archive-large.png
new file mode 100644
index 00000000..06e3b090
Binary files /dev/null and b/docs/assets/images/mint-skin-archive-large.png differ
diff --git a/docs/assets/images/mint-skin-archive.png b/docs/assets/images/mint-skin-archive.png
new file mode 100644
index 00000000..65bc78f0
Binary files /dev/null and b/docs/assets/images/mint-skin-archive.png differ
diff --git a/docs/assets/images/mint-skin-post-large.png b/docs/assets/images/mint-skin-post-large.png
new file mode 100644
index 00000000..82896bc3
Binary files /dev/null and b/docs/assets/images/mint-skin-post-large.png differ
diff --git a/docs/assets/images/mint-skin-post.png b/docs/assets/images/mint-skin-post.png
new file mode 100644
index 00000000..66b1cd11
Binary files /dev/null and b/docs/assets/images/mint-skin-post.png differ
diff --git a/docs/assets/images/sunrise-skin-archive-large.png b/docs/assets/images/sunrise-skin-archive-large.png
new file mode 100644
index 00000000..1c0da1f9
Binary files /dev/null and b/docs/assets/images/sunrise-skin-archive-large.png differ
diff --git a/docs/assets/images/sunrise-skin-archive.png b/docs/assets/images/sunrise-skin-archive.png
new file mode 100644
index 00000000..9fee4e99
Binary files /dev/null and b/docs/assets/images/sunrise-skin-archive.png differ
diff --git a/docs/assets/images/sunrise-skin-post-large.png b/docs/assets/images/sunrise-skin-post-large.png
new file mode 100644
index 00000000..dedbf588
Binary files /dev/null and b/docs/assets/images/sunrise-skin-post-large.png differ
diff --git a/docs/assets/images/sunrise-skin-post.png b/docs/assets/images/sunrise-skin-post.png
new file mode 100644
index 00000000..a672619f
Binary files /dev/null and b/docs/assets/images/sunrise-skin-post.png differ
diff --git a/test/_config.yml b/test/_config.yml
index 667404fe..a4ee25ab 100644
--- a/test/_config.yml
+++ b/test/_config.yml
@@ -6,6 +6,7 @@
 # `jekyll serve`. If you change this file, please restart the server process.
 
 theme                    : "minimal-mistakes-jekyll"
+minimal_mistakes_skin    : "default" # "air", "contrast", "dark", "dirt", "mint", "sunrise"
 
 # Site Settings
 locale                   : "en"
diff --git a/test/_pages/splash-page.md b/test/_pages/splash-page.md
index 59933679..f0cd57b0 100644
--- a/test/_pages/splash-page.md
+++ b/test/_pages/splash-page.md
@@ -24,7 +24,7 @@ feature_row:
     excerpt: "This is some sample content that goes here with **Markdown** formatting."
     url: "#test-link"
     btn_label: "Read More"
-    btn_class: "btn--inverse"
+    btn_class: "btn--primary"
   - image_path: /assets/images/unsplash-gallery-image-3-th.jpg
     title: "Placeholder 3"
     excerpt: "This is some sample content that goes here with **Markdown** formatting."
@@ -35,7 +35,7 @@ feature_row2:
     excerpt: 'This is some sample content that goes here with **Markdown** formatting. Left aligned with `type="left"`'
     url: "#test-link"
     btn_label: "Read More"
-    btn_class: "btn--inverse"
+    btn_class: "btn--primary"
 feature_row3:
   - image_path: /assets/images/unsplash-gallery-image-2-th.jpg
     alt: "placeholder image 2"
@@ -43,7 +43,7 @@ feature_row3:
     excerpt: 'This is some sample content that goes here with **Markdown** formatting. Right aligned with `type="right"`'
     url: "#test-link"
     btn_label: "Read More"
-    btn_class: "btn--inverse"
+    btn_class: "btn--primary"
 feature_row4:
   - image_path: /assets/images/unsplash-gallery-image-2-th.jpg
     alt: "placeholder image 2"
@@ -51,7 +51,7 @@ feature_row4:
     excerpt: 'This is some sample content that goes here with **Markdown** formatting. Centered with `type="center"`'
     url: "#test-link"
     btn_label: "Read More"
-    btn_class: "btn--inverse"
+    btn_class: "btn--primary"
 ---
 
 {% include feature_row id="intro" type="center" %}
diff --git a/test/_posts/2013-01-11-markup-html-tags-and-formatting.md b/test/_posts/2013-01-11-markup-html-tags-and-formatting.md
index 500ccbec..d9cbdb39 100644
--- a/test/_posts/2013-01-11-markup-html-tags-and-formatting.md
+++ b/test/_posts/2013-01-11-markup-html-tags-and-formatting.md
@@ -102,6 +102,17 @@ Do It Live
   3. List item three
   4. List item four
 
+## Forms
+
+<form>
+  <fieldset>
+    <legend>Personalia:</legend>
+    Name: <input type="text" size="30"><br>
+    Email: <input type="text" size="30"><br>
+    Date of birth: <input type="text" size="10">
+  </fieldset>
+</form>
+
 ## Buttons
 
 Make any link standout more when applying the `.btn` class.
@@ -110,7 +121,8 @@ Make any link standout more when applying the `.btn` class.
 <a href="#" class="btn--success">Success Button</a>
 ```
 
-[Primary Button](#){: .btn}
+[Default Button](#){: .btn}
+[Primary Button](#){: .btn .btn--primary}
 [Success Button](#){: .btn .btn--success}
 [Warning Button](#){: .btn .btn--warning}
 [Danger Button](#){: .btn .btn--danger}
@@ -119,7 +131,8 @@ Make any link standout more when applying the `.btn` class.
 [Light Outline Button](#){: .btn .btn--light-outline}
 
 ```markdown
-[Primary Button Text](#link){: .btn}
+[Default Button Text](#link){: .btn}
+[Primary Button Text](#link){: .btn .btn--primary}
 [Success Button Text](#link){: .btn .btn--success}
 [Warning Button Text](#link){: .btn .btn--warning}
 [Danger Button Text](#link){: .btn .btn--danger}
@@ -128,23 +141,38 @@ Make any link standout more when applying the `.btn` class.
 [Light Outline Button](#link){: .btn .btn--light-outline}
 ```
 
-[X-Large Button](#){: .btn .btn--x-large}
-[Large Button](#){: .btn .btn--large}
-[Default Button](#){: .btn}
-[Small Button](#){: .btn .btn--small}
+[X-Large Button](#){: .btn .btn--primary .btn--x-large}
+[Large Button](#){: .btn .btn--primary .btn--large}
+[Default Button](#){: .btn .btn--primary }
+[Small Button](#){: .btn .btn--primary .btn--small}
 
 ```markdown
-[X-Large Button](#link){: .btn .btn--x-large}
-[Large Button](#link){: .btn .btn--large}
-[Default Button](#link){: .btn}
-[Small Button](#link){: .btn .btn--small}
+[X-Large Button](#link){: .btn .btn--primary .btn--x-large}
+[Large Button](#link){: .btn .btn--primary .btn--large}
+[Default Button](#link){: .btn .btn--primary }
+[Small Button](#link){: .btn .btn--primary .btn--small}
 ```
 
 ## Notices
 
-**Watch out!** You can also add notices by appending `{: .notice}` to a paragraph.
+**Watch out!** This paragraph of text has been [emphasized](#) with the `{: .notice}` class.
 {: .notice}
 
+**Watch out!** This paragraph of text has been [emphasized](#) with the `{: .notice--primary}` class.
+{: .notice--primary}
+
+**Watch out!** This paragraph of text has been [emphasized](#) with the `{: .notice--info}` class.
+{: .notice--info}
+
+**Watch out!** This paragraph of text has been [emphasized](#) with the `{: .notice--warning}` class.
+{: .notice--warning}
+
+**Watch out!** This paragraph of text has been [emphasized](#) with the `{: .notice--success}` class.
+{: .notice--success}
+
+**Watch out!** This paragraph of text has been [emphasized](#) with the `{: .notice--danger}` class.
+{: .notice--danger}
+
 ## HTML Tags
 
 ### Address Tag