@capgo/capacitor-neon

Overview

Native Neon Auth, JWT access, and basic Data API helpers for Capacitor

Start with initialize(); see Getting Started for the core methods and examples.

Platform support

Platform	Support	Notes
iOS	Yes	Native
Android	Yes	Native
Web	No	Guard with Capacitor.getPlatform()

Compatibility

Plugin version	Capacitor compatibility	Maintained
v8.*.*	v8.*.*	Yes

The plugin major version matches Capacitor (plugin v8 for Capacitor 8). Only the latest major version is actively maintained.

Core Capabilities

• Native Neon Auth client initialization.
• Email/password sign-in and sign-up.
• Email OTP, OAuth (Google, GitHub, Vercel), and session helpers.
• Native auth state listeners.
• JWT access for JavaScript or backend calls.
• Anonymous Data API tokens for signed-out users.
• Basic native select, insert, update, and delete helpers through the Neon Data API.

Recommended Architecture

Concern	Recommended path
Authentication	Use @capgo/capacitor-neon.
Session persistence and refresh	Use @capgo/capacitor-neon.
Advanced database queries	Use @neondatabase/neon-js with the native JWT.
Neon Functions or your own API	Send the native JWT as a Bearer token.

Source Of Truth

This reference is synced from src/definitions.ts in capacitor-neon.

Keep going from @capgo/capacitor-neon

If you are using @capgo/capacitor-neon to plan security and compliance, connect it with Encryption for the implementation detail in Encryption, Compliance for the implementation detail in Compliance, Capgo Security Scanner for the product workflow in Capgo Security Scanner, Capgo Security for the product workflow in Capgo Security, and Capgo Trust Center for the product workflow in Capgo Trust Center.