Add requirements.txt, CI, and real sample output to the README

Author: Vijay Vardhan Kondani

.github/workflows/ci.yml

@@ -0,0 +1,24 @@
+name: CI
+
+on:
+  push:
+    branches: [main]
+  pull_request:
+    branches: [main]
+
+jobs:
+  build:
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v4
+
+      - uses: actions/setup-python@v5
+        with:
+          python-version: "3.11"
+          cache: "pip"
+
+      - name: Install dependencies
+        run: pip install -r requirements.txt
+
+      - name: Compile check
+        run: python -m compileall -q .

README.md

@@ -1,9 +1,20 @@
 # PinForge
 
+[![CI](https://github.com/vijaxx/pinforge/actions/workflows/ci.yml/badge.svg)](https://github.com/vijaxx/pinforge/actions/workflows/ci.yml)
+![Python](https://img.shields.io/badge/python-3.11-blue)
+[![License: MIT](https://img.shields.io/badge/license-MIT-green)](LICENSE)
+
 A small pipeline that turns one word-search theme into a sellable digital product line: a print-ready PDF pack, a set of Pinterest pin creatives, SEO copy for each pin, and a manifest tying it all together — then posts the pins and tracks how they perform.
 
 Pinterest is used here as a free, search-driven discovery channel (pins rank in search for months, no audience required, no per-listing fees) that feeds a Gumroad storefront. It's built to run unattended: given a theme name it renders puzzles, builds the PDF, generates pin art, writes SEO copy, and can post directly through an attached Chrome session.
 
+## Sample output
+
+<table><tr>
+<td><img src="docs/sample-pin.png" width="320" alt="Sample Pinterest pin"><br><sub>A generated Pinterest pin — real puzzle grid, not a mockup</sub></td>
+<td><img src="docs/sample-cover.png" width="320" alt="Sample Gumroad cover"><br><sub>Storefront cover art for the same product</sub></td>
+</tr></table>
+
 ## How it fits together
 
 ```
@@ -31,6 +42,7 @@ Python, Pillow (pin rendering), reportlab + pypdf (PDF generation/merging), SQLi
 ## Running it
 
 ```
+pip install -r requirements.txt
 python3 factory.py --theme animals      # build one product line
 python3 factory.py --all                # build every configured theme
 ./ensure_chrome_pinforge.sh             # bring up the dedicated Chrome profile

docs/sample-cover.png

@@ -0,0 +1,4 @@
+Pillow
+pypdf
+reportlab
+websocket-client