# PlatPhorm News Layout
> Built for machines to read, networks to share, and humans to understand. News for 8 billion people.

## Overview
Name: PlatPhorm News Layout
URL: https://layout.platphormnews.com
Version: 0.0.1
Type: Reusable Next.js Layout System
License: MIT
Repository: https://github.com/mbarbine/nextjs-shared-layout

## How to Clone This Layout
1. One-click deploy: https://vercel.com/new/clone?repository-url=https://github.com/mbarbine/nextjs-shared-layout
2. Open in v0: https://v0.dev/chat?q=Clone%20the%20PlatPhorm%20Layout%20from%20github.com/mbarbine/nextjs-shared-layout
3. Git clone: git clone https://github.com/mbarbine/nextjs-shared-layout my-site
4. npx: npx create-next-app@latest -e https://github.com/mbarbine/nextjs-shared-layout

## Description
This is the universal shared layout for all PlatPhorm News network sites. It provides:
- Responsive header with network navigation, search, theme toggle, locale switcher, and auth
- 4-column footer with network links, app links, legal, and jobs board
- Full i18n support for 8 languages via next-intl
- Complete observability via trace.platphormnews.com
- Feature flags for runtime configuration
- Secret PH3AR command palette (type "PH3AR" anywhere)
- WCAG 2.2 AA accessibility compliance

## Intended Use
- Clone for new PlatPhorm News network sites
- Reference architecture for AI-first layouts
- Template for multi-tenant news/content platforms
- Example of modern Next.js 16 patterns

## Internationalization
Supported Locales: en (English), es (Español), fr (Français), de (Deutsch), pt (Português), zh (中文), ja (日本語), ko (한국어)
Routing: URL-based (/[locale]/path)
Detection: Browser preference with cookie persistence

## API Endpoints
GET /api/health - Health check with version and uptime
POST /api/indexnow - Trigger IndexNow for URL indexing
GET /api/docs - OpenAPI documentation (coming soon)

## Discovery Files
GET /llms.txt - This file (summary)
GET /llms-full.txt - Extended documentation
GET /llms-index.json - Structured JSON index
GET /robots.txt - Crawler directives
GET /sitemap.xml - XML sitemap with hreflang
GET /humans.txt - Team and technology credits
GET /rss.xml - RSS 2.0 feed
GET /feed.xml - Atom 1.0 feed

## Feature Flags (Currently Enabled)
🎨 🎨 Theme Toggle: Dark/light/system mode switcher in top bar
🌐 🌐 Locale Switcher: Language dropdown supporting 8 locales
🔍 🔍 Search Bar: Collapsible search input in top bar
📰 📰 Network Drawer: Hamburger menu with network publication links
🔐 🔐 Auth Menu: User authentication dropdown menu
🚀 🚀 Deploy Buttons: Vercel, v0, and GitHub deploy/clone buttons
🔮 🔮 Secret Menu: Hidden menu activated by typing PH3AR or 5x theme toggle
👻 👻 PH3AR Modal: Command palette with dev tools and network utilities
🔎 🔎 Trace Provider: Full observability with correlation IDs and breadcrumbs
📈 📈 Analytics: Vercel Analytics integration
⚡ ⚡ Speed Insights: Vercel Speed Insights for performance monitoring
🍞 🍞 Breadcrumbs: User journey tracking for debugging
🖐️ 🖐️ Fingerprinting: Privacy-respecting browser fingerprint for session correlation
📡 📡 IndexNow: Instant search engine indexing via IndexNow protocol
🤖 🤖 LLMs.txt: LLM discovery files for AI systems
📡 📡 RSS Feed: RSS 2.0 and Atom feed generation
🗺️ 🗺️ Sitemap: XML sitemap generation for search engines
👤 👤 Humans.txt: humans.txt file with team and technology credits
🤖 🤖 Robots.txt: robots.txt with AI-friendly directives
🔗 🔗 MCP: Model Context Protocol configuration endpoint
🌐 🌐 Network API: PlatPhorm News network API integration
🔗 🔗 Trace API: Integration with trace.platphormnews.com
🎨 🎨 SVG Service: Integration with svg.platphormnews.com for icons and images

## Technology Stack
- Next.js 16 (App Router, React 19)
- TypeScript 5.6
- Tailwind CSS 4.0
- shadcn/ui components
- next-intl for i18n
- @floating-ui/react for tooltips
- Vercel Analytics + Speed Insights

## Structured Data
This site provides JSON-LD schemas for:
- Organization (Platphorm News Network)
- WebSite (with SearchAction)
- WebPage (per-page metadata)
- BreadcrumbList (navigation context)
- Article/NewsArticle (content pages)
- FAQPage (help content)
- SoftwareApplication (API documentation)

## Authentication
- Public: Read access to all content
- Network Auth: Via network.platphormnews.com SSO
- API Keys: For write operations (x-api-key header)

## Rate Limits
- Anonymous: 100 requests/minute
- Authenticated: 1000 requests/minute
- IndexNow: 10 URLs/request, 100 requests/day

## Distributed Tracing (PlatPhorm Network)
Trace Server: trace.platphormnews.com
Headers propagated across network:
- x-trace-id: UUID correlation ID
- x-span-id: Current span identifier
- x-parent-span-id: Parent span for nested calls
- traceparent: W3C Trace Context format
- x-bot-id: AI agent identification
- x-network-origin: Origin site in network
- x-layout-version: Layout version (0.0.1)

## CORS Policy
All API endpoints are open for AI agents:
- Access-Control-Allow-Origin: *
- Access-Control-Allow-Methods: GET, POST, OPTIONS
- Exposed Headers: X-Trace-Id, X-Request-Id, X-RateLimit-Remaining

## Contact
Website: https://platphormnews.com
Support: support@platphormnews.com
GitHub: https://github.com/platphormnews
Twitter: @platphormnews

## Sponsorship
ETH/Polygon: 0x30589F2e1B8E9a48BBb2c66Ac012FE7ED2A7eB85

---
Generated: 2026-05-09T21:11:01.967Z