Skip to content

platform: add /platform/, the page between the homepage and the docs - #5769

Draft
dimitrieh wants to merge 3 commits into
mainfrom
platform/overview-page
Draft

platform: add /platform/, the page between the homepage and the docs#5769
dimitrieh wants to merge 3 commits into
mainfrom
platform/overview-page

Conversation

@dimitrieh

Copy link
Copy Markdown
Contributor

Description

The site says what FlowFuse does and why it matters, but never what the platform is made of or how the pieces fit together, so there is nowhere to send a technical evaluator after the homepage. This adds /platform/, wired into the top nav and the footer under Platform > Overview, ahead of Product.

Sales frames the goal as two takeaways: how FlowFuse distributes application code, and what the major components are. The page is built around those, and its spine is the Application Guide's rather than a feature list, so the journey reads homepage (industry terms) to platform (our terms) to docs (depth). Every entry links into the guide or the docs page that owns it.

  • Two takeaways. The Foundations architecture, rendered live by ArchDiagram off the same node data application-guide/foundations.md uses, so the two cannot drift. Then the component roll-call as labelled tiles.
  • Five stages behind a sticky contents list: Build, Deliver, Run, Connect, Govern. Deliver draws both code-distribution paths, whole app by snapshot and pipeline, or pieces by package and Team Library.
  • Build what's next. Documentation, application guide, blueprints, professional services.

ScrollSpySections gains a boxed nav variant (icon per row, whole active row inked) and a fallback item slot, so a caller whose stages render identically writes one template instead of five named slots. /product and /integrations/opcua keep the rail variant and their per-id slots, unchanged.

/platform is added to legacy.ts as an exact route, not a prefix, so /platform/dashboard/, /platform/device-agent/, /platform/security/ and /platform/why-flowfuse/ keep falling through to 11ty.

Draft: the copy is a first pass and wants a sales read on the stage names and the component groupings. Expect a one-line conflict in src/_data/chrome.json against #5765.

Related Issue(s)

None.

Checklist

  • I have read the contribution guidelines
  • I have considered the performance impact of these changes
  • Suitable unit/system level tests have been added and they pass
  • Documentation has been updated
  • For blog PRs, an Art Request has been created (instructions)

The website says what FlowFuse does and why it matters, but never what the
platform is made of or how the pieces fit together, so there is nowhere to send
a technical evaluator after the homepage.

Sales frames the goal as two takeaways: how FlowFuse distributes application
code, and what the major components are. The page is built around those. Its
spine is the Application Guide's, not a feature list, so the journey reads
homepage (industry terms) to platform (our terms) to docs (depth), and every
entry on the page links into the guide or the docs page that owns it.

- Hero, then the two takeaways: the Foundations architecture rendered live by
  ArchDiagram off the same node data the guide uses, so the two cannot drift,
  and the component roll-call as labelled tiles.
- Five stages behind a sticky contents list: Build, Deliver, Run, Connect,
  Govern. Deliver draws both code-distribution paths, whole app by snapshot
  and pipeline, or pieces by package and Team Library.
- Build what's next: documentation, application guide, blueprints, services.

ScrollSpySections gains a boxed nav variant (icon per row, whole active row
inked) and a fallback `item` slot, so a caller whose stages render identically
writes one template instead of five named slots. /product and
/integrations/opcua keep the rail variant and their per-id slots unchanged.

/platform is added to legacy.ts as an exact route, not a prefix, so
/platform/dashboard/, /platform/device-agent/, /platform/security/ and
/platform/why-flowfuse/ keep falling through to 11ty.
@netlify

netlify Bot commented Sep 10, 2026

Copy link
Copy Markdown

Deploy Preview for flowforge-website ready!

Name Link
🔨 Latest commit 1649891
🔍 Latest deploy log https://app.netlify.com/projects/flowforge-website/deploys/6aa2bd70de9af700082b70a3
😎 Deploy Preview https://deploy-preview-5769--flowforge-website.netlify.app
📱 Preview on mobile
Toggle QR Code...

QR Code

Use your smartphone camera to open QR code link.
Lighthouse
Lighthouse
1 paths audited
Performance: 62 (🟢 up 13 from production)
Accessibility: 96 (no change from production)
Best Practices: 100 (no change from production)
SEO: 92 (no change from production)
PWA: -
View the detailed breakdown and full score reports

To edit notification comments on pull requests, go to your Netlify project configuration.

The link check failed with 1346 bad links, all of them /platform, one per page
that carries the nav. The route is only linked from 11ty-generated HTML, which
the Nuxt prerender crawler never parses, so it has to be listed in
nitro.prerender.routes or it is missing from nuxt/dist entirely. That is the
same reason /ai is listed there, and its comment now covers both.

Also from the first look at the rendered page: the hero statement takes an
explicit type scale rather than the site's 2.75rem h1, and the three hairline
grids get a border on the wrapper so their outer rules close the box the way
the interior gap-px rules already did.
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant