diff --git a/README.md b/README.md
index c29312a..777543f 100644
--- a/README.md
+++ b/README.md
@@ -2,6 +2,9 @@
 
 A partitioned‑model PHP ORM (DTO/DAO) with Query Builder, relations, raw SQL helpers, and a portable migrations + schema builder. Namespace: `Pairity\`. Package: `getphred/pairity`.
 
+![CI](https://github.com/getphred/pairity/actions/workflows/ci.yml/badge.svg)
+![Packagist](https://img.shields.io/packagist/v/getphred/pairity.svg)
+
 ## Contributing
 
 This is an early foundation. Contributions, discussions, and design proposals are welcome. Please open an issue to coordinate larger features.
diff --git a/composer.json b/composer.json
index c7e1d3d..c699bbb 100644
--- a/composer.json
+++ b/composer.json
@@ -1,11 +1,42 @@
 {
   "name": "getphred/pairity",
-  "description": "Partitioned-model PHP ORM (DTO/DAO), Query Builder, Raw SQL, multi-DB via PDO.",
+  "description": "DAO/DTO-centric PHP ORM with Query Builder, relations (SQL + MongoDB), migrations/CLI, Unit of Work, and event system. Supports MySQL/MariaDB, PostgreSQL, SQLite, SQL Server, Oracle, and MongoDB.",
   "type": "library",
   "license": "MIT",
   "authors": [
-    { "name": "Pairity Contributors" }
+    {
+      "name": "Phred",
+      "email": "phred@getphred.com",
+      "homepage": "https://getphred.com",
+      "role": "Owner"
+    }
   ],
+  "keywords": [
+    "php",
+    "orm",
+    "dao",
+    "dto",
+    "query builder",
+    "migrations",
+    "schema builder",
+    "relations",
+    "unit of work",
+    "events",
+    "pdo",
+    "mysql",
+    "mariadb",
+    "postgresql",
+    "sqlite",
+    "sqlserver",
+    "oracle",
+    "mongodb",
+    "nosql"
+  ],
+  "homepage": "https://github.com/getphred/pairity",
+  "support": {
+    "issues": "https://github.com/getphred/pairity/issues",
+    "source": "https://github.com/getphred/pairity"
+  },
   "require": {
     "php": ">=8.1",
     "ext-mongodb": "*",