diff --git a/docs/images/TOTEM_layout.svg b/docs/images/TOTEM_layout.svg
new file mode 100644
index 0000000..0ae1a6d
--- /dev/null
+++ b/docs/images/TOTEM_layout.svg
@@ -0,0 +1,107 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<svg xmlns="http://www.w3.org/2000/svg" width="258.64mm" height="94.36mm" viewBox="0 0 733.16 267.46">
+  <defs>
+    <style>
+      .cls-1 {
+        fill: #161b22;
+      }
+
+      .cls-2 {
+        fill: none;
+        stroke: #58a6ff;
+        stroke-miterlimit: 10;
+        stroke-width: .28px;
+      }
+    </style>
+  </defs>
+  <g id="Shape">
+    <path class="cls-1" d="M.69,160.19l27.77-4.9V14.61c0-1.57,1.27-2.83,2.83-2.83h125.46V.84c0-.46,.38-.84,.84-.84h50.76c.46,0,.84,.38,.84,.84V11.78h135.72c1.57,0,2.83,1.27,2.83,2.83V215.66l15.12,8.73c.4,.23,.54,.74,.31,1.14l-23.97,41.51c-.23,.4-.74,.54-1.14,.31-2.77-1.6-13.03-7.52-21.72-12.54-11.22-6.48-22.44-12.96-47.42-19.65s-37.59-6.69-50.19-6.69c-10.77,0-21.38,0-24.37,0-.46,0-.84-.38-.84-.84v-3.42H31.3c-1.57,0-2.83-1.27-2.83-2.83v-15.72l-19.16,3.38c-.46,.08-.89-.22-.97-.68L.01,161.16c-.08-.46,.22-.89,.68-.97Z"/>
+    <path class="cls-1" d="M732.46,160.19l-27.77-4.9V14.61c0-1.57-1.27-2.83-2.83-2.83h-125.46V.84c0-.46-.38-.84-.84-.84h-50.76c-.46,0-.84,.38-.84,.84V11.78h-135.72c-1.57,0-2.83,1.27-2.83,2.83V215.66l-15.12,8.73c-.4,.23-.54,.74-.31,1.14l23.97,41.51c.23,.4,.74,.54,1.14,.31,2.77-1.6,13.03-7.52,21.72-12.54,11.22-6.48,22.44-12.96,47.42-19.65s37.59-6.69,50.19-6.69c10.77,0,21.38,0,24.37,0,.46,0,.84-.38,.84-.84v-3.42h162.23c1.57,0,2.83-1.27,2.83-2.83v-15.72l19.16,3.38c.46,.08,.89-.22,.97-.68l8.32-47.2c.08-.46-.22-.89-.68-.97Z"/>
+  </g>
+  <g id="Keys_Kopie" data-name="Keys Kopie">
+    <g id="Keycaps">
+      <rect class="cls-2" x="259.97" y="33.02" width="49.61" height="46.77" rx="2.61" ry="2.61"/>
+      <rect class="cls-2" x="259.97" y="81.22" width="49.61" height="46.77" rx="2.61" ry="2.61"/>
+      <rect class="cls-2" x="259.97" y="129.33" width="49.61" height="46.77" rx="2.61" ry="2.61"/>
+      <rect class="cls-2" x="208.96" y="25.42" width="49.61" height="46.77" rx="2.61" ry="2.61"/>
+      <rect class="cls-2" x="208.96" y="73.62" width="49.61" height="46.77" rx="2.61" ry="2.61"/>
+      <rect class="cls-2" x="208.96" y="121.82" width="49.61" height="46.77" rx="2.61" ry="2.61"/>
+      <rect class="cls-2" x="157.96" y="1.41" width="49.61" height="46.77" rx="2.61" ry="2.61"/>
+      <rect class="cls-2" x="157.96" y="49.51" width="49.61" height="46.77" rx="2.61" ry="2.61"/>
+      <rect class="cls-2" x="157.96" y="97.71" width="49.61" height="46.77" rx="2.61" ry="2.61"/>
+      <rect class="cls-2" x="194.74" y="180.27" width="49.61" height="46.77" rx="2.61" ry="2.61"/>
+      <rect class="cls-2" x="99.69" y="30.3" width="49.61" height="46.77" rx="2.61" ry="2.61" transform="translate(-3.44 8.81) rotate(-4)"/>
+      <rect class="cls-2" x="103.09" y="78.41" width="49.61" height="46.77" rx="2.61" ry="2.61" transform="translate(-6.79 9.17) rotate(-4)"/>
+      <rect class="cls-2" x="106.39" y="126.41" width="49.61" height="46.77" rx="2.61" ry="2.61" transform="translate(-10.13 9.52) rotate(-4)"/>
+      <rect class="cls-2" x="42.36" y="74.32" width="49.61" height="46.77" rx="2.61" ry="2.61" transform="translate(-15.95 13.15) rotate(-10)"/>
+      <rect class="cls-2" x="50.66" y="121.83" width="49.61" height="46.77" rx="2.61" ry="2.61" transform="translate(-24.07 15.31) rotate(-10)"/>
+      <rect class="cls-2" x="59.06" y="169.23" width="49.61" height="46.77" rx="2.61" ry="2.61" transform="translate(-32.17 17.49) rotate(-10)"/>
+      <rect class="cls-2" x="252.67" y="186.64" width="46.77" height="49.61" rx="2.61" ry="2.61" transform="translate(.37 423.37) rotate(-75)"/>
+      <rect class="cls-2" x="304.89" y="208.37" width="46.77" height="49.61" rx="2.61" ry="2.61" transform="translate(-37.79 400.88) rotate(-60)"/>
+      <rect class="cls-2" x="4.98" y="156.81" width="49.61" height="46.77" rx="2.61" ry="2.61" transform="translate(-30.84 7.91) rotate(-10)"/>
+    </g>
+    <g>
+      <rect class="cls-2" x="265.63" y="38.69" width="38.27" height="35.43" rx=".95" ry=".95"/>
+      <rect class="cls-2" x="265.63" y="86.89" width="38.27" height="35.43" rx=".95" ry=".95"/>
+      <rect class="cls-2" x="265.63" y="135" width="38.27" height="35.43" rx=".95" ry=".95"/>
+      <rect class="cls-2" x="214.63" y="31.09" width="38.27" height="35.43" rx=".95" ry=".95"/>
+      <rect class="cls-2" x="214.63" y="79.29" width="38.27" height="35.43" rx=".95" ry=".95"/>
+      <rect class="cls-2" x="214.63" y="127.49" width="38.27" height="35.43" rx=".95" ry=".95"/>
+      <rect class="cls-2" x="163.63" y="7.08" width="38.27" height="35.43" rx=".95" ry=".95"/>
+      <rect class="cls-2" x="163.63" y="55.18" width="38.27" height="35.43" rx=".95" ry=".95"/>
+      <rect class="cls-2" x="163.63" y="103.38" width="38.27" height="35.43" rx=".95" ry=".95"/>
+      <rect class="cls-2" x="200.41" y="185.94" width="38.27" height="35.43" rx=".95" ry=".95"/>
+      <rect class="cls-2" x="105.36" y="35.97" width="38.27" height="35.43" rx=".95" ry=".95" transform="translate(-3.44 8.81) rotate(-4)"/>
+      <rect class="cls-2" x="108.76" y="84.07" width="38.27" height="35.43" rx=".95" ry=".95" transform="translate(-6.79 9.17) rotate(-4)"/>
+      <rect class="cls-2" x="112.06" y="132.08" width="38.27" height="35.43" rx=".95" ry=".95" transform="translate(-10.13 9.52) rotate(-4)"/>
+      <rect class="cls-2" x="48.03" y="79.99" width="38.27" height="35.43" rx=".95" ry=".95" transform="translate(-15.95 13.15) rotate(-10)"/>
+      <rect class="cls-2" x="56.33" y="127.5" width="38.27" height="35.43" rx=".95" ry=".95" transform="translate(-24.07 15.31) rotate(-10)"/>
+      <rect class="cls-2" x="64.73" y="174.9" width="38.27" height="35.43" rx=".95" ry=".95" transform="translate(-32.17 17.49) rotate(-10)"/>
+      <rect class="cls-2" x="258.34" y="192.31" width="35.43" height="38.27" rx=".95" ry=".95" transform="translate(.37 423.37) rotate(-75)"/>
+      <rect class="cls-2" x="310.56" y="214.04" width="35.43" height="38.27" rx=".95" ry=".95" transform="translate(-37.79 400.88) rotate(-60)"/>
+      <rect class="cls-2" x="10.65" y="162.48" width="38.27" height="35.43" rx=".95" ry=".95" transform="translate(-30.84 7.91) rotate(-10)"/>
+    </g>
+    <g id="Keycaps-2" data-name="Keycaps">
+      <rect class="cls-2" x="423.36" y="33.02" width="49.61" height="46.77" rx="2.61" ry="2.61"/>
+      <rect class="cls-2" x="423.36" y="81.22" width="49.61" height="46.77" rx="2.61" ry="2.61"/>
+      <rect class="cls-2" x="423.36" y="129.33" width="49.61" height="46.77" rx="2.61" ry="2.61"/>
+      <rect class="cls-2" x="474.36" y="25.42" width="49.61" height="46.77" rx="2.61" ry="2.61"/>
+      <rect class="cls-2" x="474.36" y="73.62" width="49.61" height="46.77" rx="2.61" ry="2.61"/>
+      <rect class="cls-2" x="474.36" y="121.82" width="49.61" height="46.77" rx="2.61" ry="2.61"/>
+      <rect class="cls-2" x="525.36" y="1.41" width="49.61" height="46.77" rx="2.61" ry="2.61"/>
+      <rect class="cls-2" x="525.36" y="49.51" width="49.61" height="46.77" rx="2.61" ry="2.61"/>
+      <rect class="cls-2" x="525.36" y="97.71" width="49.61" height="46.77" rx="2.61" ry="2.61"/>
+      <rect class="cls-2" x="488.59" y="180.27" width="49.61" height="46.77" rx="2.61" ry="2.61"/>
+      <rect class="cls-2" x="585.05" y="28.89" width="46.77" height="49.61" rx="2.61" ry="2.61" transform="translate(512.43 656.9) rotate(-86)"/>
+      <rect class="cls-2" x="581.65" y="76.99" width="46.77" height="49.61" rx="2.61" ry="2.61" transform="translate(461.29 698.25) rotate(-86)"/>
+      <rect class="cls-2" x="578.35" y="124.99" width="46.77" height="49.61" rx="2.61" ry="2.61" transform="translate(410.33 739.61) rotate(-86)"/>
+      <rect class="cls-2" x="642.38" y="72.9" width="46.77" height="49.61" rx="2.61" ry="2.61" transform="translate(453.94 736.4) rotate(-80)"/>
+      <rect class="cls-2" x="634.08" y="120.41" width="46.77" height="49.61" rx="2.61" ry="2.61" transform="translate(400.29 767.48) rotate(-80)"/>
+      <rect class="cls-2" x="625.68" y="167.81" width="46.77" height="49.61" rx="2.61" ry="2.61" transform="translate(346.67 798.38) rotate(-80)"/>
+      <rect class="cls-2" x="432.07" y="188.06" width="49.61" height="46.77" rx="2.61" ry="2.61" transform="translate(-39.16 125.45) rotate(-15)"/>
+      <rect class="cls-2" x="379.85" y="209.78" width="49.61" height="46.77" rx="2.61" ry="2.61" transform="translate(-62.37 233.57) rotate(-30)"/>
+      <rect class="cls-2" x="679.76" y="155.39" width="46.77" height="49.61" rx="2.61" ry="2.61" transform="translate(403.59 841.37) rotate(-80)"/>
+    </g>
+    <g>
+      <rect class="cls-2" x="429.03" y="38.69" width="38.27" height="35.43" rx=".95" ry=".95"/>
+      <rect class="cls-2" x="429.03" y="86.89" width="38.27" height="35.43" rx=".95" ry=".95"/>
+      <rect class="cls-2" x="429.03" y="135" width="38.27" height="35.43" rx=".95" ry=".95"/>
+      <rect class="cls-2" x="480.03" y="31.09" width="38.27" height="35.43" rx=".95" ry=".95"/>
+      <rect class="cls-2" x="480.03" y="79.29" width="38.27" height="35.43" rx=".95" ry=".95"/>
+      <rect class="cls-2" x="480.03" y="127.49" width="38.27" height="35.43" rx=".95" ry=".95"/>
+      <rect class="cls-2" x="531.03" y="7.08" width="38.27" height="35.43" rx=".95" ry=".95"/>
+      <rect class="cls-2" x="531.03" y="55.18" width="38.27" height="35.43" rx=".95" ry=".95"/>
+      <rect class="cls-2" x="531.03" y="103.38" width="38.27" height="35.43" rx=".95" ry=".95"/>
+      <rect class="cls-2" x="494.25" y="185.94" width="38.27" height="35.43" rx=".95" ry=".95"/>
+      <rect class="cls-2" x="590.72" y="34.56" width="35.43" height="38.27" rx=".95" ry=".95" transform="translate(512.44 656.9) rotate(-86)"/>
+      <rect class="cls-2" x="587.32" y="82.66" width="35.43" height="38.27" rx=".95" ry=".95" transform="translate(461.29 698.25) rotate(-86)"/>
+      <rect class="cls-2" x="584.02" y="130.66" width="35.43" height="38.27" rx=".95" ry=".95" transform="translate(410.33 739.61) rotate(-86)"/>
+      <rect class="cls-2" x="648.05" y="78.57" width="35.43" height="38.27" rx=".95" ry=".95" transform="translate(453.93 736.39) rotate(-80)"/>
+      <rect class="cls-2" x="639.75" y="126.08" width="35.43" height="38.27" rx=".95" ry=".95" transform="translate(400.29 767.47) rotate(-80)"/>
+      <rect class="cls-2" x="631.35" y="173.48" width="35.43" height="38.27" rx=".95" ry=".95" transform="translate(346.67 798.37) rotate(-80)"/>
+      <rect class="cls-2" x="437.73" y="193.73" width="38.27" height="35.43" rx=".95" ry=".95" transform="translate(-39.16 125.46) rotate(-15)"/>
+      <rect class="cls-2" x="385.52" y="215.45" width="38.27" height="35.43" rx=".95" ry=".95" transform="translate(-62.37 233.57) rotate(-30)"/>
+      <rect class="cls-2" x="685.43" y="161.06" width="35.43" height="38.27" rx=".95" ry=".95" transform="translate(403.59 841.37) rotate(-80)"/>
+    </g>
+  </g>
+</svg>
\ No newline at end of file
diff --git a/readme.md b/readme.md
index 129f572..7a239b6 100644
--- a/readme.md
+++ b/readme.md
@@ -4,13 +4,14 @@
   <img alt="TOTEM logo font" src="/docs/images/TOTEM_logo_bright.svg">
 </picture>
 
-
 # ZMK CONFIG FOR THE TOTEM SPLIT KEYBOARD
 
-[Here](https://github.com/GEIGEIGEIST/totem) you can find the hardware files and build guide for the TOTEM. 
+[Here](https://github.com/GEIGEIGEIST/totem) you can find the hardware files and build guide.
+[Here](https://github.com/GEIGEIGEIST/qmk-config-totem) you can find the QMK config for the TOTEM.\
 
-TOTEM is 38 keys column-staggered split keyboard running [ZMK](https://zmk.dev/). It's meant to be used with a SEEED XIAO BLE or RP2040.
+TOTEM is 38 keys column-staggered split keyboard running [ZMK](https://zmk.dev/) or [QMK](https://docs.qmk.fm/). It's meant to be used with a SEEED XIAO BLE or RP2040.
 
+![TOTEM layout](/docs/images/TOTEM_layout.svg)