Zum Inhalt springen

Documentation

PlatPhorm Layout

Layout is the public responsive layout workbench for the PlatPhormNews mesh. It owns templates, builder state, viewport preview, grid inspection, deterministic scoring, and export scaffolds.

Phase 2 behavior

Browser-local building, templates, preview, deterministic scoring, config audits, exports, API docs, discovery files, RSS/feed, sitemap, and read-only MCP introspection are public. Server mutations, remote trusted-domain inspection, publishing, integration triggers, and admin actions require PLATPHORM_API_KEY.

Templates
15 active
MCP tools
27 real tools
Storage
IndexedDB local drafts

Templates

Article Brief

Readable article page with metadata, lead media, body, and context rail.

3 regions, 6 components

Command Dashboard

Dense operational dashboard with KPI row, primary panel, and issue queue.

4 regions, 8 components

Responsive Card Grid

Reusable card collection with predictable columns and stable media ratios.

2 regions, 8 components

Form Flow

Accessible form layout with labels, help text, validation area, and summary panel.

3 regions, 6 components

Docs Layout

Documentation page with local nav, readable article column, and API callout rail.

3 regions, 4 components

Gallery Wall

Responsive visual gallery with hero media, masonry-like rows, and captions.

2 regions, 10 components

Landing Page System

Public product landing layout with nav, first-viewport offer, proof strip, feature bands, FAQ teaser, and discovery footer.

5 regions, 11 components

News Feed

Responsive feed layout with topic navigation, lead story, ranked cards, and utility/discovery rail.

4 regions, 10 components

FAQ Knowledge Page

FAQ layout with breadcrumb header, grouped questions, policy labels, and related discovery links.

3 regions, 4 components

Product / Service Page

Service page with capability summary, plan/status cards, implementation proof, and integration links.

3 regions, 10 components

Status Page

Operational status layout with summary banner, component statuses, incident history, and discovery footer.

3 regions, 9 components

API Docs Page

API documentation layout with endpoint list, request/response panels, auth policy, and copy-ready examples.

3 regions, 5 components

MCP Capability Page

MCP capability layout with tools/resources/prompts registry, JSON-RPC status, and trust policy panel.

3 regions, 4 components

Network Directory

Directory layout for PlatPhorm site cards, route status, discovery links, and standard compliance panels.

3 regions, 13 components

Report Page

Structured report layout with executive summary, findings, score cards, recommendations, and export handoff.

3 regions, 6 components

API endpoints

MethodPathBoundaryPurpose
GET/api/healthpublic-safeStandard public-safe health summary
GET/api/v1/healthpublic-safeVersioned public-safe health summary
GET/api/docspublic-safeOpenAPI 3.1 JSON document
GET/api/v1/templatespublic-safeList real public layout templates
GET/api/v1/templates/{slug}public-safeFetch one template
GET/api/v1/layoutspublic-safePublic-safe persistence status without exposing protected drafts
POST/api/v1/layoutsprotectedCreate a protected ephemeral server layout
GET, PUT/api/v1/layouts/{id}protectedRead or update a protected ephemeral server layout
POST/api/v1/layouts/previewpublic-safeGenerate deterministic responsive preview data
POST/api/v1/layouts/scorepublic-safeRun deterministic Layout score
POST/api/v1/layouts/exportpublic-safeExport JSON, HTML/CSS, React/Tailwind, Markdown, design spec JSON, or report output
POST/api/v1/viewport/checkpublic-safeCheck one viewport for overflow and tap-target risk
POST/api/v1/grid/analyzepublic-safeAnalyze grid and region structure
POST/api/v1/accessibility/checkpublic-safeRun deterministic accessibility hints
POST/api/v1/responsive/checkpublic-safeCheck configured breakpoints
POST/api/v1/audit/urlpublic-safeRun public deterministic scoring and optional key-gated trusted-domain DOM inspection
POST/api/v1/audit/configpublic-safeAudit layout config with deterministic findings
POST/api/v1/reports/layoutprotectedReturn unsupported until protected report publishing is implemented
GET/api/v1/integrations/statuspublic-safeList Layout integration configuration/degraded state
POST/api/v1/integrations/phormprotectedProtected Phorm handoff; currently unsupported
POST/api/v1/integrations/browseropsprotectedProtected BrowserOps check; currently unsupported
POST/api/v1/integrations/docsprotectedProtected Docs publishing; currently unsupported
POST/api/v1/integrations/decksprotectedProtected Deck generation; currently unsupported
POST/api/v1/integrations/sheetsprotectedProtected Sheets reporting; currently unsupported
POST/api/v1/integrations/insightsprotectedProtected Insights handoff; currently unsupported
GET/api/indexnowpublic-safeRead IndexNow configuration status
POST/api/indexnowprotectedSubmit bounded canonical Layout URLs to IndexNow
GET, POST/api/mcppublic-safeLayout MCP JSON-RPC endpoint

Discovery