Skip to content

Migrate website from 11ty to Nuxt #4867

Description

@ZJvandeWeg

Description

Context & Motivation

Our main application is built with Vue, but our current website and documentation run on 11ty. To unify our tech stack, share components between our app and site, and improve developer velocity, we are migrating the website to Nuxt 3.

Why Nuxt?

  1. Vue Ecosystem: It aligns perfectly with our core app's Vue development, allowing us to reuse UI components and developer knowledge.
  2. Built-in CMS: Nuxt Content provides an excellent, markdown-driven CMS that will massively improve the authoring experience for our docs, handbook, and blog.
  3. Incremental Adoption: Using the "Strangler Fig Pattern," Nuxt's Nitro server allows us to proxy traffic seamlessly to 11ty. This means we can migrate page-by-page without a massive "big bang" rewrite, ensuring zero downtime and a smooth developer experience.

Strategy Overview

We will move to a monorepo structure. Nuxt will act as the front door. If Nuxt has a route (e.g., a newly migrated page), it will serve it. If it doesn't, it will proxy the request to the legacy 11ty build.

Activity

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Metadata

Metadata

Assignees

Labels

epicA significant feature or piece of work that doesn't easily fit into a single release

Type

No type

Projects

No projects

    Milestone

    No milestone

    Relationships

    None yet

    Development

    No branches or pull requests

    Issue actions