Next.js (App Router)

This guide assumes you are using the Next.js App Router (Next.js 14+).

Install the Nerve SDK

npm i @nerve-js/client @nerve-js/next

Create a providers wrapper

app/providers.tsx

'use client';
 
import { NerveProvider } from '@nerve-js/next';
import type React from 'react';
 
export default function Providers({ children }: { children: React.ReactNode }) {
  return (

    <NerveProvider

      redirectUrl="http://localhost:3000/callback/"

      afterRedirectUrl="http://localhost:3000/"

      signInUrl="http://localhost:3000/auth/login/">

      {children}

    </NerveProvider>
  );
}

Then wrap your app with the provider in your root layout:

app/layout.tsx

import Providers from './providers';
 
export default function RootLayout({
  children,
}: Readonly<{
  children: React.ReactNode;
}>) {
  return (
    <html lang="en">
      <body>

        <Providers>{children}</Providers>
      </body>
    </html>
  );
}

We separate the providers into their own file to keep client-side code isolated, which helps with better code organization and performance.

app/auth/login/page.tsx

import { NerveSignIn } from "@nerve-js/next"; 
 
export default async function LoginPage() {
  return (
    <>
      {/* your login page header/content... */}

      <NerveSignIn />
    </>
  )
}

Add a route for the auth redirect

app/auth/callback/page.tsx

export { NerveCallback as default } from "@nerve-js/next"

You can customize the callback url using the callbackUrl option in the NerveProvider component.

That's all!

You can start using the Nerve client in your application. Before making any requests, make sure to set your provider!

Basic Usage

import { useNerveClient } from '@nerve-js/next';
 
// Get the client instance
const client = useNerveClient();
 
// Set provider to sandbox before making any requests
await client.setProvider('sandbox');
 
// Now you can make requests
const patients = await nerve.patient.search({
  given: 'John',
  family: 'Doe',
  birthdate: '',
});
 
const data = await nerve.carePlan.search({
  patient: patients[0].id || '',
});

Currently only a client-side API is available.

Click here to return to the getting started page.