Does Torn Paper Transition work in Nuxt 3?

Yes. Drop it into any page or component. The component is client-safe; Nuxt handles the SSR boundary automatically. If you want explicit client-only rendering, wrap in ` `.

Does Torn Paper Transition work with Vue 2?

No - the component uses the Vue 3 Composition API and ` ` syntax. Vue 2 support is not planned. If you need Vue 2, the HTML/CSS/JS variant works in any context.

Does Torn Paper Transition work with TypeScript in Vue?

Yes. The component is typed and works with both `vue-tsc` and Volar. Props match the `data-anm-*` attributes documented on the main detail page.

Will the animation flash before hydration in Nuxt SSR?

Brief flash is possible because GSAP needs the client to initialize. The component sets the parked state via `gsap.set` on `onMounted` before the first paintable frame. For above-the-fold use in SSR contexts, add a CSS opacity:0 default that the component clears.

GSAP component for Vue

Torn Paper Transition in Vue.

A scroll transition between two photos. The first image and its headline tear away from the bottom up, leaving a plain sheet of paper, then the paper tears away the same way onto the second. Fog Reveal swallows the image in atmosphere and Image Dissolve Scroll breaks it into patches; here it rips like a printed page.

Install

Install Torn Paper Transition in your Vue project

Torn Paper Transition ships as a copy-paste Vue 3 single-file component. The only dependency is GSAP - Vue's reactivity and lifecycle hooks replace the React useGSAP adapter, so no extra package is needed.

BASH

Integrate

Where it goes in your Vue app

Torn Paper Transition is a leaf-level interactive component. Drop it into any page, layout, or other component. It works in Vue 3 + Vite, Nuxt 3, and any standalone Vue setup.

In Nuxt, no special handling is needed - the component is client-safe and self-cleaning. If you want to ensure it never runs on the server (rare), wrap your usage in <ClientOnly>.

The component uses the <script setup> composition API and TypeScript-friendly defineProps.

Gotchas

Vue-specific gotchas

GSAP cleanup in onUnmounted, not onBeforeUnmount

Use onUnmounted to kill tweens and ScrollTriggers. onBeforeUnmount fires while the DOM is still mounted, but onUnmounted is the more idiomatic place for animation cleanup in Vue 3.

Template refs are .value, not .current

const el = ref(null); access as el.value (not el.current like React). Pass el.value into gsap.to / gsap.from targets.

Plugin registration (gsap.registerPlugin(ScrollTrigger, ...)) can run at module top level in Vue 3 + Vite because the build is client-first. In Nuxt with SSR, wrap in if (process.client) or place inside onMounted.

FAQ

Common questions

Does Torn Paper Transition work in Nuxt 3?: Yes. Drop it into any page or component. The component is client-safe; Nuxt handles the SSR boundary automatically. If you want explicit client-only rendering, wrap in .
Does Torn Paper Transition work with Vue 2?: No - the component uses the Vue 3 Composition API and Torn Paper Transition for Vue - GSAP component | Annnimate