docs: address additional PR feedback

Author: athexweb3

.gitignore

@@ -190,3 +190,6 @@ tsconfig.tsbuildinfo
 # agents
 .claude/settings.local.json
 .agent/
+
+# exclude docs lib
+!docs/lib

docs/app/api/releases/route.ts

@@ -36,6 +36,14 @@ const getContributorDetails = unstable_cache(
 
             if (!res.ok) {
                 if (res.status === 404) return null;
+                if (res.status === 403) {
+                    console.warn(`[API] Rate limit hit for user ${login}. Using fallback.`);
+                    return {
+                        login,
+                        avatar_url: `https://github.com/${login}.png`,
+                        html_url: `https://github.com/${login}`
+                    };
+                }
                 throw new Error(`GitHub User API Error: ${res.status}`);
             }
 

docs/components/CoverageTable.tsx

@@ -194,7 +194,7 @@ export function CoverageTable() {
             ) : (
                 filteredCategories.map((category) => (
                     <div key={category.title} className="bg-fd-card rounded-xl border border-fd-border overflow-hidden">
-                        <div className="px-6 py-4 bg-fd-secondary/30 border-b border-fd-border">
+                        <div className="px-6 py-4 bg-fd-card border-b border-fd-border sticky top-[var(--fd-nav-height)] z-10">
                             <h3 className="font-semibold text-lg">{category.title}</h3>
                             {category.description && (
                                 <p className="text-sm text-fd-muted-foreground mt-1">{category.description}</p>

docs/content/docs/guides/migration.mdx

@@ -9,7 +9,7 @@ import { Step, Steps } from 'fumadocs-ui/components/steps';
 If you are coming from `react-native-crypto` (the slow, standard shim) or `expo-crypto`, here is how to upgrade.
 
 ## Why Upgrade?
-*   **Performance**: 10x-60x faster depending on the operation.
+*   **Performance**: **Hundreds of times faster** (via C++/JSI).
 *   **Compatibility**: Supports modern Node.js 16+ crypto APIs.
 *   **Correctness**: Passes the official Node.js test suite.
 
@@ -76,6 +76,8 @@ If you only need simple hashing (SHA-256), `expo-crypto` is fine. If you need **
 
 **Expo Crypto (digest):**
 ```ts
+import * as Crypto from 'expo-crypto';
+
 const digest = await Crypto.digestStringAsync(
   Crypto.CryptoDigestAlgorithm.SHA256,
   'Hello world'

docs/content/docs/introduction/comparison.mdx

@@ -12,7 +12,7 @@ RNQC is designed to be the faster, more complete alternative to existing solutio
 
 | Feature | RNQC | react-native-crypto | react-native-fast-crypto |
 | :--- | :---: | :---: | :---: |
-| **Performance** | **JSI** (Native C++) | 🐢 Bridge (JS-shim) | ⚡️ JSI (Partial) |
+| **Performance** | **Nitro** (Native C++) | 🐢 Bridge (JS-shim) | ⚡️ JSI (Partial) |
 | **Node.js API** | **1:1 Compatible** | Compatible | Custom API |
 | **Sync Methods** | Fully Supported | Async Only | Supported |
 | **Thread Safety** | **Off-Main-Thread** | Blocks JS Thread | Off-Main-Thread |
@@ -29,7 +29,7 @@ sequenceDiagram
     participant JS as Javascript Code
     participant B as Bridge (JSON)
     participant N as Native Module
-    participant JSI as RNQC (JSI)
+    participant Nitro as RNQC (Nitro)
     
     note over JS, B: Standard Module (Slow)
     JS->>B: Serialize JSON (Base64)
@@ -38,10 +38,10 @@ sequenceDiagram
     N->>B: Send Result JSON
     B->>JS: Deserialize JSON
     
-    note over JS, JSI: RNQC (Fast)
-    JS->>JSI: Direct C++ Call (ArrayBuffer Ref)
-    JSI->>JSI: Hash Memory Directly
-    JSI->>JS: Return Result
+    note over JS, Nitro: RNQC (Fast)
+    JS->>Nitro: Direct C++ Call (ArrayBuffer Ref)
+    Nitro->>Nitro: Hash Memory Directly
+    Nitro->>JS: Return Result
 ```
 
 ---
@@ -57,7 +57,7 @@ Standard React Native modules (like `react-native-crypto`) communicate via the B
 3.  **Native**: Deserializes JSON, decodes Base64 to bytes.
 4.  **Native**: Hashes bytes.
 
-**RNQC (JSI)**:
+**RNQC (Nitro)**:
 1.  **JS**: Holds a reference to an `ArrayBuffer`.
 2.  **C++**: Reads that memory address directly. **Hash.**
 3.  **Done.**
@@ -72,14 +72,16 @@ JSI allows us to define "Hybrid Objects" that can spawn their own C++ threads. W
 Proof is in the numbers. We benchmarked RNQC against standard JS implementations (`browserify`) and other native libraries.
 
 <Callout type="info">
-  **Benchmark Philosophy**: These comparisons are not meant to disparage pure JavaScript libraries. Libraries like `@noble/hashes` and `@noble/curves` perform exceptionally well in browser and Node.js environments. However, React Native lacks Node.js crypto APIs, so these benchmarks demonstrate the performance advantage of native implementations when pure JS is the only alternative on mobile.
+  **Benchmark Philosophy**: This is not meant to disparage the other libraries. On the contrary, they perform amazingly well when used in a server-side Node environment or browser. This library exists because React Native does not have that environment nor the Node Crypto API implementation at hand. So the benchmark suite is there to show you the speedup vs. the alternative of using a pure JS library on React Native.
 </Callout>
 
 **Environment**: iPhone 15 Pro, iOS 17.
 
 ## 1. Hashing (BLAKE3)
 
-BLAKE3 is optimized for speed. RNQC (via JSI) processes large inputs **90x faster** than JS implementations.
+![Blake3 Benchmark](/img/benchmarks/blake3.png)
+
+BLAKE3 is optimized for speed. RNQC (via Nitro) processes large inputs **90x faster** than JS implementations.
 
 | Operation | RNQC | @noble/hashes | Speedup |
 | :--- | :--- | :--- | :--- |
@@ -89,15 +91,20 @@ BLAKE3 is optimized for speed. RNQC (via JSI) processes large inputs **90x faste
 
 ## 2. Encryption (AES-GCM / Salsa20)
 
+![Cipher Benchmark](/img/benchmarks/cipher.png)
+
 Native encryption prevents frame drops. `AES-256-GCM` is over **100x faster** for large buffers.
 
 | Operation | RNQC | JS / Browserify | Speedup |
 | :--- | :--- | :--- | :--- |
 | **XSalsa20 (64KB)** | **852 ops/s** | 7.39 ops/s | **115x** 🚀 |
-| **AES-256-GCM (1MB)** | **177 ops/s** | 0.18 ops/s | **962x** 🚀 |
+| **AES-256-GCM (1MB)** | **177 ops/s** | 0.18 ops/s (browserify) | **962x** 🚀 |
+| **AES-256-GCM (1MB)** | **177 ops/s** | 1.32 ops/s (@noble) | **134x** 🚀 |
 
 ## 3. Key Derivation (PBKDF2)
 
+![PBKDF2 Benchmark](/img/benchmarks/pbkdf2.png)
+
 Password hashing is computationally expensive. Running this on the JS thread freezes the UI.
 
 | Operation | RNQC | @noble/hashes | Speedup |
@@ -107,6 +114,8 @@ Password hashing is computationally expensive. Running this on the JS thread fre
 
 ## 4. Signatures (Ed25519)
 
+![Ed25519 Benchmark](/img/benchmarks/ed25519.png)
+
 Essential for crypto wallets. Verify signatures instantly without lag.
 
 | Operation | RNQC | @noble/curves | Speedup |
@@ -116,6 +125,8 @@ Essential for crypto wallets. Verify signatures instantly without lag.
 
 ## 5. HKDF
 
+![HKDF Benchmark](/img/benchmarks/hkdf.png)
+
 Standard key derivation is **over 100x faster**.
 
 | Operation | RNQC | @noble/hashes | Speedup |

docs/content/docs/introduction/complete-setup.mdx

@@ -203,12 +203,12 @@ yarn start --reset-cache
 If you need to use the `xsalsa20` cipher algorithm, you must enable libsodium support by setting an environment variable **before building your native code**:
 
 ```bash
-export RN_QUICK_CRYPTO_LIBSODIUM=1
+export SODIUM_ENABLED=1
 ```
 
 This can be done:
-- **iOS**: Set in your Xcode build settings or in a pre-build script
-- **Android**: Add to your `gradle.properties` or as a build environment variable
+- **iOS**: Export the variable `export SODIUM_ENABLED=1` before running `pod install`.
+- **Android**: Add `sodiumEnabled=true` to your project's `gradle.properties` file.
 
 <Callout type="warn">
   Without this flag, attempting to use `xsalsa20` will throw a runtime error: `"libsodium must be enabled to use this cipher"`

docs/data/coverage.ts

@@ -101,6 +101,7 @@ export const COVERAGE_DATA: CoverageCategory[] = [
                     { name: 'asymmetricKeyDetails', status: 'missing' },
                     { name: 'equals', status: 'missing' },
                     { name: 'symmetricKeySize', status: 'missing' },
+                    { name: 'toCryptoKey', status: 'missing' },
                     { name: 'from', status: 'missing', note: 'static' }
                 ]
             },
@@ -118,8 +119,8 @@ export const COVERAGE_DATA: CoverageCategory[] = [
             { name: 'constants', status: 'implemented' },
             { name: 'createCipheriv', status: 'implemented' },
             { name: 'createDecipheriv', status: 'implemented' },
-            { name: 'createDiffieHellman', status: 'implemented' },
-            { name: 'createDiffieHellmanGroup', status: 'implemented' },
+            { name: 'createDiffieHellman', status: 'missing' },
+            { name: 'createDiffieHellmanGroup', status: 'missing' },
             { name: 'createECDH', status: 'missing' },
             { name: 'createHash', status: 'implemented' },
             { name: 'createHmac', status: 'implemented' },
@@ -186,7 +187,7 @@ export const COVERAGE_DATA: CoverageCategory[] = [
             { name: 'getCipherInfo', status: 'missing' },
             { name: 'getCiphers', status: 'implemented' },
             { name: 'getCurves', status: 'missing' },
-            { name: 'getDiffieHellman', status: 'implemented' },
+            { name: 'getDiffieHellman', status: 'missing' },
             { name: 'getFips', status: 'missing' },
             { name: 'getHashes', status: 'implemented' },
             { name: 'getRandomValues', status: 'implemented' },
@@ -231,6 +232,17 @@ export const COVERAGE_DATA: CoverageCategory[] = [
     {
         title: 'WebCrypto (Subtle)',
         items: [
+            {
+                name: 'crypto.subtle',
+                subItems: [
+                    { name: 'decapsulateBits', status: 'missing' },
+                    { name: 'decapsulateKey', status: 'missing' },
+                    { name: 'encapsulateBits', status: 'missing' },
+                    { name: 'encapsulateKey', status: 'missing' },
+                    { name: 'getPublicKey', status: 'missing' },
+                    { name: 'supports', status: 'missing' }
+                ]
+            },
             {
                 name: 'crypto.subtle.decrypt',
                 subItems: [

docs/lib/layout.shared.tsx

@@ -0,0 +1,9 @@
+import type { BaseLayoutProps } from 'fumadocs-ui/layouts/shared';
+
+export function baseOptions(): BaseLayoutProps {
+  return {
+    nav: {
+      title: 'React Native Quick Crypto',
+    },
+  };
+}

docs/lib/source.ts

@@ -0,0 +1,27 @@
+import { docs } from 'fumadocs-mdx:collections/server';
+import { type InferPageType, loader } from 'fumadocs-core/source';
+import { lucideIconsPlugin } from 'fumadocs-core/source/lucide-icons';
+
+// See https://fumadocs.dev/docs/headless/source-api for more info
+export const source = loader({
+  baseUrl: '/docs',
+  source: docs.toFumadocsSource(),
+  plugins: [lucideIconsPlugin()],
+});
+
+export function getPageImage(page: InferPageType<typeof source>) {
+  const segments = [...page.slugs, 'image.png'];
+
+  return {
+    segments,
+    url: `/og/docs/${segments.join('/')}`,
+  };
+}
+
+export async function getLLMText(page: InferPageType<typeof source>) {
+  const processed = await page.data.getText('processed');
+
+  return `# ${page.data.title}
+
+${processed}`;
+}