[!NOTE] This is a fork of next-superjson-plugin that adds support for the latest versions of Next.js.

Installation

Install packages first:

npm install superjson superjson-next
# or Yarn
yarn add superjson superjson-next

Add the plugin into next.config.js

// next.config.js
module.exports = {
  experimental: {
    swcPlugins: [["superjson-next", {}]],
  },
};

Versions

| package version | Next.js versions | notes | | :-------------- | :------------------- | :------------------------------------------ | | 0.8.* | ^15.4.* \|\| ^16.* | | | 0.7.* | ^15.0.* | requires choosing router type (see release) |

Usage

/pages (Pages Directory)

// For pages router no further configuration is required.

export default function Page({ date }) {
  return <div>Today is {date.toDateString()}</div>;
}

// You can also use getInitialProps, getStaticProps
export const getServerSideProps = () => {
  return {
    props: {
      date: new Date(),
    },
  };
};

• Allows pre-rendering functions to return props including Non-JSON Values(Date, Map, Set..)

/app (App Directory)

// Use "data-superjson" attribute to pass non-serializable props to client components
// No needs to change the propsType of Client Component (It's type-safe!)

export default function ServerComponent() {
  const date = new Date();
  return <ClientComponent date={date} data-superjson />;
}

Options

You can use the excluded option to exclude specific properties from serialization.

['superjson-next', { excluded: ["someProp"] }],

• Provides data-superjson attribute for Server Component > Client Component Serialization.

How it works

sequenceDiagram
    participant Next.js
    participant SWC Plugin
    participant SuperJSON
    Next.js->>SWC Plugin: Request Transform
    SWC Plugin->>SWC Plugin: Transform Pages/Components <br> To Use SuperJSON
    SWC Plugin->>Next.js: Take Modules
    Next.js-->SuperJSON: Connected
    Next.js->>SuperJSON: Serialize Props <br> (Date, BigInt, Set, Map..)
    Note over SWC Plugin: getInitialProps <br> getServerSideProps <br> getStaticProps <br> Server Components
    SuperJSON->>Next.js: Deserialize Props
    Note over SWC Plugin: Pages <br> Client Components

Bug Report

⚠️ Keep in mind: SWC Plugin is still an experimental feature for Next.js

Plugin always ensures compatibility with Next.js Canary version only.

Leave an Issue

Special Thanks

• kdy1 (Main creator of swc project)