1 files changed, 59 insertions, 0 deletions

diff --git a/keyboards/readme.md b/keyboards/readme.md
new file mode 100644
index 0000000000..9ee3fc7abc
--- /dev/null
+++ b/keyboards/readme.md
@@ -0,0 +1,59 @@
+# Included Keyboards
+QMK runs on a diverse range of keyboards. Some of these keyboards are officially supported and see constant community contributions, while others are part of the repository for historical reasons.
+
+## Official QMK Keyboards
+
+These keyboards are manufactured by the maintainers of QMK.
+
+### Ortholinear Keyboards - Jack Humbert
+
+What makes OLKB keyboards shine is a combo of lean aesthetics, compact size, and killer tactile feel. These are available through [olkb.com](http://olkb.com) as well as through [Massdrop](http://massdrop.com) from time to time, as easy to assemble kits.
+
+* [Planck](/keyboards/planck/) — A 40% DIY powerhouse of customizability and modification capability. It's a lean, mean, typing machine.
+* [Preonic](/keyboards/preonic/) — Like the Planck, but bigger. 50%.
+* [Atomic](/keyboards/atomic/) — Imagine the size of the Planck. Now imagine the size of the Preonic. Now imagine _bigger_. That is the Atomic. A 60% keyboard.
+
+### ErgoDox EZ - Erez Zukerman
+
+Made in Taiwan using advanced robotic manufacturing, the ErgoDox EZ is a fully-assembled, premium ergonomic keyboard. Its split design allows you to place both halves shoulder width, and its custom-made wrist rests and tilt/tent kit make for incredibly comfortable typing. Available on [ergodox-ez.com](https://ergodox-ez.com).
+
+* [ErgoDox EZ](/keyboards/ergodox/) — Our one and only product. Yes, it's that awesome. Comes with either printed or blank keycaps, and 7 different keyswitch types.
+
+### Clueboard - Zach White
+
+Designed and built in Felton, CA, Clueboards keyboard emphasize quality and locally sourced components, available on [clueboard.co](http://clueboard.co)
+
+* [Clueboard](/keyboards/clueboard/) — The 66% custom keyboard.
+* [Cluecard](/keyboards/cluecard/) — A small board to help you hack on QMK.
+* [Cluepad](/keyboards/cluepad/) — A mechanical numpad with QMK superpowers.
+
+
+## Community-supported QMK Keyboards
+
+These keyboards are part of the QMK repository, but their manufacturers are not official maintainers of the repository.
+
+* [Alps64](/keyboards/alps64) — A 60% keyboard for Alps keyswitches.
+* [AMJ60](/keyboards/amj60) — DIY/Assembled compact 60% keyboard.
+* [Arrow Pad](/keyboards/arrow_pad) — A custom creation by IBNobody.
+* [Atreus](/keyboards/atreus) — Made by Technomancy.
+* [Bantam44](/keyboards/bantam44) — It is a 44-key 40% staggered keyboard.
+* [Ergodox Infinity](/keyboards/ergodox) - Ergonomic Split Keyboard by Input Club.
+* [GH60](/keyboards/gh60) — A 60% Geekhack community-driven project.
+* [GON NerD](/keyboards/gonnerd) — Korean custom 60% PCB
+* [Happy Hacking Keyboard](/keyboards/hhkb) — The Happy Hacking keyboard can be hacked with a custom controller to run QMK.
+* [Infinity 60%](/keyboards/infinity60) - — Compact community keyboard by Input Club.
+* [JD45](/keyboards/jd45) — Another Geekhack community project, designed by jdcarpe.
+* [KBD75](/keyboards/kbd75) — A 75% keyboard made by made by KBDFans.
+* [KC60](/keyboards/kc60) — A programmable Chinese-made keyboard, lost in the mists of time.
+* [Kinesis Advantage](/keyboards/kinesis) — Contoured ergonomic keyboard by Kinesis Computer Ergonomics.
+* [KMAC](/keyboards/kmac) — Korean custom keyboard.
+* [The Kitten Paw](/keyboards/kitten_paw) — A replacement controller (2016 revision) for the Filco Majestouch by [Bathroom Epiphanies](https://github.com/BathroomEpiphanies).
+* [Lets Split](/keyboards/lets_split) - Split ortholinear 40% keyboard.
+* [Phantom](/keyboards/phantom) — A tenkeyless kit by Teel, also from Geekhack.
+* [Retro Refit](/keyboards/retro_refit) — Another creation by IBNobody.
+* [S60-x](/keyboards/s60-x) — DIY compact keyboard designed by VinnyCordeiro for Sentraq.
+* [Satan](/keyboards/satan) — A GH60 variant.
+* [SixKeyBoard](/keyboards/sixkeyboard) — A 6-key keyboard made by TechKeys.
+* [TheVan 44](/keyboards/tv44) — A 44-key staggered keybard by Evangs.
+* [WhiteFox](/keyboards/whitefox) — A 65% keyboard designed as a partnership by matt3o, Massdrop and Input Club
+* [Vision Division](/keyboards/vision_division) — Full Size / Split Linear Keyboard by IBNobody.