diff --git a/IMAGES/badges-back.jpg b/IMAGES/badges-back.jpg
new file mode 100644
index 000000000..866278c8a
Binary files /dev/null and b/IMAGES/badges-back.jpg differ
diff --git a/IMAGES/badges-connected.jpg b/IMAGES/badges-connected.jpg
new file mode 100644
index 000000000..b51cac43d
Binary files /dev/null and b/IMAGES/badges-connected.jpg differ
diff --git a/IMAGES/badges-front.jpg b/IMAGES/badges-front.jpg
new file mode 100644
index 000000000..11c19824f
Binary files /dev/null and b/IMAGES/badges-front.jpg differ
diff --git a/IMAGES/io-expander.jpg b/IMAGES/io-expander.jpg
new file mode 100644
index 000000000..699ed3bea
Binary files /dev/null and b/IMAGES/io-expander.jpg differ
diff --git a/README.md b/README.md
new file mode 100644
index 000000000..8802bcab4
--- /dev/null
+++ b/README.md
@@ -0,0 +1,34 @@
+# BornHack 2023 NFC Badges
+
+![BornHack 2023 NFC Badges](https://github.com/bornhack/badge2023/raw/main/IMAGES/badges-back.jpg "BornHack 2023 NFC Badges")
+
+With this years badges, we are taking a look at NFC. There will be two badges, one that is a tag (using the NXP NTAG I2C Plus chip), and another with an NFC reader (using NXP PN7150), that can also do card emulation.
+
+The reader badge sports an RP2040 dualcore Cortex M0+ microcontroller from Raspberry Pi and 16MB of Quad SPI flash for code and data files, to handle USB connection and general application control.
+
+The reader badge will come with [CircuitPython](https://circuitpython.org/) preloaded, for a very low barrier of entry, all you need is a USB-C cable, and your favourite texteditor and you are ready for NFC hacking.
+
+## CircuitPython restore file
+
+If you flash the board with something else and want to get back to CircuitPython, you can bring the badge into the UF2 bootloader by holding the BOOT button and pressing RESET (you can also hold BOOT when powering on). The badge will then show up as a mass storage device called something like RP2-? which is the build in bootloader and you simply copy over the [firmware.uf2](https://github.com/bornhack/badge2023/raw/main/firmware.uf2) file from the root of this repository. The badge will reboot, and you are then back to CircuitPython
+
+The original python files that was on the badge when handed out are in the [cp-init branch](https://github.com/bornhack/badge2023/tree/cp-init)
+
+## Designed in KiCad v7
+
+This board is designed in KiCad v7. To open the project, you will need to install a recent release version or one of the nightly builds, KiCad v5 og v6 won't open this design. The [reader schematic as a PDF](https://github.com/bornhack/badge2023/raw/main/nfc_reader/nfc_reader_schematics.pdf) and the [tag schematic as a PDF](https://github.com/bornhack/badge2023/raw/main/nfc_card_emulation_large/nfc_card_emulation_large_schematics.pdf) are included for reference.
+
+## Projects running on the badge
+
+Feel free to submit a PR adding on to this list with your project that runs on the badge.
+
+- _project name and linkto more info_
+
+## License
+
+The contents of this repository is released under the following license:
+
+* the "Creative Commons Attribution-ShareAlike 4.0 International License"
+  (CC BY-SA 4.0) full text of this license is included in the LICENSE file
+  and a copy can also be found at
+  [http://creativecommons.org/licenses/by-sa/4.0/](http://creativecommons.org/licenses/by-sa/4.0/)