# PlatPhorm Layout
> Canonical public layout design, responsive grid builder, page composition, visual structure inspector, scoring, export, and MCP/API layout tooling for the PlatPhormNews web mesh.

Base URL: https://layout.platphormnews.com
Version: 0.7.0
Public access: enabled for browser-local Layout building, templates, preview, deterministic scoring, config audits, exports, discovery, health, and read-only MCP introspection.
Protected actions: PLATPHORM_API_KEY is required for server mutations, trusted-domain remote inspection, IndexNow submission, reporting, integration triggers, and administrative refresh.

## Layout Capabilities
- Templates: 15 active public templates (article-brief, dashboard-command, card-grid, form-flow, docs-layout, gallery-wall, landing-system, news-feed, faq-knowledge, product-service, status-page, api-docs, mcp-capability, network-directory, report-page)
- Viewports: narrow, mobile, tablet, desktop, wide
- Scoring: deterministic, explainable, modelAssisted=false
- Audits: deterministic config audit is public; trusted-domain DOM inspection is bounded and requires PLATPHORM_API_KEY; BrowserOps screenshots remain unsupported
- Exports: json, html-css, react-tailwind, markdown, design-spec-json, report, spec
- Local persistence: browser-local IndexedDB for non-sensitive drafts; durable server persistence is unsupported and DATABASE_URL alone does not change that state.
- Model scaffolding: unsupported (No server-side model handler is implemented. Layout guidance uses deterministic checks only.)

## API and MCP
- API docs: https://layout.platphormnews.com/api/docs and https://layout.platphormnews.com/openapi.yaml
- MCP metadata: https://layout.platphormnews.com/api/mcp
- MCP JSON-RPC: POST https://layout.platphormnews.com/api/mcp
- MCP tools: 27 real Layout tools
- MCP resources: 12
- MCP prompts: 11

## Route Compliance
- Implemented route inventory: 49/49
- Degraded states: Server-side persistence is not implemented; browser-local drafts are active and protected server records are ephemeral.; Model suggestions are unsupported; deterministic guidance is active.; Protected cross-site execution and publishing integrations are unsupported; no downstream artifact or run is claimed.

## Integrations
- Phorm: unsupported; Phorm handoff is not implemented. Configuration alone does not constitute execution.
- BrowserOps: unsupported; BrowserOps execution is not implemented. No browser run is created by Layout.
- Docs: unsupported; Docs publishing is not implemented. No document artifact is created.
- Decks: unsupported; Deck generation is not implemented. No deck artifact is created.
- Sheets: unsupported; Sheets reporting is not implemented. No sheet artifact is created.
- Insights: unsupported; Insights handoff is not implemented. No downstream score or ranking is claimed.
- Trace: degraded; Trace headers and public links are active. Public-safe server request journeys are exported when PLATPHORM_API_KEY is configured and otherwise report disabled.

## Trust and Trace
Trusted domains default to *.platphormnews.com. Layout operations propagate W3C trace context and safe PlatPhorm headers. Secrets are not included in exports, local drafts, RSS, sitemap, llms files, model prompts, screenshots, or traces.

Updated: 2026-08-07T21:37:04.838Z


## Public Pages
- /: Layout workbench home
- /builder: Responsive layout builder
- /templates: Public layout template library
- /preview: Viewport and responsive preview
- /score: Deterministic layout scoring
- /audit: URL/config layout audit
- /export: JSON, HTML/CSS, React/Tailwind, Markdown, design spec, and report export
- /gallery: Public layout examples
- /docs: Human documentation
- /faq: Layout FAQ
- /privacy: Privacy policy
- /terms: Terms of use

## REST Endpoints
- GET /api/health: Standard public-safe health summary; boundary=public-safe
- GET /api/v1/health: Versioned public-safe health summary; boundary=public-safe
- GET /api/docs: OpenAPI 3.1 JSON document; boundary=public-safe
- GET /api/v1/templates: List real public layout templates; boundary=public-safe
- GET /api/v1/templates/{slug}: Fetch one template; boundary=public-safe
- GET /api/v1/layouts: Public-safe persistence status without exposing protected drafts; boundary=public-safe
- POST /api/v1/layouts: Create a protected ephemeral server layout; boundary=protected
- GET/PUT /api/v1/layouts/{id}: Read or update a protected ephemeral server layout; boundary=protected
- POST /api/v1/layouts/preview: Generate deterministic responsive preview data; boundary=public-safe
- POST /api/v1/layouts/score: Run deterministic Layout score; boundary=public-safe
- POST /api/v1/layouts/export: Export JSON, HTML/CSS, React/Tailwind, Markdown, design spec JSON, or report output; boundary=public-safe
- POST /api/v1/viewport/check: Check one viewport for overflow and tap-target risk; boundary=public-safe
- POST /api/v1/grid/analyze: Analyze grid and region structure; boundary=public-safe
- POST /api/v1/accessibility/check: Run deterministic accessibility hints; boundary=public-safe
- POST /api/v1/responsive/check: Check configured breakpoints; boundary=public-safe
- POST /api/v1/audit/url: Run public deterministic scoring and optional key-gated trusted-domain DOM inspection; boundary=public-safe
- POST /api/v1/audit/config: Audit layout config with deterministic findings; boundary=public-safe
- POST /api/v1/reports/layout: Return unsupported until protected report publishing is implemented; boundary=protected
- GET /api/v1/integrations/status: List Layout integration configuration/degraded state; boundary=public-safe
- POST /api/v1/integrations/phorm: Protected Phorm handoff; currently unsupported; boundary=protected
- POST /api/v1/integrations/browserops: Protected BrowserOps check; currently unsupported; boundary=protected
- POST /api/v1/integrations/docs: Protected Docs publishing; currently unsupported; boundary=protected
- POST /api/v1/integrations/decks: Protected Deck generation; currently unsupported; boundary=protected
- POST /api/v1/integrations/sheets: Protected Sheets reporting; currently unsupported; boundary=protected
- POST /api/v1/integrations/insights: Protected Insights handoff; currently unsupported; boundary=protected
- GET /api/indexnow: Read IndexNow configuration status; boundary=public-safe
- POST /api/indexnow: Submit bounded canonical Layout URLs to IndexNow; boundary=protected
- GET/POST /api/mcp: Layout MCP JSON-RPC endpoint; boundary=public-safe

## Discovery Routes
- GET /api/health
- GET /api/v1/health
- GET /api/docs
- GET /openapi.yaml
- GET /openapi.json
- GET /llms.txt
- GET /llms-full.txt
- GET /llms-index.json
- GET /robots.txt
- GET /sitemap.xml
- GET /sitemap-main.xml
- GET /sitemap-index.xml
- GET /rss.xml
- GET /feed.xml
- GET /manifest.webmanifest
- GET /.well-known/mcp.json
- GET /.well-known/agents.json
- GET /.well-known/ai-plugin.json
- GET /.well-known/security.txt
- GET /.well-known/trust.json
- GET /api/mcp

## MCP Tools
- list_layout_templates
- get_layout_template
- create_layout
- preview_layout
- score_layout
- audit_layout_url
- audit_layout_config
- analyze_grid
- check_responsive_layout
- check_accessibility_layout
- export_layout_json
- export_layout_html_css
- export_layout_react_tailwind
- export_layout_spec
- export_layout_markdown
- export_layout_design_spec_json
- export_layout_report
- send_to_phorm
- run_browserops_layout_check
- get_health
- get_info
- get_route_compliance
- get_discovery_compliance
- create_docs_report
- create_sheet_report
- create_deck_summary
- send_to_insights

## MCP Resources
- layout://templates
- layout://template/{slug}
- layout://layouts
- layout://layout/{id}
- layout://examples
- layout://audits/{id}
- layout://standards
- layout://scores/{id}
- layout://faq
- layout://openapi
- layout://llms
- layout://trust-policy

## MCP Prompts
- generate_responsive_layout
- improve_page_layout
- analyze_layout_issues
- create_dashboard_layout
- create_article_layout
- create_card_grid_layout
- create_form_layout
- create_platphorm_standard_layout
- explain_layout_score
- create_layout_export_plan
- human_machine_layout_handoff

## Deterministic Scoring
Checks include viewport overflow, horizontal scrolling risk, tap-target size hints, heading/layout hierarchy, grid consistency, spacing consistency, alignment consistency, content density, breakpoint coverage, mobile stacking behavior, image aspect/alt hints, form label hints, and semantic region hints. Layout does not claim full accessibility conformance unless a full external audit has run.

## Auth Policy
This protected action requires PLATPHORM_API_KEY.
Accepted protected headers: Authorization: Bearer $PLATPHORM_API_KEY; X-PlatPhorm-API-Key: $PLATPHORM_API_KEY.