コンテンツにスキップ

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