isitme

library0.0.7jsnpmunverified

The `isitme` package (currently version 0.0.7) provides a highly streamlined and zero-configuration solution for passkey-based authentication, specifically engineered for solo developers or 'solo builders'. It abstracts away the complexities of implementing WebAuthn, offering a simple 'no accounts, just your fingerprint' approach to secure access. The library facilitates both passkey registration and subsequent login flows, leveraging device-native authentication methods without the need for traditional backend user management or database integration. It offers first-class integrations with popular JavaScript frameworks such as React, Hono, Next.js, and Vue, providing framework-specific components or utilities that handle the entire passkey lifecycle. Its core differentiator lies in its extreme simplicity and developer experience, aiming for rapid integration and minimal friction for securely gating content or functionality. While in early development (pre-1.0), it focuses on providing a robust yet easy-to-use authentication layer for personalized, secure access.

auth-security web-framework

npm install isitme

github ↗package ↗homepage ↗

INSTALL

IMPORT

SIG · ISITME

isitme

auth-securityjavascriptv0.0.7

Install

—

Import

—

Disk

—

Pass rate

0/ 6

Env Coverage0 / 6

glibc

18–22

musl

18–22

Install & Compatibility

Where this runs

tested against v? · npm install

Install × environment matrix

Each cell = how many times install + import succeeded across repeated harness runs. Partial = flaky.
glibc = Debian/Ubuntu slim · musl = Alpine Linux

musl

node 18–226 runs

build_error

glibc

node 18–226 runs

build_error

Code

Verified usage

Verified import paths — ran on the pinned version, not inferred.

IsItMe

✓ import { IsItMe } from 'isitme/react';

✗ import IsItMe from 'isitme/react';

The `IsItMe` component is a named export from the React specific entry point.

Tailwind CSS Import

✓ @import 'isitme/tailwind.css';

This CSS import is necessary for Tailwind CSS 4 users to ensure `isitme` components are correctly styled by Tailwind.

createAuthMiddleware

✓ import { createAuthMiddleware } from 'isitme/hono';

✗ const { createAuthMiddleware } = require('isitme/hono');

This is an inferred example for Hono framework integration; specific export names and paths for other frameworks (Next.js, Vue) will vary but follow similar patterns. `isitme` primarily uses ESM.

This quickstart demonstrates how to protect a React component using the `IsItMe` wrapper. It handles passkey registration on first visit and subsequent authentication.

import { IsItMe } from "isitme/react"; function AdminPage() { return ( <IsItMe> <h1>Admin dashboard</h1> <p>Only you, authenticated via passkey, can see this sensitive content. Upon your first visit, a passkey will be registered; subsequent visits will require authentication via your registered passkey.</p> <button onClick={() => console.log('Logout functionality not shown, but would clear local auth state.')}>Sign Out (placeholder)</button> </IsItMe> ); } // To integrate with a Next.js App Router, you might use it like this: // export default function Page() { // return <AdminPage />; // }

Debug

Known issues

breakingAs a pre-1.0 library (version 0.0.7), `isitme` does not guarantee API stability. Breaking changes may occur in minor or even patch releases.

fix

Pin exact versions (e.g., `npm install isitme@0.0.7`) and review release notes carefully when updating to new versions.

affects: >=0.0.1

gotchaPasskey authentication, based on WebAuthn, requires a secure context (HTTPS) for production environments and in many development scenarios (except localhost).

fix

Always serve your application over HTTPS in production. For local development, ensure your development server is configured for HTTPS or use `localhost` directly.

affects: >=0.0.1

gotchaWhen using Tailwind CSS 4, `isitme` components will appear unstyled unless its specific CSS import is included.

fix

Add `@import 'isitme/tailwind.css';` to your main CSS entry point, as documented in the README.

affects: >=0.0.1

gotchaPasskey support (WebAuthn) varies across browsers, operating systems, and specific hardware. Some older devices or less common browsers may not fully support the API.

fix

Inform users about passkey compatibility and consider providing alternative authentication methods or graceful degradation for unsupported environments if broad accessibility is critical.

affects: >=0.0.1

Errors

Common errors & fixes

ReferenceError: IsItMe is not defined

The React component `IsItMe` was imported incorrectly, likely as a default import instead of a named import.

fix

Change your import statement to `import { IsItMe } from 'isitme/react';`.

DOMException: The operation either timed out or was not allowed. (WebAuthn)

This error typically occurs during passkey registration or authentication when the user declines the prompt, or a browser/OS security policy prevents the operation (e.g., pop-up blockers, no biometric sensor detected).

fix

Ensure the user is actively consenting to the passkey prompt. Verify device settings for biometrics/security keys. Ensure your origin is considered secure (HTTPS).

Error: No credentials available. Are you running on HTTPS?

WebAuthn APIs require a secure context (HTTPS) to function correctly, for security reasons.

fix

Ensure your application is being served over HTTPS. If developing locally, ensure your development server is configured for HTTPS or verify you are accessing via `localhost`.

Upgrade

Version history

0.0.7latest on npm

Audit

Dependencies

expressoptionalPeer dependency for potential server-side integration or middleware in Express applications.

cookie-parseroptionalPeer dependency for handling session cookies or authentication tokens in server environments.

reactoptionalPeer dependency for using the `isitme/react` component integration.

react-domoptionalPeer dependency for using the `isitme/react` component integration.

honooptionalPeer dependency for integration with the Hono web framework.

nextoptionalPeer dependency for integration with the Next.js framework.

vueoptionalPeer dependency for integration with the Vue.js framework.

Agent activity

9 hits · last 30 days

node

OpenAI (training)

Resources

githubhttps://github.com/isitme-dev/isitme ↗

packagehttps://www.npmjs.com/package/isitme ↗

homepagehttps://isitme.dev ↗