Create a Next.js app with Simple Analytics

About this guide

This development guide walks you through everything you need to do to build a high-quality Next.js app integrated with Simple Analytics. 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 Simple Analytics and automatically track pageviewsGet the code

  The easiest way to add Simple Analytics to your app is with the analytics library. Create a new file called analytics.js where you instantiate the analytics library and the @analytics/simple-analytics plugin. To automatically track every page view in Simple Analytics 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 Simple AnalyticsGet 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 Simple Analytics Boilerplate. You'll get a complete Next.js codebase with Simple Analytics 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