> ## Documentation Index
> Fetch the complete documentation index at: https://docs.openbridge.shop/llms.txt
> Use this file to discover all available pages before exploring further.
# Overview
> Customer authentication and account management using Shopify as your identity provider
```javascript theme={null}
openbridge.customer
```
Full customer authentication system using Shopify's Storefront API. No backend required - Shopify is your user database.
See [Types](/api/types/customer) for full interface definitions.
## Features
* **No Backend Needed** - Shopify handles all user data and authentication
* **Session Persistence** - Customer stays logged in across browser sessions
* **Reactive Updates** - Subscribe to auth state changes for automatic UI updates
* **Full Account Access** - Orders, addresses, profile management
## Methods
Initialize customer session
Log in with email and password
Create new customer account
Log out current customer
Get current customer profile
Check if a customer is logged in
Get the cached customer synchronously
Get the raw access token
Update customer profile
Get order history
List customer addresses
Add a new shipping address
Update an existing address
Remove a saved address
Set the default shipping address
Send password reset email
Reset password with token
Listen for auth changes
## Quick Example
```javascript theme={null}
// Initialize on page load - auto-restores session
const customer = await openbridge.customer.init()
if (customer) {
console.log(`Welcome back, ${customer.firstName}!`)
} else {
console.log('Not logged in')
}
// Subscribe to auth changes
openbridge.customer.subscribe((customer) => {
if (customer) {
showAccountMenu(customer)
} else {
showLoginButton()
}
})
// Login
const customer = await openbridge.customer.login('email@example.com', 'password')
// Get order history
const { orders } = await openbridge.customer.orders()
// Logout
await openbridge.customer.logout()
```
## How It Works
1. **Customer logs in** → Shopify validates credentials and returns an access token
2. **Token stored locally** → Saved in `localStorage` with expiration
3. **Token auto-restores** → Call `.init()` on page load to restore session
4. **Token used for API calls** → All customer operations use the stored token
Access tokens expire after a period set by Shopify (typically 2 weeks). The SDK automatically clears expired tokens.