diff --git a/readme.md b/readme.md
new file mode 100644
index 0000000..f842bab
--- /dev/null
+++ b/readme.md
@@ -0,0 +1,24 @@
+# 📝 Qiki Pages Template Repository
+
+Welcome to the **Qiki Pages Template** repository! This repository contains a customizable template for creating Qiki pages in markup format.
+
+## 🎯 Purpose
+
+This template is designed to help you quickly create structured, well-organized Qiki pages with sections for titles, headers, lists, links, and more. It provides a consistent starting point for creating new content in Qiki.
+
+## 📄 Template Overview
+
+The template includes:
+- **Title and Metadata** 🏷️
+- **Introduction Section** ✨
+- **Multiple Content Sections with Headings** 🧩
+- **Lists (Ordered and Unordered)** 📋
+- **Code Snippets** 💻
+- **Links and References** 🔗
+- **Conclusion Section** 🔚
+
+## 🚀 How to Use
+
+1. Clone the repository:
+   ```bash
+   git clone https://github.com/yourusername/qiki-pages-template.git