Pular para o conteudo

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