Skip to content

Commit

Permalink
chore: add lts support
Browse files Browse the repository at this point in the history
  • Loading branch information
atinux committed Sep 14, 2023
1 parent 483d62a commit e5b0308
Show file tree
Hide file tree
Showing 11 changed files with 468 additions and 26 deletions.
4 changes: 2 additions & 2 deletions components/organisms/home/HomeHero.vue
Original file line number Diff line number Diff line change
Expand Up @@ -9,11 +9,11 @@
<section class="flex flex-col justify-start w-full px-4 pt-36 pb-48 md:pt-44 lg:pb-56 lg:pt-36 text-center z-20">
<div class="flex justify-center mb-16">
<AppLink
to="https://nuxt.com/support/courses"
to="/lts"
class="flex items-center truncate bg-primary/25 hover:bg-primary-800 text-white border border-primary py-3 px-4 rounded"
>
<IconStar class="h-4 w-4 mr-2" />
<span class="truncate">Official Nuxt Training Courses are out!</span>
<span class="truncate">Learn about Nuxt 2 Long Term Support</span>
</AppLink>
</div>
<h1 class="font-normal font-serif text-display-5 xs:text-display-4 md:text-display-3 2xl:text-display-2 mb-6">
Expand Down
20 changes: 20 additions & 0 deletions components/templates/Page.vue
Original file line number Diff line number Diff line change
@@ -0,0 +1,20 @@
<template>
<div class="relative pt-10 lg:pt-24 pb-16 lg:pb-32 bg-gray-100 dark:bg-secondary-darkest">
<div class="relative d-container-content z-10">
<DocusContent :document="page" />
</div>
</div>
</template>

<script>
import { defineComponent } from '@nuxtjs/composition-api'
export default defineComponent({
props: {
page: {
type: Object,
required: true
}
}
})
</script>
24 changes: 6 additions & 18 deletions components/theme/app/AppBanner.vue
Original file line number Diff line number Diff line change
@@ -1,20 +1,8 @@
<template>
<AppLink
to="https://nuxt.com"
class="group flex items-center transition-height delay-200 h-10 bg-primary hover:bg-primary-400"
tabindex="0"
>
<i18n
tag="p"
path="banner.format"
class="text-sky-darkest group-hover:text-black sm:top-1.5 w-full pl-4 sm:pl-0 sm:text-center text-sm"
>
<template #nuxt>
<b>Nuxt 3</b>
</template>
<template #here>
<b>{{ $t('banner.here') }}</b>
</template>
</i18n>
</AppLink>
<div class="group flex items-center delay-200 h-10 bg-primary text-black">
<p class="sm:top-1.5 w-full pl-4 sm:pl-0 sm:text-center text-sm font-medium">
You are browsing Nuxt 2 docs. Go to <a href="https://nuxt.com" class="font-bold hover:underline">Nuxt 3 docs</a>,
or learn more about <nuxt-link to="/lts" class="font-bold hover:underline">Nuxt 2 Long Term Support</nuxt-link>.
</p>
</div>
</template>
4 changes: 2 additions & 2 deletions content/en/_collections/navigations/header.md
Original file line number Diff line number Diff line change
Expand Up @@ -94,10 +94,10 @@ links:
- title: 'Sponsors'
subtitle: 'They trust us'
slug: 'sponsors'
href: 'https://nuxt.com/support/us'
href: 'https://nuxt.com/enterprise/sponsors'
icon: 'sponsors.svg'
color: 'bg-mint-dark'
- title: 'Partners'
slug: 'partners'
href: 'https://nuxt.com/support/agencies'
href: 'https://nuxt.com/enterprise/agencies'
---
73 changes: 73 additions & 0 deletions content/en/lts.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,73 @@
---
template: page
title: 'Nuxt 2 LTS, EOL & Extended Support'
description: 'On December 31st, 2023, Vue 2 along with Nuxt 2 will reach End of Life (EOL). Learn more about upgrading to Nuxt 3 or our extended support offer.'
navigation: false
---

# Nuxt 2 LTS, EOL & Extended Support

## Expecting to stay on Nuxt 2?

If you expect to be using Nuxt 2 beyond the EOL (End of Life) date (Dec. 31st, 2023), and still need a maintained version that can satisfy security and browser compatibility requirements, make sure to check out [HeroDevs’ NES (Never-Eding Support) for Vue 2 & Nuxt 2](https://www.herodevs.com/support/nes-vue?utm_source=nuxt-js&utm_medium=affiliate&utm_campaign=nuxt&utm_content=link).

## How long will Nuxt 2 be supported?

On December 31st, 2023, Vue 2 along with Nuxt 2 will reach End of Life (EOL).
Nuxt 2.17 is the current, and final minor release of Nuxt 2.x.
After that date, Nuxt 2 will continue to be available on the NPM package manager, but will no longer receive updates, such as security and browser compatibility fixes.
After that, if you wish to receive updates, please subscribe to [HeroDevs’ NES (Never-Eding Support) for Vue 2 & Nuxt 2 (Core + Essentials package)](https://www.herodevs.com/support/nes-vue?utm_source=nuxt-js&utm_medium=affiliate&utm_campaign=nuxt&utm_content=link).

## Upgrade to Nuxt 3

Nuxt 3 is the current, latest major version of Nuxt. It provides a better developer experience, better performance, and contains new features that are not present in Nuxt 2, such as Nitro, auto-import and hybrid rendering,

Nuxt 3 contains breaking changes that make it incompatible with Nuxt 2, so migration will require a certain level of effort depending on your project. Full details are documented in the Nuxt 3 Migration Guide.

Despite the breaking changes, most of Nuxt APIs are shared between the two major versions, so most of your team’s Nuxt 2 knowledge will continue to work in Nuxt 3. In the long run, we also intend to avoid major breaking upgrades like the one between Nuxt 2 and Nuxt 3. Compatibility and ecosystem stability will be our topmost priority for future releases, and new features will be introduced in a way that does not require major migrations.

## To upgrade or not to upgrade

Whether you should upgrade to Nuxt 3 highly depends on specific project details.

Here are some general guidelines:

**Understand what you will gain from upgrading.**

Nuxt 2.17 remains a powerful framework with great DX. The main benefits of upgrading are more refined TypeScript support, better performance, hybrid rendering, and access to the Nuxt 3 ecosystem and new features.

Ask your team these questions:
Is the app stable and working well?
Does the app expect innovative features into the future?
Is there a pain-point / bottleneck that can only be solved by upgrading?
If the app is stable and isn’t experiencing major pain-points caused by Nuxt 2, then upgrading may not be worthwhile.

**Understand the cost of upgrading.**

Does the app rely on 3rd party dependencies that complicate Nuxt 3 compatibility?
Does the app rely heavily on changed behavior between Nuxt 2 and Nuxt 3?
Can the team allocate dedicated time for upgrading?
Spend some initial research time to gauge these aspects and come up with an estimation. Then, compare that to the expected gain from (1). We will not be able to provide a precise formula, but hopefully this can help with the decision process.

## Stay on Nuxt 2

Some teams may not be able to upgrade to Nuxt 3 by this timeline due to limited bandwidth, budget, risk tolerance, or reliance on Nuxt-3-incompatible dependencies. We totally understand this, and want to ensure that staying on Nuxt 2 beyond EOL is a viable option.

## The Technical Perspective

From a technical perspective, Nuxt 2 is a stable and battle-tested piece of technology. If it is serving you well now, it will continue to do so for the foreseeable future.

Nuxt 2.17 will be the maintained release before EOL hits, so if you intend to stay on Nuxt 2, you should at least upgrade to Nuxt 2.17.

## Security & Compliance

For some teams, the main concern lies in security, compliance, and browser compatibility.

You won’t receive security fixes from EOL software. For the record, Nuxt 2 has had very few security vulnerabilities. That said, you may need a supported version to fulfill regulations or company policies.

If you are shipping your application to customers with SLAs (Service Level Agreements). You will want to avoid including EOL software in your stack.

Browsers sometimes ship changes that break legacy libraries. This is extremely rare, but could happen, in theory.

To address these concerns, we have partnered with industry experts to provide Extended LTS (Long Term Support) for Nuxt 2. This service will provide a version of Nuxt 2 that will continue to receive security and browser compatibility fixes, with SLAs. If you expect to be using Nuxt 2 beyond the EOL date of December 31st, 2023, make sure to plan ahead: Learn more about [HeroDevs’ NES (Never-Ending Support) for Nuxt 2](https://www.herodevs.com/support/nes-vue?utm_source=nuxt-js&utm_medium=affiliate&utm_campaign=nuxt&utm_content=link).

73 changes: 73 additions & 0 deletions content/es/lts.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,73 @@
---
template: page
title: 'Nuxt 2 LTS, EOL & Extended Support'
description: 'On December 31st, 2023, Vue 2 along with Nuxt 2 will reach End of Life (EOL). Learn more about upgrading to Nuxt 3 or our extended support offer.'
navigation: false
---

# Nuxt 2 LTS, EOL & Extended Support

## Expecting to stay on Nuxt 2?

If you expect to be using Nuxt 2 beyond the EOL (End of Life) date (Dec. 31st, 2023), and still need a maintained version that can satisfy security and browser compatibility requirements, make sure to check out [HeroDevs’ NES (Never-Eding Support) for Vue 2 & Nuxt 2](https://www.herodevs.com/support/nes-vue?utm_source=nuxt-js&utm_medium=affiliate&utm_campaign=nuxt&utm_content=link).

## How long will Nuxt 2 be supported?

On December 31st, 2023, Vue 2 along with Nuxt 2 will reach End of Life (EOL).
Nuxt 2.17 is the current, and final minor release of Nuxt 2.x.
After that date, Nuxt 2 will continue to be available on the NPM package manager, but will no longer receive updates, such as security and browser compatibility fixes.
After that, if you wish to receive updates, please subscribe to [HeroDevs’ NES (Never-Eding Support) for Vue 2 & Nuxt 2 (Core + Essentials package)](https://www.herodevs.com/support/nes-vue?utm_source=nuxt-js&utm_medium=affiliate&utm_campaign=nuxt&utm_content=link).

## Upgrade to Nuxt 3

Nuxt 3 is the current, latest major version of Nuxt. It provides a better developer experience, better performance, and contains new features that are not present in Nuxt 2, such as Nitro, auto-import and hybrid rendering,

Nuxt 3 contains breaking changes that make it incompatible with Nuxt 2, so migration will require a certain level of effort depending on your project. Full details are documented in the Nuxt 3 Migration Guide.

Despite the breaking changes, most of Nuxt APIs are shared between the two major versions, so most of your team’s Nuxt 2 knowledge will continue to work in Nuxt 3. In the long run, we also intend to avoid major breaking upgrades like the one between Nuxt 2 and Nuxt 3. Compatibility and ecosystem stability will be our topmost priority for future releases, and new features will be introduced in a way that does not require major migrations.

## To upgrade or not to upgrade

Whether you should upgrade to Nuxt 3 highly depends on specific project details.

Here are some general guidelines:

**Understand what you will gain from upgrading.**

Nuxt 2.17 remains a powerful framework with great DX. The main benefits of upgrading are more refined TypeScript support, better performance, hybrid rendering, and access to the Nuxt 3 ecosystem and new features.

Ask your team these questions:
Is the app stable and working well?
Does the app expect innovative features into the future?
Is there a pain-point / bottleneck that can only be solved by upgrading?
If the app is stable and isn’t experiencing major pain-points caused by Nuxt 2, then upgrading may not be worthwhile.

**Understand the cost of upgrading.**

Does the app rely on 3rd party dependencies that complicate Nuxt 3 compatibility?
Does the app rely heavily on changed behavior between Nuxt 2 and Nuxt 3?
Can the team allocate dedicated time for upgrading?
Spend some initial research time to gauge these aspects and come up with an estimation. Then, compare that to the expected gain from (1). We will not be able to provide a precise formula, but hopefully this can help with the decision process.

## Stay on Nuxt 2

Some teams may not be able to upgrade to Nuxt 3 by this timeline due to limited bandwidth, budget, risk tolerance, or reliance on Nuxt-3-incompatible dependencies. We totally understand this, and want to ensure that staying on Nuxt 2 beyond EOL is a viable option.

## The Technical Perspective

From a technical perspective, Nuxt 2 is a stable and battle-tested piece of technology. If it is serving you well now, it will continue to do so for the foreseeable future.

Nuxt 2.17 will be the maintained release before EOL hits, so if you intend to stay on Nuxt 2, you should at least upgrade to Nuxt 2.17.

## Security & Compliance

For some teams, the main concern lies in security, compliance, and browser compatibility.

You won’t receive security fixes from EOL software. For the record, Nuxt 2 has had very few security vulnerabilities. That said, you may need a supported version to fulfill regulations or company policies.

If you are shipping your application to customers with SLAs (Service Level Agreements). You will want to avoid including EOL software in your stack.

Browsers sometimes ship changes that break legacy libraries. This is extremely rare, but could happen, in theory.

To address these concerns, we have partnered with industry experts to provide Extended LTS (Long Term Support) for Nuxt 2. This service will provide a version of Nuxt 2 that will continue to receive security and browser compatibility fixes, with SLAs. If you expect to be using Nuxt 2 beyond the EOL date of December 31st, 2023, make sure to plan ahead: Learn more about [HeroDevs’ NES (Never-Ending Support) for Nuxt 2](https://www.herodevs.com/support/nes-vue?utm_source=nuxt-js&utm_medium=affiliate&utm_campaign=nuxt&utm_content=link).

73 changes: 73 additions & 0 deletions content/fr/lts.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,73 @@
---
template: page
title: 'Nuxt 2 LTS, EOL & Extended Support'
description: 'On December 31st, 2023, Vue 2 along with Nuxt 2 will reach End of Life (EOL). Learn more about upgrading to Nuxt 3 or our extended support offer.'
navigation: false
---

# Nuxt 2 LTS, EOL & Extended Support

## Expecting to stay on Nuxt 2?

If you expect to be using Nuxt 2 beyond the EOL (End of Life) date (Dec. 31st, 2023), and still need a maintained version that can satisfy security and browser compatibility requirements, make sure to check out [HeroDevs’ NES (Never-Eding Support) for Vue 2 & Nuxt 2](https://www.herodevs.com/support/nes-vue?utm_source=nuxt-js&utm_medium=affiliate&utm_campaign=nuxt&utm_content=link).

## How long will Nuxt 2 be supported?

On December 31st, 2023, Vue 2 along with Nuxt 2 will reach End of Life (EOL).
Nuxt 2.17 is the current, and final minor release of Nuxt 2.x.
After that date, Nuxt 2 will continue to be available on the NPM package manager, but will no longer receive updates, such as security and browser compatibility fixes.
After that, if you wish to receive updates, please subscribe to [HeroDevs’ NES (Never-Eding Support) for Vue 2 & Nuxt 2 (Core + Essentials package)](https://www.herodevs.com/support/nes-vue?utm_source=nuxt-js&utm_medium=affiliate&utm_campaign=nuxt&utm_content=link).

## Upgrade to Nuxt 3

Nuxt 3 is the current, latest major version of Nuxt. It provides a better developer experience, better performance, and contains new features that are not present in Nuxt 2, such as Nitro, auto-import and hybrid rendering,

Nuxt 3 contains breaking changes that make it incompatible with Nuxt 2, so migration will require a certain level of effort depending on your project. Full details are documented in the Nuxt 3 Migration Guide.

Despite the breaking changes, most of Nuxt APIs are shared between the two major versions, so most of your team’s Nuxt 2 knowledge will continue to work in Nuxt 3. In the long run, we also intend to avoid major breaking upgrades like the one between Nuxt 2 and Nuxt 3. Compatibility and ecosystem stability will be our topmost priority for future releases, and new features will be introduced in a way that does not require major migrations.

## To upgrade or not to upgrade

Whether you should upgrade to Nuxt 3 highly depends on specific project details.

Here are some general guidelines:

**Understand what you will gain from upgrading.**

Nuxt 2.17 remains a powerful framework with great DX. The main benefits of upgrading are more refined TypeScript support, better performance, hybrid rendering, and access to the Nuxt 3 ecosystem and new features.

Ask your team these questions:
Is the app stable and working well?
Does the app expect innovative features into the future?
Is there a pain-point / bottleneck that can only be solved by upgrading?
If the app is stable and isn’t experiencing major pain-points caused by Nuxt 2, then upgrading may not be worthwhile.

**Understand the cost of upgrading.**

Does the app rely on 3rd party dependencies that complicate Nuxt 3 compatibility?
Does the app rely heavily on changed behavior between Nuxt 2 and Nuxt 3?
Can the team allocate dedicated time for upgrading?
Spend some initial research time to gauge these aspects and come up with an estimation. Then, compare that to the expected gain from (1). We will not be able to provide a precise formula, but hopefully this can help with the decision process.

## Stay on Nuxt 2

Some teams may not be able to upgrade to Nuxt 3 by this timeline due to limited bandwidth, budget, risk tolerance, or reliance on Nuxt-3-incompatible dependencies. We totally understand this, and want to ensure that staying on Nuxt 2 beyond EOL is a viable option.

## The Technical Perspective

From a technical perspective, Nuxt 2 is a stable and battle-tested piece of technology. If it is serving you well now, it will continue to do so for the foreseeable future.

Nuxt 2.17 will be the maintained release before EOL hits, so if you intend to stay on Nuxt 2, you should at least upgrade to Nuxt 2.17.

## Security & Compliance

For some teams, the main concern lies in security, compliance, and browser compatibility.

You won’t receive security fixes from EOL software. For the record, Nuxt 2 has had very few security vulnerabilities. That said, you may need a supported version to fulfill regulations or company policies.

If you are shipping your application to customers with SLAs (Service Level Agreements). You will want to avoid including EOL software in your stack.

Browsers sometimes ship changes that break legacy libraries. This is extremely rare, but could happen, in theory.

To address these concerns, we have partnered with industry experts to provide Extended LTS (Long Term Support) for Nuxt 2. This service will provide a version of Nuxt 2 that will continue to receive security and browser compatibility fixes, with SLAs. If you expect to be using Nuxt 2 beyond the EOL date of December 31st, 2023, make sure to plan ahead: Learn more about [HeroDevs’ NES (Never-Ending Support) for Nuxt 2](https://www.herodevs.com/support/nes-vue?utm_source=nuxt-js&utm_medium=affiliate&utm_campaign=nuxt&utm_content=link).

Loading

0 comments on commit e5b0308

Please sign in to comment.