1 files changed, 21 insertions, 0 deletions

diff --git a/keyboards/alf/x2/readme.md b/keyboards/alf/x2/readme.md
new file mode 100644
index 000000000..671155a34
--- /dev/null
+++ b/keyboards/alf/x2/readme.md
@@ -0,0 +1,21 @@
+# X2
+
+![x2](https://cdn.shopify.com/s/files/1/1674/0405/products/1_088c2862-1f68-4fdd-a346-965208c3a3de_1024x1024.png?v=1511296076)
+
+A customizable 60% keyboard.
+
+* Keyboard Maintainer: [The QMK Community](https://github.com/qmk)
+* Hardware Supported: ALF X2 60%
+* Hardware Availability: [zFrontier](https://en.zfrontier.com/products/group-buy-alf-x2-60)
+
+Make example for this keyboard (after setting up your build environment):
+
+    make alf/x2:default
+
+Flashing example for this keyboard:
+
+    make alf/x2:default:flash
+
+To reset the board into bootloader mode, hold Space+B while plugging it in.
+
+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).