diff --git a/README.md b/README.md
index eab6606..d3b1637 100644
--- a/README.md
+++ b/README.md
@@ -1,3 +1,10 @@
-# arabic-geo
+# Arabic Geo | بيانات جغرافية عربية
 
-بيانات جغرافية للوطن العربي - Arab world geo datasets & API
\ No newline at end of file
+Arab world geo data: 20 countries with capitals, coordinates, population.
+
+```python
+from geo_data import ARAB_COUNTRIES, total_population
+print(f'{len(ARAB_COUNTRIES)} countries, {total_population():.1f}M people')
+```
+
+Built on GitPasha
\ No newline at end of file