diff --git a/readme.md b/readme.md
new file mode 100644
index 0000000..ed2072c
--- /dev/null
+++ b/readme.md
@@ -0,0 +1,57 @@
+
+```markdown
+# Push a Project to GitPasha
+
+## 1. Create a New Repository
+- Go to **GitPasha** website.
+- Create a new repository (e.g., `linux-commands`).
+- Copy the repository URL (HTTPS).
+
+---
+
+## 2. Navigate to Your Project Folder
+
+```bash
+cd path/to/folder
+````
+
+---
+
+## 3. Initialize Git Locally
+
+```bash
+git init
+git add .
+git commit -m "first commit"
+```
+
+---
+
+## 4. Connect to the Remote Repository (GitPasha)
+
+```bash
+git remote add origin <repo link>
+```
+
+---
+
+## 5. Push Files to GitPasha
+
+### If your branch is `master`:
+
+```bash
+git push -u origin master
+```
+
+### If your branch is `main`:
+
+```bash
+git branch -M main
+git push -u origin main
+```
+
+---
+
+## Notes
+
+* The first time you push using HTTPS, Git will ask for your **GitPasha username and password*