Skip to content

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

Public-safe builder, templates, preview, scoring, audits, exports, API docs, discovery files, RSS/feed, sitemap, and read-only MCP introspection are open by default. PLATPHORM_API_KEY is scaffolded for future protected backend actions and is not required for public-safe Phase 2 flows.

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/v1/templatespublic-safeList real public layout templates
GET/api/v1/templates/{slug}public-safeFetch one template
GET, POST/api/v1/layoutspublic-safeEphemeral server layout drafts and local-first creation
GET, PUT/api/v1/layouts/{id}public-safeEphemeral layout lookup/update when available
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-safeAudit URL with deterministic layout checks and explicit degraded remote inspection state
POST/api/v1/audit/configpublic-safeAudit layout config with deterministic findings
POST/api/v1/reports/layoutfuture-protectedCreate a degraded local report summary
GET/api/v1/integrations/statuspublic-safeList Layout integration configuration/degraded state
POST/api/v1/integrations/phormfuture-protectedFuture protected Phorm handoff scaffold
POST/api/v1/integrations/browseropsfuture-protectedFuture protected BrowserOps layout check scaffold
POST/api/v1/integrations/docsfuture-protectedFuture protected Docs report scaffold
POST/api/v1/integrations/decksfuture-protectedFuture protected Deck summary scaffold
POST/api/v1/integrations/sheetsfuture-protectedFuture protected Sheets report scaffold
POST/api/v1/integrations/insightsfuture-protectedFuture protected Insights scoring handoff scaffold
GET, POST/api/indexnowfuture-protectedFuture protected IndexNow status/submission endpoint
GET, POST/api/mcppublic-safeLayout MCP JSON-RPC endpoint

Discovery