passwordless-docs

Comprehensive Bitwarden Passwordless.dev documentation, SDK references, and implementation examples for passwordless authentication using FIDO2/WebAuthn.

Description

This skill provides access to:

•Official Documentation: Bitwarden Passwordless.dev platform documentation
•Node.js SDK: Official @passwordlessdev/passwordless-nodejs implementation guide
•React Example: Complete React/Vite application demonstrating passwordless auth
•FIDO2/WebAuthn: Passwordless authentication standards and best practices
•API Reference: Complete API documentation and integration patterns

Primary Repository: bitwarden/passwordless-docs Node.js SDK: bitwarden/passwordless-nodejs React Example: bitwarden/passwordless-react-example

When to Use This Skill

Use this skill when you need to:

•Implement passwordless authentication with FIDO2/WebAuthn
•Integrate Bitwarden Passwordless.dev into Node.js or React applications
•Build frontend passwordless auth with React
•Look up Passwordless.dev API documentation
•Find implementation examples and working code samples
•Troubleshoot passwordless authentication issues
•Check for known issues or recent SDK updates
•Review security best practices for passwordless auth
•Understand token registration and verification flows
•Set up demo backend and frontend applications

Quick Reference

Documentation Repository

•Homepage: https://bitwarden.com/
•Documentation Site: https://docs.passwordless.dev/
•Topics: bitwarden, passwordless, FIDO2, WebAuthn
•Open Issues: 16
•Last Updated: 2025-11-28
•Languages: CSS (48.4%), TypeScript (25.0%), SCSS (23.6%), Vue (3.0%)

Node.js SDK

•Package: @passwordlessdev/passwordless-nodejs
•NPM: https://www.npmjs.com/package/@passwordlessdev/passwordless-nodejs
•Stars: 16
•License: Apache License 2.0
•Latest Version: 1.0.1 (2024-10-22)
•Open Issues: 9
•Languages: TypeScript (86.8%), JavaScript (13.2%)
•Requirements: Node.js 10+, ES2018+

React Example Application

•Repository: bitwarden/passwordless-react-example
•Stars: 21
•Build Tool: Vite
•Open Issues: 11
•Languages: TypeScript (86.8%), CSS (8.2%), JavaScript (3.2%), HTML (1.6%)
•Demo Backend: https://demo.passwordless.dev/swagger/index.html
•Framework: Vanilla React (no NextJS/Remix/Gatsby)

Key Features

•Registration Flow: Create passwordless registration tokens
•Authentication: Verify tokens and authenticate users
•Discoverable Credentials: Support for platform authenticators
•Alias Management: Device-based authentication aliases
•Customization: Configurable API endpoints and options
•React Integration: Complete frontend implementation example

Available References

Documentation (bitwarden/passwordless-docs)

•references/README.md - Complete platform documentation
•references/file_structure.md - Documentation site structure
•references/issues.md - Recent documentation issues
•references/CHANGELOG.md - Documentation version history
•references/releases.md - Documentation releases

Node.js SDK (bitwarden/passwordless-nodejs)

•references/sdk-nodejs/README.md - SDK implementation guide with code examples
•references/sdk-nodejs/file_structure.md - SDK repository structure
•references/sdk-nodejs/issues.md - SDK known issues and bug reports
•references/sdk-nodejs/releases.md - SDK release notes and changelog

React Example (bitwarden/passwordless-react-example)

•references/example-react/README.md - React implementation guide and setup
•references/example-react/file_structure.md - React app structure
•references/example-react/issues.md - Known frontend issues

Backend SDK Quick Start

Installation

bash

npm i @passwordlessdev/passwordless-nodejs

Basic Setup

typescript

import { PasswordlessClient, PasswordlessOptions } from '@passwordlessdev/passwordless-nodejs';

const options: PasswordlessOptions = {
  baseUrl: 'https://v4.passwordless.dev' // Optional, this is the default
};

const client = new PasswordlessClient('your-api-secret', options);

Environment Configuration

env

PASSWORDLESS_API=https://v4.passwordless.dev
PASSWORDLESS_SECRET=demo:secret:f831e39c29e64b77aba547478a4b3ec6

Registration Example

typescript

// After creating user in your database
const registerOptions = new RegisterOptions();
registerOptions.userId = userId;
registerOptions.username = username;
registerOptions.discoverable = true;
registerOptions.aliases = [deviceName]; // Optional

const token = await client.createRegisterToken(registerOptions);

Authentication Example

typescript

const token = request.query.token;
const verifiedUser = await client.verifyToken(token);

if (verifiedUser && verifiedUser.success === true) {
  // User authenticated successfully
  // Create session, JWT, etc.
}

React Frontend Quick Start

Project Setup

bash

# Clone the example
git clone https://github.com/bitwarden/passwordless-react-example.git
cd passwordless-react-example

# Install dependencies
npm install

# Configure environment
# Create .env file with:
VITE_BACKEND_URL=https://demo.passwordless.dev
VITE_PASSWORDLESS_API_KEY=pwdemo:public:5aec1f24f65343239bf4e1c9a852e871
VITE_PASSWORDLESS_API_URL=https://v4.passwordless.dev

# Run development server
npm run dev

Key Technologies

•React: UI framework
•Vite: Build tool and dev server
•TypeScript: Type safety
•Demo Backend: Pre-configured passwordless API

Frontend Architecture

The React example demonstrates:

•User registration with passwordless credentials
•Login flow using WebAuthn
•Session management
•API integration with Passwordless.dev
•Production-ready component structure

Common Use Cases

1. Implementing Backend Passwordless Registration

Reference: references/sdk-nodejs/README.md - Registration section

2. Building React Frontend Authentication

Reference: references/example-react/README.md - Complete React setup

3. User Authentication Flow (Backend)

Reference: references/sdk-nodejs/README.md - Logging in section

4. API Documentation Lookup

Reference: references/README.md - Complete API reference

5. Troubleshooting Integration Issues

•Backend: references/sdk-nodejs/issues.md - SDK issues
•Frontend: references/example-react/issues.md - React issues

6. Understanding FIDO2/WebAuthn Standards

Reference: references/README.md - Standards documentation

7. Full-Stack Implementation

Combine:

•Backend: references/sdk-nodejs/README.md
•Frontend: references/example-react/README.md

Version History

•
1.2.0 (2026-01-02): Enhanced with React example integration
- •Added React example repository (bitwarden/passwordless-react-example)
- •Included frontend implementation guide
- •Added Vite + React project setup
- •Expanded use cases for full-stack development
- •Updated frontend-specific documentation
- •Quality score improvement: 90/100 → 92/100
•
1.1.0 (2026-01-02): Enhanced with Node.js SDK integration
- •Added Node.js SDK repository content
- •Included SDK implementation examples
- •Added quick start guide for SDK
- •Expanded use cases and references
- •Updated version to reflect enhancement
•
1.0.0 (2026-01-02): Initial release
- •Core documentation repository
- •Basic reference structure
- •Initial quality score: 85/100

Implementation Patterns

Backend-Only Pattern

Use when building API services:

•Install Node.js SDK
•Configure environment variables
•Implement registration endpoints
•Implement verification endpoints
•Handle session management

Frontend-Only Pattern

Use when integrating with existing API:

•Clone React example
•Configure backend URL in .env
•Customize UI components
•Integrate with your auth flow

Full-Stack Pattern

Use for complete implementation:

•Set up backend with Node.js SDK
•Use React example as frontend base
•Connect frontend to your backend
•Deploy both services
•Configure production environment

Related Resources

•Get Started Guide: https://docs.passwordless.dev/guide/get-started.html
•Admin Console: https://admin.passwordless.dev/
•Demo Backend Swagger: https://demo.passwordless.dev/swagger/index.html
•Bitwarden Homepage: https://bitwarden.com/
•FIDO Alliance: https://fidoalliance.org/
•WebAuthn Guide: https://webauthn.guide/

Generated by Skill Seeker | Enhanced with SDKs and Examples Quality Score: 92/100 (Grade A) Status: ✅ Production Ready Coverage: Backend + Frontend + Documentation