# Reader - Instant Translation Magnifier
> Part of the Platphorm News Network | v3.0.0

## Overview
Reader is a PWA that provides a magical magnifying glass experience for instant text translation. Supports 36+ languages, 8 vernacular packs (tech, crypto, legal, medical, finance, gaming, gen-z, academic), and special creative modes including ASCII art.

## Quick Start
- Homepage: https://reader.platphormnews.com
- Demo: https://reader.platphormnews.com/demo
- API Docs: https://reader.platphormnews.com/api/docs

## API Endpoints

### Translation
POST /api/v1/translate
- Translates text between 36+ languages
- Supports vernacular packs for subject-specific translations
- Includes sign language symbols, emoji, dictionary, docs enrichment
- Request: { text, source?, target, vernacular?, enrich?, ascii?, insights? }
- Response: { translatedText, confidence, signLanguage?, emoji?, dictionary?, docs?, ascii?, insights? }

### Health
GET /api/health
- Service health check with dependency status

### Documentation  
GET /api/docs
- OpenAPI 3.0 specification

## Supported Languages (36+)
- Standard: en, es, fr, de, pt, zh, ja, ko, ar, hi, ru, it, nl, pl, tr, vi, th, id, ms, he, uk, sv, da, fi, no, cs, el, ro, hu, bn, ta, te, mr, ur, fa, sw
- Special: platphorm (ASCII Art), asl (Sign Language), simple (Easy Read)

## Vernacular Packs
Subject-specific translation overlays:
- tech: Software development (func, var, repo, config)
- crypto: Blockchain (BTC, HODL, wagmi, gm)
- legal: Legal terms (def., atty., Corp.)
- medical: Healthcare (Rx, Dx, ICU)
- finance: Financial (Q, YoY, ROI, IPO)
- gaming: Video games (gg, afk, NPC, OP)
- gen-z: Internet slang (sus, fr fr, bussin)
- academic: Research (e.g., i.e., et al.)

## Architecture
Single source of truth: lib/languages.ts
- Add languages: Add to LANGUAGE_REGISTRY array
- Add vernaculars: Add to VERNACULAR_PACKS array
- Add translations: Add to TRANSLATION_MATRICES object
- Everything auto-wires throughout the app

## Integrations (Trusted CORS)
- ASCII Art: ascii.platphormnews.com/api
- Insights: insights.platphormnews.com/api/v1
- Dictionary: dictionary.platphormnews.com/api/v1
- Docs: docs.platphormnews.com/api/v1
- Emoji: emoji.platphormnews.com/api/v1
- Sign Language: universal-sign-language.platphormnews.com/api/v1

## Features
- 36+ languages with auto-detection
- 8 vernacular packs for subject matter
- Platphorm mode (ASCII art + insights)
- Spring physics magnifier animations
- Offline fallback translations
- PWA installable
- Mobile-first responsive
- Full accessibility support

## For More Details
See /llms-full.txt for complete documentation
See /llms-index.json for structured API reference