Skip to content

Homepage: say what an app platform means - #5500

Draft
dimitrieh wants to merge 6 commits into
mainfrom
feat/homepage-app-platform
Draft

Homepage: say what an app platform means#5500
dimitrieh wants to merge 6 commits into
mainfrom
feat/homepage-app-platform

Conversation

@dimitrieh

Copy link
Copy Markdown
Contributor

Description

Stacked on #5499. Base is feat/platform-page because this section links to /platform/, which #5499 adds; the link checker would fail against main. Retarget to main once #5499 merges.

The homepage asserts that FlowFuse is a platform and then moves straight to capabilities, so a visitor never learns what the platform is made of or why the word applies. The next step offered is the Expert, which is the wrong place to send someone who does not yet understand the components.

Adds one section after the solution statement that:

  • States the claim, that "app platform" is about how FlowFuse distributes and manages code.
  • Backs it with the two distribution models, shipping a whole application by pipeline versus shipping building blocks via a library.
  • Lists the major components grouped by what they do, as a compact scannable list rather than another card grid.
  • Hands off to /platform/ for the detail instead of dead-ending at the Expert.

No existing homepage content is removed or reordered.

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 explains what FlowFuse does and why it matters, but never what
the platform is made of or how the pieces fit together, so there is no page
to send a technical evaluator to after the homepage.

Adds /platform/ covering the two ways FlowFuse distributes and manages code,
the major components grouped by what they do, an end-to-end architecture
diagram, the six design patterns, and where Node-RED actually sits. The
diagram is a placehold.co stand-in pending an art request.

Wires it into the top nav and the footer under Platform > Product, ahead of
Features.
The homepage asserts that FlowFuse is a platform and then moves straight to
capabilities, so a visitor never learns what the platform is made of or why
the word applies. The next step offered was the Expert, which is the wrong
place to send someone who does not yet understand the components.

Adds a section after the solution statement that states the claim, backs it
with the two ways FlowFuse distributes and manages code, lists the major
components grouped by what they do, and hands off to /platform/ for detail.
@dimitrieh

Copy link
Copy Markdown
Contributor Author

@dimitrieh
dimitrieh marked this pull request as draft August 4, 2026 20:19
@dimitrieh
dimitrieh changed the base branch from feat/platform-page to main August 13, 2026 11:32
Main moved the header nav and footer out of base.njk into src/_data/chrome.json,
so the Platform nav entry moves with it: added to the Platform > Overview column
(and the matching footer group) instead of the hardcoded lists.
The Platform nav entry uses it, and Nuxt needs an explicit import per icon.
@netlify

netlify Bot commented Aug 13, 2026

Copy link
Copy Markdown

Deploy Preview for flowforge-website ready!

Name Link
🔨 Latest commit 0c51742
🔍 Latest deploy log https://app.netlify.com/projects/flowforge-website/deploys/6a7dadb8d24cc100088458f8
😎 Deploy Preview https://deploy-preview-5500--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: 64 (🟢 up 3 from production)
Accessibility: 96 (no change from production)
Best Practices: 100 (no change from production)
SEO: 85 (🔴 down 7 from production)
PWA: -
View the detailed breakdown and full score reports

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

@dgatti0213

Copy link
Copy Markdown
Contributor

So this is a great start! but IMO the homepage should sit one level above the platform detail page. Homepage in terms visitors already recognize, platform page for our specifics.

Right now both pages carry the same five groups with the same product names, so the homepage is the platform page with the explanations removed. "Instances · Devices · Groups" and "Snapshots · Pipelines · Environment Variables" are our vocabulary, not the visitor's. Anyone who can parse them is already headed to /platform.

Suggested values:
Where it runs: edge devices, your infrastructure, or hosted
How it's built: visual flow programming, in the browser
How it's distributed: one app to every site, or a library of shared blocks
What it connects to: OPC UA, Modbus, MQTT, EtherNet/IP, databases, ERP, REST, Limitless!
How it's governed: SSO, role-based access, audit logs, SOC 2 Type 2

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.

2 participants