OneByJorah · Sep 13, 2026 · Sep 13, 2026
@@ -1,149 +1,65 @@
-<div align="center">
+# ChatForge
 
-![ChatForge banner](docs/assets/banner.svg)
+> Edge-native AI chat reference implementation — a single Cloudflare Worker serving a streaming SSE chat UI powered by Workers AI, with no origin server and no API key to manage.
 
-# ChatForge
+[![License](https://img.shields.io/github/license/OneByJorah/ChatForge?style=for-the-badge&color=FFB300&labelColor=0a0a09)](https://github.com/OneByJorah/ChatForge)
+[![Top Language](https://img.shields.io/github/languages/top/OneByJorah/ChatForge?style=for-the-badge&color=FFB300&labelColor=0a0a09)](https://github.com/OneByJorah/ChatForge)
+[![Stars](https://img.shields.io/github/stars/OneByJorah/ChatForge?style=for-the-badge&color=FFB300&labelColor=0a0a09)](https://github.com/OneByJorah/ChatForge/stargazers)
+[![Last Commit](https://img.shields.io/github/last-commit/OneByJorah/ChatForge?style=for-the-badge&color=FFB300&labelColor=0a0a09)](https://github.com/OneByJorah/ChatForge/commits)
 
-**Edge-native AI chat interface** — a single Cloudflare Worker serving a streaming chat UI powered by Workers AI, with no origin server.
+![ChatForge chat UI](.github/screenshots/main.png)
+[![CI](https://img.shields.io/github/actions/workflow/status/OneByJorah/ChatForge/ci.yml?style=for-the-badge&color=FFB300&labelColor=0a0a09&label=ci)](https://github.com/OneByJorah/ChatForge/actions/workflows/ci.yml)
 
-<a href="https://github.com/OneByJorah/ChatForge/stargazers"><img src="https://img.shields.io/github/stars/OneByJorah/ChatForge?style=flat-square" alt="Stars"></a>
-<a href="https://github.com/OneByJorah/ChatForge/commits"><img src="https://img.shields.io/github/last-commit/OneByJorah/ChatForge?style=flat-square" alt="Last commit"></a>
-<img src="https://img.shields.io/github/license/OneByJorah/ChatForge?style=flat-square" alt="License">
-<img src="https://img.shields.io/badge/TypeScript-3178C6?style=flat-square&logo=typescript&logoColor=white" alt="TypeScript">
-<img src="https://img.shields.io/badge/Cloudflare%20Workers-F38020?style=flat-square&logo=cloudflare&logoColor=white" alt="Cloudflare Workers">
-<img src="https://img.shields.io/badge/streaming-SSE-6366f1?style=flat-square" alt="SSE streaming">
+![ChatForge UI](docs/screenshots/chatforge-ui.png)
 
-![ChatForge screenshot](docs/assets/screenshot.png)
+## What This Is
 
-</div>
+ChatForge is a reference implementation of an edge-hosted chat app: a static frontend plus a streaming `/api/chat` endpoint, both running inside one Cloudflare Worker and calling Workers AI through a binding. There is no backend server, no API key, and no regional infrastructure — just a clean starting point to fork and extend. It is intentionally minimal: no authentication, no persistence, no rate limiting; chat history lives in browser memory and resets on refresh. See [docs/ARCHITECTURE.md](docs/ARCHITECTURE.md) for the production upgrade path.
 
 ## Quick Start
 
 ```bash
 git clone https://github.com/OneByJorah/ChatForge.git
 cd ChatForge
-npm install
-npx wrangler login
+npm install && npx wrangler login
 npm run dev
 ```
 
 Open **http://localhost:8787**. Run `npm run deploy` to publish to Cloudflare Workers.
 
-## What This Is
-
-ChatForge is a reference implementation of an edge-hosted chat app: a static frontend plus a streaming `/api/chat` endpoint, both running inside one Cloudflare Worker and calling Workers AI through a binding. There is no backend server, no API key to manage, and no cold-start regional infrastructure. It exists as a clean starting point you can fork and extend for your own product.
-
-> [!NOTE]
-> ChatForge is intentionally minimal: **no authentication, no persistence, and no rate limiting**. Chat history lives in browser memory and resets on refresh. See [docs/ARCHITECTURE.md](docs/ARCHITECTURE.md) for the production upgrade path.
-
 ## Features
 
-- **Workers AI inference** — runs `@cf/meta/llama-3.1-8b-instruct-fp8` at the edge with no API keys.
-- **Real-time streaming** — Server-Sent Events (SSE) deliver tokens as they are generated.
-- **Single-Worker deploy** — frontend and API ship together with one `wrangler deploy`.
-- **Framework-free frontend** — vanilla HTML/CSS/JS keeps the whole UI small.
-- **Security headers** — CSP, HSTS, `X-Frame-Options`, `nosniff`, referrer, and permissions policies on every response.
-- **Input validation** — server-side limits on message shape, count (max 100), and length (max 32,000 chars).
-- **Swappable model** — change `MODEL_ID` in `src/index.ts` to any Workers AI text-generation model.
-- **Docker preview** — serve the static UI locally with `docker compose up` for a quick look.
+- Workers AI inference with `@cf/meta/llama-3.1-8b-instruct-fp8` at the edge.
+- Server-Sent Events streaming — tokens arrive as they are generated.
+- Single-Worker deploy: frontend and API ship together with one `wrangler deploy`.
+- Framework-free vanilla HTML/CSS/JS frontend.
+- Security headers on every response: CSP, HSTS, `X-Frame-Options`, `nosniff`, referrer and permissions policies.
+- Server-side input limits on message shape, count (max 100), and length (max 32,000 chars).
+- Swappable model via `MODEL_ID` in `src/index.ts`.
+- Docker preview of the static UI with `docker compose up` (the `/api/chat` endpoint requires `wrangler dev` or a deployed Worker for the AI binding).
 
 ## Architecture
 
 ```
 Browser ──SSE──▶ Cloudflare Worker (src/index.ts)
                      │
-                     ├── GET /* ──▶ env.ASSETS.fetch() ──▶ public/ (static files)
+                     ├── GET /* ──▶ env.ASSETS.fetch() ──▶ public/ (static)
                      │
-                     └── POST /api/chat ──▶ env.AI.run() ──▶ Workers AI (Llama 3.1 8B)
+                     └── POST /api/chat ──▶ env.AI.run() ──▶ Workers AI
                                                  │
                                                  └── text/event-stream response
 ```
 
-Chat history is kept in browser memory only. The Worker is stateless.
-
-## API
-
-| Endpoint | Method | Description |
-|----------|--------|-------------|
-| `/api/chat` | `POST` | Send `{ "messages": [...] }`, receive an SSE-streamed reply |
-| `/*` (non-API) | `GET` | Static frontend from `public/` |
-
-Errors: `400` invalid JSON/messages, `405` wrong method, `404` unknown API route, `500` AI failure. Full details in [docs/API.md](docs/API.md).
-
-## Configuration
-
-No runtime secrets are needed — the AI binding is declared in [`wrangler.jsonc`](wrangler.jsonc). Deployment credentials are read from the environment (never committed):
-
-| Variable | Required | Description |
-|----------|----------|-------------|
-| `CLOUDFLARE_API_TOKEN` | For deploy | Cloudflare API token used by Wrangler |
-| `CLOUDFLARE_ACCOUNT_ID` | For deploy | Cloudflare account ID |
-
-See [.env.example](.env.example).
-
-## Supported Models
-
-| Provider | Model |
-|----------|-------|
-| **Cloudflare Workers AI** | `@cf/meta/llama-3.1-8b-instruct-fp8` (default, swappable via `MODEL_ID` in [src/index.ts](src/index.ts)) |
-
-Browse the [Workers AI model catalog](https://developers.cloudflare.com/workers-ai/models/) — any text-generation model ID can be dropped in.
-
-## Docker Preview
-
-```bash
-docker compose up -d   # http://localhost:8787
-```
-
-> [!WARNING]
-> The Docker image previews only the static frontend. The `/api/chat` endpoint requires `wrangler dev` or a deployed Worker because it depends on the `env.AI` binding.
-
-## Use Cases
-
-1. **Starter template** — fork it as the base for a custom edge chat product.
-2. **Learning Workers AI** — see streaming, bindings, and security headers in ~one file.
-3. **Internal tools** — deploy a no-backend assistant for quick Q&A.
-4. **Prototyping** — test prompts against Llama 3.1 at the edge with zero infrastructure.
+Chat history is kept in browser memory only; the Worker is stateless.
 
-## Tech Stack
+## Stack
 
-Cloudflare Workers, Workers AI, TypeScript, vanilla HTML/CSS/JS, Server-Sent Events, Wrangler, Vitest, Docker (nginx:alpine preview).
-
-## Screenshots
-
-| View | Preview |
-|------|---------|
-| Chat UI | ![ChatForge UI](docs/screenshots/chatforge-ui.png) |
-| Conversation | ![ChatForge conversation](docs/screenshots/chat-conversation.png) |
-| Mobile | ![ChatForge mobile view](docs/screenshots/main.mobile.png) |
-| Main viewport | ![ChatForge main view](docs/screenshots/main.viewport.png) |
-
-## Project Structure
-
-```
-ChatForge/
-├── src/                # Worker source
-│   ├── index.ts        # Routing + chat API
-│   ├── types.ts        # Type definitions
-│   └── __tests__/      # Vitest suite
-├── public/             # index.html + chat.js
-├── wrangler.jsonc      # Cloudflare config
-├── Dockerfile          # Static UI preview image
-├── docker-compose.yml  # Local static preview
-├── docs/               # API.md, ARCHITECTURE.md, assets
-└── package.json
-```
+Cloudflare Workers · Workers AI · TypeScript · vanilla HTML/CSS/JS · Server-Sent Events · Wrangler · Vitest · Docker (nginx:alpine preview).
 
 ## Contributing
 
-Contributions are welcome. Please read [CONTRIBUTING.md](CONTRIBUTING.md) and [CODE_OF_CONDUCT.md](CODE_OF_CONDUCT.md), then [open an issue](https://github.com/OneByJorah/ChatForge/issues) or a pull request.
+See [CONTRIBUTING.md](CONTRIBUTING.md) and [CODE_OF_CONDUCT.md](CODE_OF_CONDUCT.md). [Open an issue](https://github.com/OneByJorah/ChatForge/issues) or a pull request.
 
 ## License
 
 MIT — see [LICENSE](LICENSE).
-
-## Connect
-
-- [jorahone.com](https://jorahone.com)
-- [GitHub Org](https://github.com/OneByJorah)
-- [info@jorahone.com](mailto:info@jorahone.com)