# Reader - Complete LLM Documentation
> Instant Translation Magnifier | Platphorm News Network

## Service Information
- Name: Reader
- Domain: reader.platphormnews.com
- Version: 2.0.0
- Status: Active
- Category: Accessibility, Translation, PWA
- Sub-Category: MCP, API
- Score: 6.9
- meta-category: news, humans, llms, space, sports, jobs, fashion, health, fitness, tech 


## Description
Reader provides a delightful magnifying glass experience for instant text translation. Users move their cursor or finger over any text, and a beautiful glass morphism magnifier appears showing the real-time translation, dictionary definitions, related documentation, sign language symbols, and emoji context. It auto-detects the user's browser language and integrates with the full Platphorm News Network ecosystem.

## Core Features

### Magnifying Glass UX
- Follows cursor on desktop, finger on mobile
- Glass morphism design with blur effects
- Animated transitions and hover states
- Configurable size and appearance
- Pulse glow animation when translating

### Translation Engine
- Auto-detects source language from text patterns
- Auto-detects browser language for smart defaults
- Supports 12 major world languages
- Word-by-word translation with confidence scoring
- Dictionary enrichment via dictionary.platphormnews.com
- Documentation lookup via docs.platphormnews.com
- Caches translations for performance
- Debounced API calls (100ms) for smooth UX

### Accessibility
- Sign language symbols via Universal Sign Language API
- Emoji context via Platphorm Emoji Score API
- WCAG 2.1 AA compliant
- Screen reader support
- Reduced motion support
- High contrast mode compatible

## API Reference

### POST /api/v1/translate
Translate text between supported languages.

Request Body:
```json
{
  "text": "Hello world",
  "source": "en",
  "target": "es"
}
```

Response:
```json
{
  "originalText": "Hello world",
  "translatedText": "Hola mundo",
  "sourceLanguage": "en",
  "targetLanguage": "es",
  "confidence": 0.95,
  "signLanguage": {
    "symbols": ["👋", "🌍"],
    "description": "Sign for hello and world"
  },
  "emoji": {
    "emoji": "👋",
    "name": "Waving Hand",
    "category": "People & Body"
  },
  "timestamp": "2026-03-17T12:00:00.000Z"
}
```

### GET /api/v1/translate
Get service info and supported languages.

Response:
```json
{
  "status": "ok",
  "service": "translate",
  "version": "1.0.0",
  "supportedLanguages": ["en", "es", "fr", "de", "pt", "zh", "ja", "ko", "ar", "hi", "ru", "it"],
  "integrations": {
    "signLanguage": "https://universal-sign-language.platphormnews.com",
    "emoji": "https://emoji.platphormnews.com/api/mcp"
  }
}
```

### GET /api/health
Health check endpoint with dependency status.

Response:
```json
{
  "api": "ok",
  "timestamp": "2026-03-17T12:00:00.000Z",
  "version": "1.0.0",
  "uptime": 3600,
  "dependencies": {
    "signLanguage": { "status": "ok", "latency": 45 },
    "emoji": { "status": "ok", "latency": 32 },
    "network": { "status": "ok", "latency": 28 }
  },
  "latency": 120
}
```

### GET /api/docs
OpenAPI 3.0 specification for all endpoints.

### GET /api/v1/network
Platphorm News Network graph filtered for Reader-relevant services.

## Supported Languages
| Code | Name | Flag |
|------|------|------|
| en | English | US |
| es | Español | ES |
| fr | Français | FR |
| de | Deutsch | DE |
| pt | Português | BR |
| zh | 中文 | CN |
| ja | 日本語 | JP |
| ko | 한국어 | KR |
| ar | العربية | SA |
| hi | हिन्दी | IN |
| ru | Русский | RU |
| it | Italiano | IT |

## Network Integrations

### Dictionary API
- Endpoint: https://dictionary.platphormnews.com/api/v1
- Purpose: Community-driven term definitions
- Features: Phonetics, parts of speech, localized definitions
- 10 language support
- llms.txt: https://dictionary.platphormnews.com/llms.txt

### OpenDocs API
- Endpoint: https://docs.platphormnews.com/api/v1
- MCP: https://docs.platphormnews.com/api/mcp
- Purpose: Related documentation lookup
- 26 MCP tools available
- llms.txt: https://docs.platphormnews.com/llms.txt

### Universal Sign Language API
- Endpoint: https://universal-sign-language.platphormnews.com
- Purpose: Accessibility symbols for translated text
- 200+ symbols across 15 categories
- ISO standard compliant

### Emoji Score API (MCP)
- Endpoint: https://emoji.platphormnews.com/api/mcp
- Protocol: Model Context Protocol 1.0
- Purpose: Contextual emoji for translations
- 3,900+ Unicode 17.0 emoji

### Platphorm News Network
- Endpoint: https://platphormnews.com/api/network/graph
- Purpose: Service discovery and integration
- 84+ network sites

## Technical Stack
- Framework: Next.js 16 (App Router)
- Language: TypeScript
- Styling: Tailwind CSS 4
- UI: shadcn/ui components
- Animations: Framer Motion
- PWA: Web App Manifest, Service Worker ready
- Hosting: Vercel

## Rate Limits
- Translation: 100 requests/minute per IP
- Health: Unlimited
- Docs: Unlimited

## Authentication
Currently open API. API keys planned for v2.

## Webhooks
Not yet implemented. Planned for v2.

## Events
Not yet implemented. Event stream planned for v2.

## Error Codes
- 400: Invalid request (missing text, text too long)
- 500: Translation service error
- 502: Upstream service unavailable
- 503: Service degraded (dependency issues)

## Contact
- Website: https://platphormnews.com
- Email: api@platphormnews.com
- Network: https://platphormnews.com/api/network/graph