@gen3labs/futurepass-auth-react

Community fork of @futureverse/auth-react.

Community fork (gen3labs)

Published under @gen3labs by markibanez as a post-Futureverse-winddown community continuation. Backed by the gen3labs-operated issuer at futurepass.gen3labs.tech and signer at fpsigner.gen3labs.tech. Surface area mirrors the upstream @futureverse/* package one-for-one — switch the import path; the code shape is the same. Register OAuth2 clients at https://futurepass.gen3labs.tech/manageclients.

Version

5.0.4

Published

2026-04-28

License

n/a

Status

fork-active

npm

https://www.npmjs.com/package/@gen3labs/futurepass-auth-react

Types

./index.d.ts

Maintainers

markibanez

Depends on

@gen3labs/futurepass-signer · @gen3labs/futurepass-auth

Peer deps

react · viem · wagmi · @tanstack/react-query

Recent versions

5.0.4

## Technical notes

Why use it

React app wanting maintained auth context.

When to skip it

—

Pairs with

• @gen3labs/futurepass-auth — core

Alternatives

• @futureverse/auth-react (fv-winddown) —

Upstream README

Futureverse Auth React

Provides a React authentication provider for Futureverse Auth.

Installation

NPM:

    npm install @futureverse/auth-react --save

    npm install wagmi viem@2.x @tanstack/react-query

Yarn:

    yarn add @futureverse/auth-react
    yarn add wagmi viem@2.x @tanstack/react-query

Usage

Config.ts

import { FutureverseAuthClient } from '@futureverse/auth-react';
import { createWagmiConfig } from '@futureverse/wagmi-connectors';
import { QueryClient } from '@tanstack/react-query';
import { mainnet, sepolia } from 'viem/chains';
import { cookieStorage, createStorage } from 'wagmi';

// Create your auth client
export const authClient = new FutureverseAuthClient({
  clientId: '<your-futureverse-client-id>',
  redirectUri: 'http://localhost:3000',
  signInFlow: 'redirect', // 'redirect' | 'popup'
  // Optional configuration
  authorizationURL: 'https://futurepass.gen3labs.tech', // Optional - defaults to Gen3
  signerURL: 'https://fpsigner.gen3labs.tech', // Optional - defaults to Gen3
  postLogoutRedirectUri: 'http://localhost:3000',
  hostWeb3SigningDomain: 'localhost:3000',
  chainId: 7672, // Optional - defaults to TRN Mainnet 
});

// Create query client
export const queryClient = new QueryClient();

Providers.tsx

// For NextJS App Router if using NextJS client
'use client';

import { FutureverseAuthProvider } from '@futureverse/auth-react';
import { AuthUiProvider } from '@futureverse/auth-ui';
import { QueryClientProvider } from '@tanstack/react-query';
import { authClient, queryClient, wagmiConfig } from './config';

export default function Providers({
  children,
}: {
  children: React.ReactNode;
}) {
  return (
    <QueryClientProvider client={queryClient}>
        <FutureverseAuthProvider authClient={authClient}>
          {children}
        </FutureverseAuthProvider>
    </QueryClientProvider>
  );
}

Source: https://www.npmjs.com/package/@gen3labs/futurepass-auth-react · captured 2026-05-02