diff --git a/README.md b/README.md
new file mode 100644
index 0000000..aa6130d
--- /dev/null
+++ b/README.md
@@ -0,0 +1,18 @@
+## Render [item borders](<https://www.curseforge.com/minecraft/mc-mods/item-borders>) in modded storage screens.  
+### Supported mods:
+-  Applied Energistics 2
+-  Refined Storage
+-  Sophisticated Storage
+-  RFTools
+-  Mekanism QIO
+-  Integrated Dynamics
+-  Colossal Chests
+-  Tom's Storage
+-  Simple Storage Network
+
+### Additionally it adds borders to vault hunters items:
+- Gear items have a border based on rarity
+- Jewels have a border based on rarity (can be changed to show jewel color instead)
+- Trinkets have a border based their color
+- Charms have a border based on their tier
+