diff --git a/README.md b/README.md
new file mode 100644
index 0000000..8e4d30d
--- /dev/null
+++ b/README.md
@@ -0,0 +1,29 @@
+## Day 1: ls-clone
+
+A tiny **C** program that mimics `ls` but adds a splash of colour and emojis to make directory listings.
+
+The project is part of a personal coding challenge: Write a small C Programm Every Day (I have Time)
+
+---
+
+### Features
+
+- Lists files in the current directory (or a path passed as an argument).  
+- Detects file type by extension and applies colour + emoji.  
+- Works on Linux/macOS (uses `dirent.h` and ANSI escape codes).  
+- No external dependencies – just the C standard library.  
+
+---
+
+### Build & Install
+
+```bash
+# Clone the repo
+git clone 
+cd ls-clone-emoji-color
+
+# Compile (requires Unix)
+gcc -o ls-clone main.c
+
+# Optionally move to a directory in your PATH
+sudo mv ls-clone /usr/local/bin/