Skip to content

docs: refresh homepage content, metadata and SEO signals - #2279

Merged
ZJvandeWeg merged 9 commits into
mainfrom
docs/homepage-seo-refresh
Oct 6, 2026
Merged

ZJvandeWeg merged 9 commits into
mainfrom
docs/homepage-seo-refresh

Conversation

@sumitshinde-84

@sumitshinde-84 sumitshinde-84 commented Oct 6, 2026 •

Copy link
Copy Markdown
Contributor

Summary

Fixes broken sections on the Dashboard docs homepage and adds the content people search for: install steps, migration from Node-RED Dashboard, and common questions. It also improves search metadata. The English and German homepages are both updated, and the hero branding is unchanged.

Fixes

1. Dashboard Showcase was empty

<DashboardExamples /> was used but never imported, so the section rendered only its intro text. It's imported now, and the examples carousel shows.

Before After
03-showcase before 03-showcase after

2. Recommended Reading images were broken

All three thumbnails were hotlinked from flowfuse.com/img/*.avif and return 404. They're replaced with local copies of each post's current image, and each card now shows its title as text.

Before After
06-reading before 06-reading after

3. "More Coming Soon!" placeholder in Recommended Tutorials

The third card was a placeholder that linked nowhere. It's now the Writing Custom Templates tutorial video.

Before After
05-tutorials before 05-tutorials after

4. "Widget Collection" button opened the wrong page

It linked to /getting-started, the same page as the first button. It now opens the widget list (/nodes/widgets), on both the English and German pages.

Before After
01-hero before 01-hero after

5. Page had two H1 headings

The FlowFuse advert heading was an <h1>. It's now an <h2>, so the page has a single H1.

Improvements

Install steps and a clearer product name

Before, the homepage only showed the package name. Now a short Get started section has three steps (Palette Manager → install → add a ui-button) and the npm command. A muted line under the package name says "Also known as Node-RED Dashboard 2.0 · Open source under Apache 2.0".

Before After
02-palette-get-started before 02-palette-get-started after

Migration from Node-RED Dashboard

Before, the homepage never mentioned migration. Now a short section explains the deprecation and links to the migration guide and the migration service. The hero's third button is now Migrate from Node-RED Dashboard, replacing "View on GitHub", which is still in the nav.

Before After
Not on the page 04-migration after

Common questions

New collapsible FAQ near the bottom of the page: free to use?, is Node-RED Dashboard deprecated? (links to the deprecation post), do I need a FlowFuse account?, will my dashboard work without changes?, phone/tablet support?, per-user data?

Before After
Not on the page 07-faq after

FlowFuse advert

  • Screenshot: the old FlowFuse Applications screenshot is replaced with the current FlowFuse Home with the Expert AI assistant.
  • Frame and reflection: done in CSS now, not baked into the image, so a future screenshot gets the same look just by swapping the file.
  • Copy: mentions built-in AI and building dashboards from natural language.
Before After
08-flowfuse-advert before 08-flowfuse-advert after

Page order

The ebook form moved below the install and learning content, so it's no longer the first thing after the package name.

SEO

Before After
Page title Node-RED Dashboard 2.0 Node-RED Dashboard 2.0 - FlowFuse Dashboard
Meta description Generic site default Covers install, widgets, examples and migration
Language links None en / de / x-default hreflang wherever both language versions exist
Sitemap Extensionless URLs (/getting-started), while the canonical tags use .html Uses .html, matching the canonical URLs, so indexed URLs don't move

German homepage

All of the above, translated, with links to the German docs. The German page didn't have the Dashboard Showcase before, and now it does. The FlowFuse advert is a shared component and stays in English, as before.

Before After
09-de-hero before 09-de-hero after
German homepage, full page
Before After
10-de-full before 10-de-full after

Checklist

  • vitepress build docs passes. Each homepage has one H1, one meta description, a canonical and hreflang links.
  • ESLint passes on the changed components.
  • Visual check on desktop and mobile in the deploy preview.
  • Save a Google Search Console baseline before merging.

- Fix empty Dashboard Showcase (DashboardExamples was never imported)
- Point "Explore widgets" hero CTA at the widget index (EN and DE)
- Replace 404ing Recommended Reading thumbnails with local copies
- Remove "More Coming Soon" placeholder tutorial card
- Demote FlowFuse advert heading to h2 so the page has a single h1
- New title, description and hero; add install, first dashboard,
  widgets, examples, migration and FAQ sections; move ebook lower
- Add en/de hreflang links where both pages exist
- Align sitemap URLs with the existing .html canonical URLs
SEO title and meta description still lead with Node-RED Dashboard 2.0.
Merge install and first-dashboard steps into one short section, shorten
migration copy, move FAQ into collapsible rows at the end of the page and
link the deprecation answer to the announcement post.
Recreate the framed screenshot with reflection in CSS so any screenshot
gets the same treatment, mention building dashboards from natural
language, and refer to the original package as Node-RED Dashboard.
@ZJvandeWeg
ZJvandeWeg merged commit 5bd4abb into main Oct 6, 2026
4 of 5 checks passed
@ZJvandeWeg
ZJvandeWeg deleted the docs/homepage-seo-refresh branch October 6, 2026 16:15
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.

3 participants