SEO Framework
If you think the framework you pick will automatically boost your rankings, you are about to waste a lot of time. I know because I did it.
Start here
- Run Lighthouse and check whether your pages render without JavaScript. If they do not, you have a rendering problem.
- Choose a framework that supports server-side rendering or static site generation. Do not default to a client-side SPA.
- Ensure you can control metadata, canonical tags, and structured data in your chosen framework. Test with the Rich Results Test.
- Measure real-world performance with PageSpeed Insights and aim for good Core Web Vitals before launch.
- Do not expect the framework to fix bad content or weak backlinks. It only removes technical barriers.
Plain-English take
An SEO framework is the tech stack you use to build your website. But that definition is too clean for what actually matters. What really matters is how that stack handles three things: crawling, rendering, and performance. I tell clients to stop worrying about keywords for a moment and check whether Googlebot can even see their pages. A common trap is a site built as a single-page application that relies entirely on client-side JavaScript. When I disable JavaScript in my browser, the page is blank. That means Google—which has a limited JavaScript budget—may never index your content. Modern frameworks like Next.js, Nuxt, Astro, or SvelteKit solve this by offering server-side rendering (SSR) or static site generation (SSG). They ship less JavaScript to the browser and produce HTML that search engines can parse immediately. But that is only part of the story. The framework you pick also determines your Core Web Vitals baseline, how easy it is to add structured data, and whether you can set canonical URLs automatically. I have seen perfectly fast pages on a bad framework and painfully slow pages on a 'good' one. The difference always comes down to implementation. So the plain-English take is this: an SEO framework is the scaffolding that should make technical [SEO](/seo/) easier, but it will not write your content or earn your backlinks. If you are building a new site, start with a framework that prioritises SSR or SSG. If you are migrating, measure your current rendering behaviour first. Use tools like PageSpeed Insights and Lighthouse to get a baseline. Then pick a stack that removes the biggest bottlenecks you find. [Google Search](/google-search/) plays by the same rules regardless of your framework—it just needs clean, renderable HTML.
When it actually matters
Framework choice matters most in three scenarios. First, when you are building a new site from scratch. The framework you pick then will shape every page, every optimisation, and every migration you do later. I default to an SSR or SSG setup unless the site is a simple brochure that does not need search traffic. Second, when you are migrating from a client-rendered single-page application. I once helped a client move a React SPA to Next.js. Their time-to-interactive dropped from 8 seconds to 2.5 seconds, and crawl errors fell by 60% in the first month. But that improvement only came because we also fixed the redirects, added proper meta tags, and cleaned up the internal linking. That is a matter of solid [SEO strategy](/seo-strategy/) more than the framework alone. Third, when your Core Web Vitals are hurting your rankings. If Lighthouse flags poor Largest Contentful Paint or Cumulative Layout Shift, your framework might be the culprit. Heavy client-side JavaScript often causes both. Switching to a framework that generates static HTML can fix these metrics without touching the design. But do not think this is a fire-and-forget solution. You still need to [SEO optimisation](/seo-optimization/) images, lazy-load components, and minimise third-party scripts. The framework is a foundation, not the whole house. If you are running an e-commerce site with hundreds of products, the rendering strategy matters even more because Google's crawl budget is limited. Server-rendered pages tend to get crawled more efficiently.
What I got wrong
I used to think that picking the right framework was the single most important SEO decision. I spent weeks comparing Next.js, Nuxt, Gatsby, and Remix, reading forum posts and watching conference talks. When I finally migrated a site to Nuxt, I expected rankings to climb automatically. They did not. In fact, the site lost traffic for two months because I had ignored everything else: the content was thin, the metadata was missing, and the redirects were broken. The framework alone does not do SEO. I also got wrong the idea that a modern framework protects you from mistakes. You can still build a bad site on a good framework. I have audited Next.js sites that shipped three megabytes of JavaScript because of unoptimised images and third-party libraries. I have seen Astro sites with no canonical tags and SvelteKit sites with broken breadcrumb structured data. The framework gives you the right hooks, but you still have to use them. Another mistake was ignoring the rendering behaviour of my own content management system. I assumed that because I was using a headless CMS, everything would be fine. But the frontend was fetching data client-side, defeating the purpose of server-rendering. Now I always run the [SEO checklist](/seo-checklist/) before I celebrate a migration. For structured data, I rely on [semantic search](/semantic-search/) principles to choose the right schema. The lesson: audit your actual output, not your stack.
Next step
Quick answers
Can I use a client-side SPA and still rank well?
Yes, but it is harder. Google can render JavaScript, but it has a limited budget. If your SPA is small and fast, you might be fine. For anything larger, SSR or SSG is safer. I have seen SPAs rank, but they typically require more effort on metadata, internal links, and server responses.
Which framework is best for SEO?
There is no single best framework for SEO. Next.js and Nuxt are popular because they support SSR, SSG, and incremental static regeneration. Astro excels at shipping minimal JavaScript by default. Your choice should depend on your team's skills, your content type, and your performance budget. I always prototype two options and compare Lighthouse scores before committing.
Do I need an SEO framework if I use WordPress?
WordPress is already a server-rendered system, so you do not need to switch. But you still need to optimise themes, plugins, and hosting. The framework debate matters more for headless setups or custom stacks. If your WordPress site is slow, look at caching, image optimisation, and a lightweight theme before blaming the framework.
How do I test if my current framework is good for SEO?
Open your site in a browser, disable JavaScript, and reload. If the page is blank, you have a rendering problem. Then run Lighthouse and check Core Web Vitals. Finally, use the Rich Results Test to verify structured data. If any of these fail, the framework is hurting you.
Sources
Primary documentation is linked directly. Anything commercial is marked nofollow.
- Google Search Central — Backs up the rendering, indexing, and technical SEO guidance.
- PageSpeed Insights — Validates performance improvements from framework changes.
- Lighthouse — Audits how framework implementations affect rendering and performance.
- Rich Results Test — Checks whether structured data from the framework is eligible for rich results.
- Google Search Central Blog — Useful for updates on rendering and search features that affect framework choices.
Notes from Callum Bennett.