# 🎨 ASCII Art Converter — llms-full.txt
# 📚 Extended machine-readable context document (llmstxt.org)
# 🗓️ Last updated: 2026-02-20
# 🏗️ Version: 2.0.0

> 🎨 ASCII Art Converter is a real-time, browser-based image-to-ASCII tool.
> 🛠️ Built with Next.js 15, React 19, Tailwind CSS, HTML5 Canvas.
> 🔗 Root domain: https://ascii.platphormnews.com
> 🤖 MCP-enabled with 7 tools (convert_image, get_health, get_info, list_charsets, subscribe_webhook, list_webhooks, register_site)
> 🌐 MCP Hub: https://mcp.platphormnews.com | Hub Docs: https://mcp.platphormnews.com/api/docs
> 🌐 Part of PlatPhorm News network (130+ sites)
> 👤 Created by Michael Barbine — Michael@Barbineworldwide.com — @BigNerdLoLz

---

## 🏗️ Architecture

- **Framework:** Next.js 15+ (App Router, React Server Components)
- **UI:** React 19, Tailwind CSS v3, Radix UI primitives
- **Rendering:** HTML5 Canvas for real-time ASCII preview
- **Styling:** Dark-mode optimized, stone color palette
- **Hosting:** Vercel (Edge Network)
- **Analytics:** @vercel/analytics (privacy-first)

---

## 🗺️ Route Map

| Route | Description |
|-------|-------------|
| `/` | 🏠 Home — ASCII Art Converter with upload, preview, controls |
| `/docs` | 📖 Documentation — usage guide, API reference, character sets |
| `/api/convert` | 🔄 POST — Convert image (base64) to ASCII art |
| `/api/health` | 💚 GET — Health check with dependency status |
| `/api/docs` | 📖 GET — OpenAPI documentation (JSON) |
| `/api/mcp` | 🤖 POST/GET — Model Context Protocol endpoint (6 tools) |
| `/api/webhooks` | 🔔 GET/POST/DELETE — Webhook management |
| `/sitemap.xml` | 🗺️ XML Sitemap |
| `/robots.txt` | 🤖 Crawl directives |
| `/llms.txt` | 🤖 LLM context (short) |
| `/llms-full.txt` | 📚 LLM context (extended) |
| `/.well-known/mcp.json` | 🔧 MCP discovery manifest |

---

## 🎨 Core Features

### Image to ASCII Conversion
- Upload via file picker or drag & drop
- Adjustable resolution (0.05 — 0.30 scale factor)
- 4 character sets:
  - **Standard:** ` .:-=+*#%@`
  - **Detailed:** ` .,:;i1tfLCG08@`
  - **Blocks:** ` ░▒▓█`
  - **Minimal:** ` .:█`
- Grayscale and color modes
- Invert colors toggle
- Real-time canvas rendering
- Copy to clipboard
- Download as .txt file

### Accessibility (W3C WCAG 2.1 AA)
- Skip navigation link
- ARIA labels on all interactive controls
- Semantic HTML5 structure
- Keyboard navigable
- Focus indicators
- Screen reader compatible
- High contrast dark mode

---

## 🤖 MCP Tool Manifest

**Endpoint:** POST https://ascii.platphormnews.com/api/mcp
**Auth:** none (public, read-only tools)
**Protocol:** MCP 2025-03-26 (JSON-RPC 2.0)
**Hub:** https://mcp.platphormnews.com (central MCP registry)
**Hub Docs:** https://mcp.platphormnews.com/api/docs
**Handshake:** initialize → notifications/initialized → tools/list → tools/call

### Tools
1. `convert_image(image_base64, resolution, charset, grayscale, inverted)` — Convert a base64-encoded image to ASCII art
2. `get_health()` — Health check with uptime, version, and service status
3. `get_info()` — Get info about the ASCII converter service, features, and network
4. `list_charsets()` — List all available character sets with descriptions
5. `subscribe_webhook(url, events, secret)` — Register a webhook for event notifications
6. `list_webhooks()` — List all registered webhooks and their status
7. `register_site(force)` — Register this site with the central MCP hub at mcp.platphormnews.com
---

## 🔔 Webhooks

**Endpoint:** https://ascii.platphormnews.com/api/webhooks

### Register (POST)

    POST /api/webhooks
    { "url": "https://example.com/hook", "events": ["conversion.completed"], "secret": "optional-hmac-secret" }

### List (GET)

    GET /api/webhooks
    GET /api/webhooks?id=wh_xxx

### Delete (DELETE)

    DELETE /api/webhooks?id=wh_xxx

### Events
- `conversion.started` — Image conversion initiated
- `conversion.completed` — ASCII art successfully generated
- `conversion.failed` — Conversion error
- `health.degraded` — Service degradation detected
- `health.restored` — Service restored to healthy

### Payload Format

    {
      "event": "conversion.completed",
      "timestamp": "2026-02-20T12:00:00Z",
      "webhook_id": "wh_xxx",
      "payload": { ... }
    }

### Security
- HMAC-SHA256 signature via `X-Webhook-Signature: sha256=...` header
- Auto-disable after 10 consecutive failures
- 10s request timeout
- HTTPS required (except localhost)
---

## 🌐 PlatPhorm News Network

ASCII Art Converter is part of the **PlatPhorm News** network of 130+ sites under platphormnews.com:

- 🏠 **PlatPhorm News:** https://www.platphormnews.com — Real-time HackerNews aggregator
- 🏘️ **PH3AR Community:** https://ph3ar.com — Community hub
- 🎮 **QuakeJS Arena:** https://quake.platphormnews.com — Browser-based FPS
- 🤖 **MCP Server:** https://mcp.platphormnews.com — 41 tools, 12 resources
- 🤖 **MCP Hub:** https://mcp.platphormnews.com — Central MCP registry for the network
- 📚 **MCP Hub Docs:** https://mcp.platphormnews.com/api/docs
- 📝 **Blog:** https://blog.ph3ar.com — Tech blog
- 🎨 **ASCII Converter:** https://ascii.platphormnews.com — This site
- 📊 **Network Graph:** https://www.platphormnews.com/api/network/graph

See https://www.platphormnews.com/network.manifest for the full list.

---

## 🔍 SEO & Structured Data

- ✅ JSON-LD: WebApplication + Organization + BreadcrumbList
- ✅ Open Graph tags (title, description, type, locale)
- ✅ Twitter Card (summary_large_image)
- ✅ Canonical URL
- ✅ robots.txt with LLM/MCP crawler directives
- ✅ XML Sitemap
- ✅ llms.txt + llms-full.txt (llmstxt.org)
- ✅ MCP well-known discovery
- ✅ Dublin Core metadata
- ✅ Viewport & theme-color meta
- ✅ FAQPage schema
- ✅ AI/LLM discovery link tags
- ✅ Web App Manifest

---

## 👤 Contact & Community

- 🌐 Site: https://ascii.platphormnews.com
- 🏠 Network: https://www.platphormnews.com
- 🏘️ Community: https://ph3ar.com
- 📝 Blog: https://blog.ph3ar.com
- ✍️ Author: Michael Barbine
- 📧 Email: Michael@Barbineworldwide.com
- 🐙 GitHub: https://github.com/mbarbine
- 🐦 Twitter/X: @BigNerdLoLz

---

## ⚖️ License

MIT License © 2026 Michael Barbine / PlatPhorm News.