@fluido/dreno-nextjs

Changelog · Report a Bug · Request a Feature · Ask a Question

Overview

Dreno is one of the easiest way to add authentication and user management to your Next.js application. Add sign up, sign in, and profile management to your application in minutes.

Getting Started

Prerequisites

• Next.js v13+
• Node.js v16+

Installation

npm install @fluido/dreno-nextjs

Build

To build the package locally with the TypeScript compiler, run:

npm run build

To build the package in watch mode, run the following:

npm run dev

Usage

Dreno only requires your application to export a middleware.

Get your DRENO_KEY

Get your DRENO_KEY at dreno.fluido.design.

Add Environment Variable

Set DRENO_KEY to your .env.local file.

DRENO_KEY=[projectId]:•••••••••••

Create middleware.ts

At the root of your Next.js project, create a file named middleware.ts like the following:

import { drenoMiddleware } from '@fluido/dreno-nextjs/server'

export const middleware = drenoMiddleware()

export const config = {
  matcher: [
    /*
     * Standard Next.js matcher config.
     * Read more at Next's Documentation:
     * https://nextjs.org/docs/app/building-your-application/routing/middleware#matching-paths
     *
     */
    '/((?!api|_next/static|_next/image|favicon.ico).*)',
  ],
}

Access Info on Server Components

With async Server Components the getAuth function returns a Promise that you can await to get auth info.

import { getAuth } from '@fluido/dreno-nextjs/server'
import { notFound } from 'next/navigation'

export default async function Page() {
  const auth = await getAuth()

  if (!auth.isAuthorized) notFound()

  return <h1>Hello {auth.user.name}!</h1>
}

Access Info on Client Components

With Client Components the useAuth hook returns an auth info object.

'use client'

import { useAuth } from '@fluido/dreno-nextjs'

export function LogoutButton() {
  const auth = useAuth()

  return <button onClick={() => auth?.logout()}>Logout</button>
}

This is a bare minimum example that protects every route of your app. When trying to access any route, the visitor will be redirected to a custom domain provided by Fluido.

For further details on how to create your own login roudes, examples, and more, please refer to our Documentation.

Support

You can get in touch with us in any of the following ways:

• Join our official community Discord server
• Create a GitHub Discussion
• Contact options listed on our Support page

Contributing

We're open to all community contributions! If you'd like to contribute in any way, please read our contribution guidelines.

Security

@fluido/dreno-nextjs follows good practices of security, but 100% security cannot be assured.

@fluido/dreno-nextjs is provided "as is" without any warranty. Use at your own risk.

For more information and to report security issues, please refer to our security documentation.

License

This project is licensed under the MIT license.

See LICENSE for more information.