npm package discovery and stats viewer.

Discover Tips

  • General search

    [free text search, go nuts!]

  • Package details

    pkg:[package-name]

  • User packages

    @[username]

Sponsor

Optimize Toolset

I’ve always been into building performant and accessible sites, but lately I’ve been taking it extremely seriously. So much so that I’ve been building a tool to help me optimize and monitor the sites that I build to make sure that I’m making an attempt to offer the best experience to those who visit them. If you’re into performant, accessible and SEO friendly sites, you might like it too! You can check it out at Optimize Toolset.

About

Hi, 👋, I’m Ryan Hefner  and I built this site for me, and you! The goal of this site was to provide an easy way for me to check the stats on my npm packages, both for prioritizing issues and updates, and to give me a little kick in the pants to keep up on stuff.

As I was building it, I realized that I was actually using the tool to build the tool, and figured I might as well put this out there and hopefully others will find it to be a fast and useful way to search and browse npm packages as I have.

If you’re interested in other things I’m working on, follow me on Twitter or check out the open source projects I’ve been publishing on GitHub.

I am also working on a Twitter bot for this site to tweet the most popular, newest, random packages from npm. Please follow that account now and it will start sending out packages soon–ish.

Open Software & Tools

This site wouldn’t be possible without the immense generosity and tireless efforts from the people who make contributions to the world and share their work via open source initiatives. Thank you 🙏

© 2026 – Pkg Stats / Ryan Hefner

@puzzle-ui/fullstack

v0.12.0

Published

Browser auth client, React UI, server handlers, and Next.js and TanStack Start adapters for Puzzle Auth.

Readme

@puzzle-ui/fullstack

Documentation: https://puzzle-ui.com/docs/fullstack

@puzzle-ui/fullstack connects Puzzle Auth to browser clients, React UI, server routes, and framework adapters. Use it when an application needs a ready-to-use browser auth client or Request/Response handlers; configure auth policy, storage, and sessions with the lower-level packages.

Install

npm install @puzzle-ui/fullstack react react-dom

React and React DOM 19 are required peer dependencies. next (15 or 16) and @tanstack/react-start are optional peers for their respective adapters. On the server, configure the managers from @puzzle-ui/auth and @puzzle-ui/session with your storage backend. See the Auth docs, Storage docs, and developer authentication guide.

Client

Wrap the application in AuthProvider, then use the hooks or exported forms below it:

import { AuthProvider, useAuth, useUser } from "@puzzle-ui/fullstack/auth/client";

export const Providers = ({ children }: { children: React.ReactNode }) => (
  <AuthProvider options={{ basePath: "/api/auth" }}>{children}</AuthProvider>
);

export const Account = () => {
  const user = useUser();
  const { signOut } = useAuth();

  return user ? <button onClick={() => void signOut()}>{user.email} · Sign out</button> : null;
};

The client provides auth state and actions, sign-in/sign-up and MFA components, AuthExperience for branded registration flows, locale helpers, and passkey browser helpers. Browser state is not an authorization boundary; protect server resources independently.

Server and framework adapters

Create one server instance from configured auth and session managers, then register its routes:

import { createAuthServer, createAuthRouteHandlers } from "@puzzle-ui/fullstack/auth/server";

export const authServer = createAuthServer({
  auth,
  mfa,
  stepUp,
  sessions,
  cookie,
  csrf,
  resolveClientIp,
});

export const authRoutes = createAuthRouteHandlers(authServer);

Use @puzzle-ui/fullstack/auth/next for Next.js GET/POST route handlers or @puzzle-ui/fullstack/auth/tanstack to create a TanStack Start Request dispatcher. Configure cookies, CSRF, storage and trusted proxy IP resolution in the server layer. Do not expose server managers to browser bundles.

Entry points

  • @puzzle-ui/fullstack/auth/client — browser client, React provider/hooks/components, auth experience, localization, and passkey helpers.
  • @puzzle-ui/fullstack/auth/server — server handlers, route map, session and step-up helpers, lifecycle handlers, readiness checks.
  • @puzzle-ui/fullstack/auth/shared — serializable public auth contracts (types only).
  • @puzzle-ui/fullstack/auth/next — Next.js route-handler adapter.
  • @puzzle-ui/fullstack/auth/tanstack — TanStack Start adapter.

There is no root package export; import a documented subpath. See the full documentation for API details and production guidance.