From 20db1f50188df1a7ea778b253f24d6bafbbbd958 Mon Sep 17 00:00:00 2001
From: Eric Shenghsiung Liu <ericliu121187@gmail.com>
Date: Wed, 18 Dec 2024 06:40:27 -0800
Subject: [PATCH] passkeys

---
 docs/pages/features/passkeys.mdx | 44 ++++++++++++++++++++++++++++++++
 vocs.config.tsx                  |  9 +++++++
 2 files changed, 53 insertions(+)
 create mode 100644 docs/pages/features/passkeys.mdx

diff --git a/docs/pages/features/passkeys.mdx b/docs/pages/features/passkeys.mdx
new file mode 100644
index 0000000..2362738
--- /dev/null
+++ b/docs/pages/features/passkeys.mdx
@@ -0,0 +1,44 @@
+import { Callout } from "vocs/components";
+
+## Passkeys
+
+<Callout type="info">
+  It's crucial to understand how passkeys work and how they are managed by the passkey provider (eg: Apple, Google, Microsoft) before using them. If a user loses access to their passkey, they will not be able to access their smart wallet.
+</Callout>
+
+### Overview
+Smart Wallet uses passkeys as the primary authentication method for both wallet access and transaction signing, replacing traditional private keys with a more secure and user-friendly solution.
+
+There is no way for developers to configure passkey options. This page is focused on how passkeys work for users.
+
+What is it used for?
+- Required for wallet sign-in and transaction approval
+- Used for adding additional passkeys and recovery
+- Managed by your passkey provider (eg: Apple, Google, Microsoft)
+- Supports cross-device access through provider sync
+
+### Adding Passkeys
+- New passkeys can be added using recovery keys
+- Multiple passkeys can be added to a Smart Wallet
+- Adding a passkey requires a transaction on each chain
+- Previous passkeys are not automatically removed
+
+### Removing Passkeys
+
+<Callout type="warning">
+  Removing keys is currently not supported in keys.coinbase.com.
+</Callout>
+
+### Considerations
+When using passkeys, consider checking with your provider about:
+- Backup and sync capabilities across devices
+- Recovery procedures and options
+- Device and operating system compatibility
+- Security and privacy practices
+
+### Platform Support and Resources
+Passkeys work with any platform that supports the WebAuthn standard, allowing for wide compatibility across different devices and browsers. While many providers offer passkey support, here are documentation links for some common ones:
+- iOS/macOS: [Apple Support - Use passkeys](https://support.apple.com/guide/iphone/use-passkeys-to-sign-in-to-websites-and-apps-iphf538ea8d0/ios)
+- Android: [Google Help - About passkeys](https://support.google.com/android/answer/13462838https://support.google.com/android/answer/14124480?hl=en-GB&sjid=5621630875911120810-NC)
+- Windows: [Microsoft Account - Passkey sign in](https://support.microsoft.com/windows/passkey-sign-in-windows-301c8944-5ea2-452b-9886-97e4d2ef4422)
+- Chrome: [Google Chrome Help - Use passkeys](https://support.google.com/chrome/answer/13168025)
diff --git a/vocs.config.tsx b/vocs.config.tsx
index 81ff357..5129254 100644
--- a/vocs.config.tsx
+++ b/vocs.config.tsx
@@ -72,6 +72,15 @@ export default defineConfig({
           text: "Networks",
           link: "/features/networks",
         },
+        {
+          text: "Key Management",
+          items: [
+            {
+              text: "Passkeys",
+              link: "/features/passkeys",
+            },
+          ],
+        },
       ],
     },
     {