diff --git a/README.md b/README.md
new file mode 100644
index 0000000..ecc84df
--- /dev/null
+++ b/README.md
@@ -0,0 +1,24 @@
+Copyright (C) 2024 The LineageOS Project
+
+Device configuration for Xiaomi 12S Pro
+=========================================
+
+The Xiaomi 12S Pro (codenamed _"unicorn"_) is a high-end smartphone from Xiaomi.
+
+It was released in July 2023.
+
+## Device specifications
+
+Basic   | Spec Sheet
+-------:|:-------------------------
+Platform | Snapdragon® 8+ Gen 1 (SM8475)
+RAM & Storage | 8GB/128GB, 8GB/256GB, 12GB/256GB, 12GB/512GB, 12GB/512GB (LPDDR5 RAM, UFS 3.1 storage)
+Shipped Android Version | 13
+Battery | Non-removable, 4600 mAh
+Display | 6.73″, LTPO 120Hz, 3200x1440 (522 ppi)
+Rear camera | 6.73″, LTPO 120Hz, 3200x1440 (522 ppi)
+Front camera | 32MP in-display
+
+## Device picture
+
+![Xiaomi 12S Pro](https://cdn.cnbj0.fds.api.mi-img.com/b2c-shopapi-pms/pms_1656916280.45314622.png "Xiaomi 12S Pro in white")
\ No newline at end of file