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 1 behavior

Public-safe builder, templates, preview, scoring, 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 1 flows.

Templates
6 active
MCP tools
24 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

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, or React/Tailwind scaffold
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