refactor: update documentation structure and enhance UI components

- Refactored imports for Fumadocs UI components, organizing them by type for better clarity.
- Replaced AccordionItem with Accordion for improved component consistency.
- Updated API response time formatting to use HTML entities for better rendering.
- Enhanced various sections with Accordion and Card components to improve user experience and visual hierarchy.
- Ensured all documentation adheres to the latest Fumadocs UI standards for a cohesive look and feel.

Author: roderik

content/docs/application-kits/asset-tokenization/api-portal.mdx

@@ -337,7 +337,7 @@ class TokenizedAssetExchange {
 ## What are the performance specifications?
 
 ### API Performance Metrics
-- **Response Time:** <100ms average, <500ms 99th percentile
+- **Response Time:** &lt;100ms average, &lt;500ms 99th percentile
 - **Throughput:** 10,000 requests/second per instance
 - **Availability:** 99.9% uptime SLA
 - **Global Coverage:** CDN endpoints in 15 regions

content/docs/application-kits/asset-tokenization/asset-manager.mdx

@@ -170,9 +170,9 @@ For regulated assets like stablecoins and deposits, the Collateral section provi
 - **Proven Collateral**: Cryptographically verified reserves (updated every 15 minutes)
 - **Required Threshold**: Regulatory minimum (typically 100-150% for stablecoins)
 - **Current Ratio**: Live collateralization percentage with color-coded alerts:
-  - 🟢 **Green (>110%)**: Healthy over-collateralization
+  - 🟢 **Green (>110%)**: Healthy over-collateralization
   - 🟡 **Yellow (100-110%)**: Approaching minimum threshold
-  - 🔴 **Red (<100%)**: Immediate action required
+  - 🔴 **Red (&lt;100%)**: Immediate action required
 
 **Proof of Reserves System**
 - **Validation Timestamp**: When collateral was last verified by oracles
@@ -216,9 +216,9 @@ The Statistics section transforms raw blockchain data into actionable business i
 **Distribution Analysis**
 - **Gini Coefficient**: Mathematical measure of wealth distribution (0-1 scale)
 - **Wallet Segmentation**:
-  - Whales (>1% of supply): 5 wallets
+  - Whales (&gt;1% of supply): 5 wallets
   - Institutions (0.1-1%): 50 wallets  
-  - Retail (<0.1%): 10,000 wallets
+  - Retail (&lt;0.1%): 10,000 wallets
 - **Geographic Distribution**: Token holders by jurisdiction (KYC-verified)
 
 **Transaction Metrics**

content/docs/application-kits/asset-tokenization/ui-customization.mdx

@@ -4,7 +4,11 @@ description: "Learn how to customize, rebrand, and extend the SettleMint Asset T
 keywords: ["asset tokenization UI", "blockchain frontend customization", "Next.js DApp development", "SettleMint ATK branding", "React tokenization interface", "Tailwind CSS blockchain", "enterprise DApp customization", "Web3 UI components", "tokenization platform frontend", "blockchain application branding"]
 ---
 
-import { Callout, Cards, Steps, Tabs, Tab, Accordion, AccordionItem } from 'fumadocs-ui/components/callout';
+import { Callout } from 'fumadocs-ui/components/callout';
+import { Cards, Card } from 'fumadocs-ui/components/card';
+import { Steps } from 'fumadocs-ui/components/steps';
+import { Tabs, Tab } from 'fumadocs-ui/components/tabs';
+import { Accordion, Accordions } from 'fumadocs-ui/components/accordion';
 import { FileCode2, Palette, Component, Globe, Zap, Lock } from 'lucide-react';
 
 ## Who needs asset tokenization UI customization?
@@ -25,17 +29,17 @@ The modular open-source platform enables fast deployment of asset tokenization s
 ![Application Code](../../../img/application-kits/atk-ui-github.png)
 
 <Cards>
-  <Cards.Card
+  <Card
     icon={<FileCode2 />}
     title="Frontend Focus"
     description="This guide covers the Next.js DApp located in kit/dapp/"
   />
-  <Cards.Card
+  <Card
     icon={<Component />}
     title="Component Library"
     description="50+ pre-built React components for asset tokenization"
   />
-  <Cards.Card
+  <Card
     icon={<Globe />}
     title="REST APIs"
     description="Enterprise-grade APIs for seamless integration"
@@ -44,8 +48,8 @@ The modular open-source platform enables fast deployment of asset tokenization s
 
 ## API integration capabilities
 
-<Accordion>
-  <AccordionItem title="What APIs are available for frontend integration?">
+<Accordions>
+  <Accordion title="What APIs are available for frontend integration?">
     The ATK exposes **25+ REST endpoints** covering:
     - **Asset operations**: Mint, burn, transfer, freeze (avg. 200ms response)
     - **User management**: KYC verification, role assignment, permissions
@@ -54,26 +58,26 @@ The modular open-source platform enables fast deployment of asset tokenization s
     - **Compliance controls**: Whitelist management, transfer restrictions
 
     All endpoints use **OAuth 2.0** authentication with rotating API keys.
-  </AccordionItem>
+  </Accordion>
 
-  <AccordionItem title="How do I integrate with existing enterprise systems?">
+  <Accordion title="How do I integrate with existing enterprise systems?">
     Common integration patterns include:
     - **ERP systems** (SAP, Oracle): Asset metadata sync, automated reconciliation
     - **CRM platforms** (Salesforce, HubSpot): Investor onboarding, KYC workflows
     - **Banking systems**: Fiat on/off ramps, settlement instructions
     - **Reporting tools** (Tableau, PowerBI): Real-time analytics dashboards
 
     Use the `/api/swagger` endpoint to generate TypeScript clients automatically.
-  </AccordionItem>
+  </Accordion>
 
-  <AccordionItem title="What are typical API response times?">
+  <Accordion title="What are typical API response times?">
     Performance benchmarks from production deployments:
     - **Read operations**: 50-200ms (cached)
     - **Write operations**: 200-500ms (blockchain confirmation)
     - **Bulk operations**: 1-5 seconds (batch processing)
-    - **WebSocket events**: <100ms latency
-  </AccordionItem>
-</Accordion>
+    - **WebSocket events**: &lt;100ms latency
+  </Accordion>
+</Accordions>
 
 ## Project structure deep dive
 
@@ -132,27 +136,27 @@ The modular open-source platform enables fast deployment of asset tokenization s
 ## Technology stack specifications
 
 <Cards>
-  <Cards.Card
+  <Card
     title="Next.js 15.3"
     description="Server-side rendering, 40% faster builds, React Server Components"
   />
-  <Cards.Card
+  <Card
     title="Tailwind CSS 3.4"
     description="JIT compilation, 200+ utility classes, dark mode support"
   />
-  <Cards.Card
+  <Card
     title="TypeScript 5.0"
     description="100% type coverage, strict mode, advanced generics"
   />
-  <Cards.Card
+  <Card
     title="React 19"
     description="Concurrent features, automatic batching, Suspense boundaries"
   />
-  <Cards.Card
+  <Card
     title="Wagmi 2.0"
     description="Ethereum interactions, wallet management, contract hooks"
   />
-  <Cards.Card
+  <Card
     title="TanStack Query"
     description="Data fetching, caching, real-time synchronization"
   />
@@ -238,8 +242,8 @@ The modular open-source platform enables fast deployment of asset tokenization s
 
 ## Creating custom routes and views
 
-<Accordion>
-  <AccordionItem title="How do I add a new page for investor analytics?">
+<Accordions>
+  <Accordion title="How do I add a new page for investor analytics?">
     Create a new route using Next.js App Router:
 
     ```tsx
@@ -262,9 +266,9 @@ The modular open-source platform enables fast deployment of asset tokenization s
       description: 'Real-time portfolio analytics and performance metrics',
     };
     ```
-  </AccordionItem>
+  </Accordion>
 
-  <AccordionItem title="What are common custom views for tokenization platforms?">
+  <Accordion title="What are common custom views for tokenization platforms?">
     Based on 50+ deployments, these are the most requested custom views:
 
     | View Type | Purpose | Typical Users |
@@ -274,9 +278,9 @@ The modular open-source platform enables fast deployment of asset tokenization s
     | Compliance Center | KYC reviews, transaction monitoring | Compliance teams |
     | Secondary Market | P2P trading, order book | Active traders |
     | Yield Calculator | ROI projections, payment schedules | Prospective investors |
-  </AccordionItem>
+  </Accordion>
 
-  <AccordionItem title="How do I implement role-based routing?">
+  <Accordion title="How do I implement role-based routing?">
     Use middleware for access control:
 
     ```tsx
@@ -300,8 +304,8 @@ The modular open-source platform enables fast deployment of asset tokenization s
       matcher: ['/admin/:path*', '/issuer/:path*'],
     };
     ```
-  </AccordionItem>
-</Accordion>
+  </Accordion>
+</Accordions>
 
 ## Custom hooks for blockchain logic
 
@@ -513,8 +517,8 @@ The modular open-source platform enables fast deployment of asset tokenization s
 
 ## Internationalization and localization
 
-<Accordion>
-  <AccordionItem title="Which languages are supported out of the box?">
+<Accordions>
+  <Accordion title="Which languages are supported out of the box?">
     The ATK includes translations for 12 languages:
     - **English** (en) - Default
     - **Spanish** (es) - Latin America & Spain variants
@@ -528,9 +532,9 @@ The modular open-source platform enables fast deployment of asset tokenization s
     - **Chinese** (zh) - Simplified & Traditional
     - **Arabic** (ar) - RTL support
     - **Hindi** (hi)
-  </AccordionItem>
+  </Accordion>
 
-  <AccordionItem title="How do I add custom translations?">
+  <Accordion title="How do I add custom translations?">
     ```json
     // src/i18n/locales/en.json
     {
@@ -560,9 +564,9 @@ The modular open-source platform enables fast deployment of asset tokenization s
       }
     }
     ```
-  </AccordionItem>
+  </Accordion>
 
-  <AccordionItem title="How do I handle legal disclaimers by jurisdiction?">
+  <Accordion title="How do I handle legal disclaimers by jurisdiction?">
     Implement jurisdiction-aware content:
 
     ```tsx
@@ -588,8 +592,8 @@ The modular open-source platform enables fast deployment of asset tokenization s
       return disclaimers[country] || disclaimers.US;
     }
     ```
-  </AccordionItem>
-</Accordion>
+  </Accordion>
+</Accordions>
 
 ## Utility functions and type safety
 
@@ -803,19 +807,19 @@ The modular open-source platform enables fast deployment of asset tokenization s
 ## Real-world customization examples
 
 <Cards>
-  <Cards.Card
+  <Card
     title="DBS Bank - Project Orchid"
     description="Customized for government bond tokenization with SGD stablecoin integration"
   />
-  <Cards.Card
+  <Card
     title="Santander - Digital Assets Platform"
     description="Adapted for corporate bond issuance with multi-currency support"
   />
-  <Cards.Card
+  <Card
     title="BlackRock - Private Markets"
     description="Modified for alternative investment funds with sophisticated compliance rules"
   />
-  <Cards.Card
+  <Card
     title="Société Générale - FORGE"
     description="Enhanced for security token offerings with regulatory reporting"
   />

content/docs/application-kits/introduction.mdx

@@ -128,7 +128,7 @@ import { Accordion, Accordions } from 'fumadocs-ui/components/accordion';
 
 ### Performance Benchmarks
 - **Transaction Throughput:** Up to 10,000 TPS (Layer 2)
-- **API Response Time:** <100ms average
+- **API Response Time:** &lt;100ms average
 - **Uptime SLA:** 99.9% availability
 
 ## Getting started with Application Kits
@@ -153,7 +153,7 @@ import { Accordion, Accordions } from 'fumadocs-ui/components/accordion';
 <GithubInfo
   owner="settlemint"
   repo="asset-tokenization-kit"
-/>;
+/>
 
 
 ## Frequently asked questions

content/docs/index.mdx

@@ -4,7 +4,10 @@ icon: house
 ---
 
 import Link from "next/link";
-import { Callout, Tabs, Tab, Steps, Step, Accordion, AccordionItem } from 'fumadocs-ui/components';
+import { Callout } from 'fumadocs-ui/components/callout';
+import { Tabs, Tab } from 'fumadocs-ui/components/tabs';
+import { Steps } from 'fumadocs-ui/components/steps';
+import { Accordion, Accordions } from 'fumadocs-ui/components/accordion';
 
 ## What is SettleMint? Your complete platform for enterprise blockchain development
 
@@ -772,43 +775,43 @@ SettleMint Application Kits provide complete, full-stack blockchain solutions fo
 
 ## Frequently asked questions
 
-<Accordion type="single" collapsible>
-  <AccordionItem value="blockchain-choice" title="Which blockchain should I use for my project?">
+<Accordions>
+  <Accordion title="Which blockchain should I use for my project?">
     **For public transparency:** Ethereum (most secure), Polygon (fast & cheap), Arbitrum/Optimism (Ethereum L2s)
 
     **For private data:** Hyperledger Besu (Ethereum-compatible), Hyperledger Fabric (modular), Quorum (JPMorgan)
 
     **For specific needs:** Hedera (high-speed), Avalanche (subnets), Soneium (gaming)
-  </AccordionItem>
+  </Accordion>
 
-  <AccordionItem value="build-time" title="How long does it take to build a blockchain app?">
+  <Accordion title="How long does it take to build a blockchain app?">
     With SettleMint: **2-6 weeks** for a production-ready application
 
     Without SettleMint: **3-6 months** typically
-  </AccordionItem>
+  </Accordion>
 
-  <AccordionItem value="expertise" title="Do I need blockchain expertise to use SettleMint?">
+  <Accordion title="Do I need blockchain expertise to use SettleMint?">
     Basic programming knowledge is enough. SettleMint handles the complex blockchain infrastructure, letting you focus on your application logic.
-  </AccordionItem>
+  </Accordion>
 
-  <AccordionItem value="platform-contents" title="What's included in the platform?">
+  <Accordion title="What's included in the platform?">
     Everything needed for blockchain development: infrastructure, development tools, APIs, databases, storage, security, monitoring, and deployment tools.
-  </AccordionItem>
+  </Accordion>
 
-  <AccordionItem value="getting-started" title="How do I get started?">
+  <Accordion title="How do I get started?">
     <Steps>
-      <Step>
+      <Steps.Step>
         [Sign up for a free trial](https://console.settlemint.com)
-      </Step>
-      <Step>
+      </Steps.Step>
+      <Steps.Step>
         Follow the [Getting Started guide](/building-with-settlemint/getting-started)
-      </Step>
-      <Step>
+      </Steps.Step>
+      <Steps.Step>
         Deploy your first smart contract in under 30 minutes
-      </Step>
+      </Steps.Step>
     </Steps>
-  </AccordionItem>
-</Accordion>
+  </Accordion>
+</Accordions>
 
 ## Need help?
 

content/docs/knowledge-bank/blockchain-app-design.mdx

@@ -5,9 +5,9 @@ description: "Master blockchain application architecture with comprehensive desi
 
 import { Callout } from "fumadocs-ui/components/callout";
 import { Card } from "fumadocs-ui/components/card";
-import { Tabs, Tab } from "fumadocs-ui/components/ui/tabs";
-import { Steps, Step } from "fumadocs-ui/components/ui/steps";
-import { Accordion, Accordions } from "fumadocs-ui/components/ui/accordion";
+import { Tabs, Tab } from "fumadocs-ui/components/tabs";
+import { Steps } from "fumadocs-ui/components/steps";
+import { Accordion, Accordions } from "fumadocs-ui/components/accordion";
 
 # Enterprise Blockchain Application Design: Architecture Patterns & Best Practices
 

content/docs/knowledge-bank/chaincode.mdx

@@ -5,9 +5,9 @@ description: "Master Hyperledger Fabric chaincode development with enterprise-gr
 
 import { Callout } from "fumadocs-ui/components/callout";
 import { Card } from "fumadocs-ui/components/card";
-import { Tabs, Tab } from "fumadocs-ui/components/ui/tabs";
-import { Steps, Step } from "fumadocs-ui/components/ui/steps";
-import { Accordion, Accordions } from "fumadocs-ui/components/ui/accordion";
+import { Tabs, Tab } from "fumadocs-ui/components/tabs";
+import { Steps } from "fumadocs-ui/components/steps";
+import { Accordion, Accordions } from "fumadocs-ui/components/accordion";
 
 # Enterprise Hyperledger Fabric Chaincode Development
 

content/docs/knowledge-bank/industrial-usecases.mdx

@@ -5,9 +5,9 @@ description: "Comprehensive guide to implementing blockchain solutions across ma
 
 import { Callout } from "fumadocs-ui/components/callout";
 import { Card } from "fumadocs-ui/components/card";
-import { Tabs, Tab } from "fumadocs-ui/components/ui/tabs";
-import { Steps, Step } from "fumadocs-ui/components/ui/steps";
-import { Accordion, Accordions } from "fumadocs-ui/components/ui/accordion";
+import { Tabs, Tab } from "fumadocs-ui/components/tabs";
+import { Steps } from "fumadocs-ui/components/steps";
+import { Accordion, Accordions } from "fumadocs-ui/components/accordion";
 
 # Industrial Blockchain Applications: Manufacturing, Supply Chain & Enterprise Solutions