diff --git a/keyboards/bm40rgb/readme.md b/keyboards/bm40rgb/readme.md
new file mode 100644
index 00000000000..de93ee05fc9
--- /dev/null
+++ b/keyboards/bm40rgb/readme.md
@@ -0,0 +1,25 @@
+# BM40 RGB
+
+An ortholinear 40% hotswap keyboard with per-key RGB in-switch LEDs and RGB Backlighting, from KP Republic.
+
+* Keyboard Maintainer: [rgoulter](https://github.com/rgoulter)
+* Hardware Supported: BM40 RGB
+* Hardware Availability: [KP Republic](https://kprepublic.com/products/bm40-rgb-40-hot-swap-custom-mechanical-keyboard-pcb-qmk-underglow-type-c-planck)
+
+[![](https://rgoulter.com/images/keyboards/bm40rgb/bm40rgb.jpg)](https://rgoulter.com/images/keyboards/bm40rgb/bm40rgb_large.jpg)
+
+Default layout:
+
+[![](https://rgoulter.com/images/keyboards/bm40rgb-default-keymap.png)](http://www.keyboard-layout-editor.com/#/gists/27b44fbd9eb7e41c56febe06f0d8589e)
+
+Supported layouts:
+
+* `ortho_4x12`
+
+* `planck_mit`
+
+Make example for this keyboard (after setting up your build environment):
+
+    make bm40rgb:default
+
+See the [build environment setup](https://docs.qmk.fm/#/getting_started_build_tools) and the [make instructions](https://docs.qmk.fm/#/getting_started_make_guide) for more information. Brand new to QMK? Start with our [Complete Newbs Guide](https://docs.qmk.fm/#/newbs).