From ca9848a535f86bb11eccbaa83958f322ecc3449d Mon Sep 17 00:00:00 2001
From: default <me@psmattas.com>
Date: Thu, 19 Feb 2026 20:19:20 +0000
Subject: [PATCH] EC-21: FEAT: Added new PHP package and initialized the repo

Refers Evercatch/evercatch-board#21
---
 README.md      | 38 ++++++++++++++++++++++++--------------
 composer.json  | 20 ++++++++++++++++++++
 src/Client.php | 11 +++++++++++
 3 files changed, 55 insertions(+), 14 deletions(-)
 create mode 100644 composer.json
 create mode 100644 src/Client.php

diff --git a/README.md b/README.md
index 788863e..67a93af 100644
--- a/README.md
+++ b/README.md
@@ -1,22 +1,26 @@
-# 📦 Repository Name
+# 📦 Evercatch PHP
 
-> Short one-line description of what this repository does.
+> Official PHP SDK for Evercatch webhook infrastructure platform.
 
 ---
 
 ## 🧭 Overview
 
-Describe what this service/module is responsible for within the Evercatch platform.
+This repository contains the official PHP SDK for the Evercatch platform. Its purpose is to provide a simple and convenient interface for developers to interact with the Evercatch API, manage webhooks, and handle events within their PHP applications.
+
+**⚠️ This SDK is currently under active development and is not yet ready for production use. The package published on Packagist is a placeholder to reserve the name.**
 
 ---
 
 ## 🛠️ Tech Stack
 
+The final technology stack is being determined. The planned stack is as follows:
+
 | Layer | Technology |
 | :--- | :--- |
-| Language | — |
-| Framework | — |
-| Key Dependencies | — |
+| Language | PHP |
+| Framework | None (Standard Library + Minimal Dependencies) |
+| Key Dependencies | `curl` or `guzzle` (for HTTP), `Zod` (for data models) |
 
 ---
 
@@ -24,21 +28,27 @@ Describe what this service/module is responsible for within the Evercatch platfo
 
 ### Prerequisites
 
-- Docker & Docker Compose
-- Node.js / Python (specify version)
+- PHP 8.0+
+
+### Installation (Future)
+
+Once released, the package will be available on Packagist:
+```bash
+# This will not work until the first official release
+composer require evercatch/evercatch
+```
 
 ### Local Development
 
+The repository can be cloned for contribution or testing once development is further along.
+
 ```bash
 # Clone the repo
-git clone https://git.psmattas.com/Evercatch/REPO_NAME.git
-cd REPO_NAME
+git clone https://git.psmattas.com/Evercatch/evercatch-php.git
 
-# Copy environment variables
-cp .env.example .env
+cd evercatch-php
 
-# Start services
-docker compose up -d
+# Note: The project is not yet functional.
 ```
 
 ---
diff --git a/composer.json b/composer.json
new file mode 100644
index 0000000..69ba468
--- /dev/null
+++ b/composer.json
@@ -0,0 +1,20 @@
+{
+    "name": "evercatch/evercatch-php",
+    "description": "Evercatch SDK for PHP (Coming Soon)",
+    "type": "library",
+    "license": "MIT",
+    "authors": [
+        {
+            "name": "Evercatch",
+            "email": "support@evercatch.dev"
+        }
+    ],
+    "require": {
+        "php": ">=8.0"
+    },
+    "autoload": {
+        "psr-4": {
+            "Evercatch\": "src/"
+        }
+    }
+}
diff --git a/src/Client.php b/src/Client.php
new file mode 100644
index 0000000..0862189
--- /dev/null
+++ b/src/Client.php
@@ -0,0 +1,11 @@
+<?php
+namespace Evercatch;
+
+// Coming Soon
+// Official PHP SDK for Evercatch
+// Expected launch: Q2 2026
+// Visit https://evercatch.dev
+
+class Client {
+    const VERSION = '0.0.1';
+}