chore(docs): update customer account docs

Signed-off-by: Frederik Bußmann <frederik@bussmann.io>

Author: freb97

docs/content/2.essentials/4.customer-account.md

@@ -12,17 +12,94 @@ seo:
 The Customer Account API is a public API that allows you to access your Shopify store's customer data,
 such as customer profiles, addresses, and order history.
 It is designed to be used in client-side applications, such as a Nuxt frontend.
-To use the Customer Account API, you need to obtain a client id and optionally a client secret.
+To use the Customer Account API, you need to obtain a client id.
+Confidential client authentication is currently not supported, so a client secret is not required.
 
 ::note
 See the [module configuration](/essentials/configuration) to see how to set up the module for the Customer Account API.
 If you need help obtaining your client credentials, see the [Shopify Setup Guide](/essentials/setup-shopify).
 ::
 
-## Usage
+## Setup
+
+For the type generation to work correctly, make sure to install the `@shopify/hydrogen` package for the appropriate version of the API 
+you are using (e.g. `@shopify/hydrogen@2026.4.0` for API version 2026-04).
+
+```bash
+npm install @shopify/hydrogen
+```
+
+For the customer account authentication flow, also make sure to install the `nuxt-auth-utils` package:
+
+```bash
+npm install nuxt-auth-utils
+```
+
+Then, once configured, you can use the Customer Account API in your Nuxt application via the `useCustomerAccount`
+and `useCustomerAccountData` composables. The `useCustomerAccount` composable is available to both server and client-side.
+
+## Authentication
+
+The module provides built-in routes for the OAuth authentication flow. You do not need to create these routes yourself.
+
+### Logging in
+
+To initiate the login flow, redirect the user to `/_auth/customer-account/callback`:
+
+```vue [~/app/pages/account.vue]
+<script setup lang="ts">
+function login() {
+  navigateTo('/_auth/customer-account/callback')
+}
+</script>
+
+<template>
+  <button @click="login">Log in</button>
+</template>
+```
+
+### Logging out
 
-Once configured, you can use the Customer Account API in your Nuxt application via the `useCustomerAccount`
-composable. It is available to both server and client-side.
+To log the user out, redirect them to `/_auth/customer-account/logout`:
+
+```vue [~/app/pages/account.vue]
+<script setup lang="ts">
+function logout() {
+  navigateTo('/_auth/customer-account/logout')
+}
+</script>
+
+<template>
+  <button @click="logout">Log out</button>
+</template>
+```
+
+### Checking login status
+
+The module uses [`nuxt-auth-utils`](https://github.com/atinux/nuxt-auth-utils) under the hood to manage the session.
+You can use its composables to check whether a user is currently authenticated:
+
+```vue [~/app/pages/account.vue]
+<script setup lang="ts">
+const { loggedIn, user } = useUserSession()
+</script>
+
+<template>
+  <div v-if="loggedIn">
+    <p>Logged in as {{ user?.email }}</p>
+  </div>
+  <div v-else>
+    <button @click="navigateTo('/_auth/customer-account/callback')">
+      Log in
+    </button>
+  </div>
+</template>
+```
+
+Once the user is authenticated, you can use the `useCustomerAccount` and `useCustomerAccountData` composables
+to fetch customer data from the Customer Account API.
+
+## Usage
 
 ### Client-side
 

docs/content/2.essentials/7.caching.md

@@ -11,6 +11,11 @@ seo:
 If you want to improve the performance of your Nuxt Shopify app, consider using a cache for your Storefront API and Admin API requests.
 Caching can help reduce the number of API calls, decrease latency, and improve the overall user experience.
 
+::note
+Client side and proxy caching is only available for the Storefront API.
+Customer account API and Admin API requests can only be cached on the server side using Nitro's caching utilities.
+::
+
 ## Configuration
 
 In the `nuxt.config.ts`, you can configure caching options for client side requests and