diff --git a/README.MD b/README.MD
index e69de29..63bf073 100644
--- a/README.MD
+++ b/README.MD
@@ -0,0 +1,50 @@
+# 🧩 Member DB (Golang)
+
+A lightweight and efficient **member management system** written in **Go**.  
+This project provides a RESTful API to perform essential operations like:
+
+✅ **Add and manage members**  
+📅 **Track member attendance at events**  
+🗺️ **Record member excursions and outings**
+
+Ideal for small organizations, clubs, or community groups looking for a minimal yet effective backend to handle membership data.
+
+---
+
+## 🚀 Features
+
+- ⚡ Built using **Go** for high performance and simplicity  
+- 🌐 **RESTful API** endpoints  
+- 🧱 Modular structure for easy expansion  
+- 🪶 Lightweight — no unnecessary dependencies  
+
+---
+
+## 🎯 Use Cases
+
+- 🏫 Club membership tracking  
+- 🗓️ Attendance records for events, meetings, or workshops  
+- 🧭 Excursion or trip logging for community groups  
+
+---
+
+## 🛠️ Tech Stack
+
+- **Language:** Go (Golang)  
+- **Architecture:** RESTful API  
+- **Storage:** (Add your DB here, e.g., SQLite, PostgreSQL, or in-memory)  
+- **Deployment:** Runs easily on any Go-supported environment  
+
+---
+
+## 📦 Getting Started
+
+### Prerequisites
+- Go 1.24.5+ installed  
+
+### Installation
+```bash
+git clone https://gitea.tecamino.com/paadi/memberDB.git
+cd memberDB
+go mod tidy
+go run main.go