enuno/passwordless-docs

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

npm i @passwordlessdev/passwordless-nodejs

Basic Setup

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

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

Registration Example

// 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

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

# 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:

1. Install Node.js SDK
2. Configure environment variables
3. Implement registration endpoints
4. Implement verification endpoints
5. Handle session management

Frontend-Only Pattern

Use when integrating with existing API:

1. Clone React example
2. Configure backend URL in .env
3. Customize UI components
4. Integrate with your auth flow

Full-Stack Pattern

Use for complete implementation:

1. Set up backend with Node.js SDK
2. Use React example as frontend base
3. Connect frontend to your backend
4. Deploy both services
5. 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