Skip to content

Migrate blog from 11ty to Nuxt - #5441

Open
ZJvandeWeg wants to merge 3 commits into
mainfrom
zj-migrate-blog-to-nuxt
Open

Migrate blog from 11ty to Nuxt#5441
ZJvandeWeg wants to merge 3 commits into
mainfrom
zj-migrate-blog-to-nuxt

Conversation

@ZJvandeWeg

Copy link
Copy Markdown
Member

Summary

  • Migrates /blog (index, 13 tag listings + pagination, post detail, RSS feed) from Eleventy to Nuxt, following the same pattern established by the changelog migration (Migrate changelog from 11ty to Nuxt #5420). Posts stay at their existing src/blog/YYYY/MM/slug.md location.
  • Reuses existing Nuxt components/composables where possible: HandbookToc, AlgoliaSearch, TeamCardSmall, HubSpotForm, useTeam.
  • Fixes two pre-existing bugs surfaced by this change:
    • customer-stories.njk was checking collections.posts.length (should be collections.stories) for its empty-state fallback.
    • llms.njk's Blog Posts section relied on collections.posts, which is now empty since 11ty no longer processes blog markdown — replaced with a small src/_data/blogPosts.js that reads frontmatter directly.
    • One post had frontmatter that failed strict YAML parsing (un-indented line continuation inside a quoted string); another had a leftover Nunjucks {% include %} baked into a raw href, which crashed the Nuxt markdown parser.

Test plan

  • npm run dev:nuxt: verified /blog/, a post detail page, a tag listing, tag pagination, and /blog/index.xml all render correctly (hero image, video embed, TL;DR, FAQ, related articles, sign-up form, pagination links).
  • Full eleventy build succeeds with no errors; /blog output is images-only (no HTML), confirming 11ty no longer renders blog pages.
  • customer-stories page and llms.txt verified to still list content correctly after the collection change.
  • Reviewer: spot-check a few posts with unusual frontmatter (video, tldr, faq, cta) in a real browser.

🤖 Generated with Claude Code

Reuses the changelog migration's shape: a content.config.ts collection
sourced directly from src/blog/**/*.md, a catch-all page handling the
index, 13 tag listings (with pagination), post detail, and an RSS feed
server route. Posts stay at their existing src/blog/YYYY/MM/slug.md
location. Reuses HandbookToc, AlgoliaSearch, TeamCardSmall, and
HubSpotForm rather than rebuilding them.

Also fixes two pre-existing bugs surfaced by this change: customer-stories.njk
checked the wrong collection for its empty-state, and llms.njk's blog
section relied on collections.posts, which is now empty since 11ty no
longer processes blog markdown (replaced with src/_data/blogPosts.js).
One post had frontmatter that failed strict YAML parsing, and another had
a leftover Nunjucks {% include %} baked into a raw href.
@ZJvandeWeg ZJvandeWeg self-assigned this Jul 30, 2026
Comment thread nuxt/components/BlogListing.vue Dismissed
Comment thread nuxt/pages/blog/[...slug].vue Dismissed
@ZJvandeWeg
ZJvandeWeg requested a review from Yndira-E July 31, 2026 15:20
BlogPagination and ChangelogPagination were identical apart from a
hardcoded base path; merged into a single Pagination component.
Also extracted the repeated authors -> team-member/name mapping
(duplicated across both list items, the featured blog post, and both
post detail pages) into useAuthorMembers/useAuthorNames in useTeam.
@ZJvandeWeg
ZJvandeWeg marked this pull request as ready for review July 31, 2026 17:35
@netlify

netlify Bot commented Jul 31, 2026

Copy link
Copy Markdown

Deploy Preview for flowforge-website ready!

Name Link
🔨 Latest commit e26cf62
🔍 Latest deploy log https://app.netlify.com/projects/flowforge-website/deploys/6a6d0087b981a60008d9bf1f
😎 Deploy Preview https://deploy-preview-5441--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: 65 (🔴 down 2 from production)
Accessibility: 96 (no change from production)
Best Practices: 100 (no change from production)
SEO: 91 (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.

Fixes prerender 404: @nuxt/content lowercases page paths via slugify,
but the source filename had mixed case, so the SSG build generated a
route that never matched the actual content path.
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