Create a Next.js app with Amplitude

About this guide

This development guide walks you through everything you need to do to build a high-quality Next.js app integrated with Amplitude. Check out the tasks below to get started. To save time, you can also use our boilerplate, which gives you a complete React codebase with all of these tasks done for you. Okay, let's dive in!

Tasks

• Setup your Next.js appGet the code

  Create a Next.js app using npx create-next-app and then run your project locally with the npm run dev command.

• Integrate Amplitude and automatically track pageviewsGet the code

  The easiest way to add Amplitude to your app is with the analytics library. Create a new file called analytics.js where you instantiate the analytics library and the @analytics/amplitude plugin. To automatically track every page view in Amplitude you'll want to import Router from next/router use the Router.events.on('routeChangeComplete', callback) function, and fire off analytics.page() within the callback. Finally, import your custom analytics.js file in you App component so that it's included on all pages.

• Track events in AmplitudeGet the code

  To track events in your app you just need to export the analytics object from the custom analytics.js file you previously setup, import it wherever needed, and then call analytics.track('eventName', data).

Get the code

You can get the code for this guide with our Next.js and Amplitude Boilerplate. You'll get a complete Next.js codebase with Amplitude integration, all the tasks listed above done for you, and a responsive multi-page template. It should save you about two weeks of development time.

Get the boilerplate