review fixes and refactoring

shaloo · shaloo · commit 63de8d061924 · 2025-07-29T18:18:52.000+05:30
diff --git a/docs/auth/auth-usage-guide.md b/docs/auth/auth-usage-guide.md
@@ -15,7 +15,7 @@ of the file in the `auth` repo: https://github.com/arcana-network/auth/blob/main
 
 Use the {{config.extra.arcana.sdk_name}} to onboard users via social login, allow users to access the in-app {{config.extra.arcana.wallet_name}} and sign blockchain transactions.
 
-[:octicons-cross-reference-16:{ .icon-color } {% include "./text-snippets/authsdkref_url.md" %}](https://authsdk-ref-guide.netlify.app/){ .md-button }
+[:octicons-cross-reference-16:{ .icon-color } SDK Reference]({{config.extra.arcana.auth_sdk_ref_url}}){ .md-button }
 
 ## Installation
 
diff --git a/docs/auth/auth-wagmi-usage-guide.md b/docs/auth/auth-wagmi-usage-guide.md
@@ -6,20 +6,11 @@ arcana:
   root_rel_path: ..
 ---
 
-<!--
-Note, this is a pure markdown file with no mkdocs related tags or keywords. It is a copy 
-of the file in the `auth` repo: https://github.com/arcana-network/auth/blob/main/usage.md
--->
-
 # {{config.extra.arcana.wagmi_sdk_name}} Usage
 
 Use the {{config.extra.arcana.wagmi_sdk_name}} to onboard users in a Wagmi app via social login. Let users instantly access the in-app {{config.extra.arcana.wallet_name}} and sign blockchain transactions.
 
-<!--
-Latest auth-wagmi readme update PR not merged hence commenting https://wagmi-authsdk-ref-guide.netlify.app/ for now
--->
-
-[:octicons-cross-reference-16:{ .icon-color } {% include "./text-snippets/wagmi_authsdkref_url.md" %}](https://deploy-preview-28--wagmi-authsdk-ref-guide.netlify.app/){ .md-button }
+[:octicons-cross-reference-16:{ .icon-color } SDK Reference]({{config.extra.arcana.wagmi_sdk_ref_url}}){ .md-button }
 
 ## Install
 
diff --git a/docs/auth/introduction/why-auth-sdk.md b/docs/auth/introduction/why-auth-sdk.md
@@ -48,6 +48,6 @@ Tailor the user experience for your Web3 applications as per your use case and t
 
 * [Social Login Demo App]({{config.extra.arcana.auth_sdk_demo_url}})
 * [[web-auth-usage-guide|{{config.extra.arcana.sdk_name}} Usage Guide]]
-* {% include "./text-snippets/authsdkref_url.md" %}
+* [Auth SDK Reference]({{config.extra.arcana.auth_sdk_ref_url}})
 
 {% include "./text-snippets/auth_sdk_quicklinks.md" %}
diff --git a/docs/auth/onboard/rainbow/rainbow-custom-ui.md b/docs/auth/onboard/rainbow/rainbow-custom-ui.md
@@ -64,5 +64,5 @@ Use the `ArcanaConnector` and set up [Wagmi config](https://wagmi.sh/react/getti
 
 * [[web-auth-error-msg|{{config.extra.arcana.sdk_name}} Errors]]
 * [[web-auth-usage-guide|{{config.extra.arcana.sdk_name}} Usage Guide]]
-* {% include "./text-snippets/authsdkref_url.md" %}
-* {% include "./text-snippets/wagmi_authsdkref_url.md" %}
+* [Auth SDK Reference]({{config.extra.arcana.auth_sdk_ref_url}})
+* [Auth Wagmi SDK Reference]({{config.extra.arcana.wagmi_sdk_ref_url}})
diff --git a/docs/concepts/custom-login-ui.md b/docs/concepts/custom-login-ui.md
@@ -18,4 +18,4 @@ This decision is made at the time of SDK integration. This choice is not governe
 
 After installing and integrating with the {{config.extra.arcana.sdk_name}}, create the `AuthProvider`, use `init` function to initialize the provider, create the necessary user interface hooks and call the `loginWithSocial` function with the desired social login provider to onboard users. For email-based onboarding, utilize the `loginWithOTP`(deprecated), `loginWithOTPStart` and `loginWithOTPComplete` functions, which sends users a verification link on the specified user email.
 
-Here is an example of [[google-social-auth|how to onboard users via 'Google' as the social login provider and a custom login UI]]. See {% include "./text-snippets/authsdkref_url.md" %} for more details.
+Here is an example of [[google-social-auth|how to onboard users via 'Google' as the social login provider and a custom login UI]]. See [Auth SDK Reference]({{config.extra.arcana.auth_sdk_ref_url}}) for more details.
diff --git a/docs/faq/faq-auth.md b/docs/faq/faq-auth.md
@@ -87,7 +87,7 @@ toc_depth: 2
 
 ??? an-faq "How does the app access an authenticated user's information such as name, email, login token, the wallet address?"
 
-      Apps can use the [`getUser()`](https://authsdk-ref-guide.netlify.app/classes/authprovider#getUser) method to obtain the user's name, email, login token ([[concept-arcana-jwt-token|{{config.extra.arcana.company_name}} JWT Token]], [[concept-did-token|DID Token]]), wallet address, etc. See {% include "./text-snippets/authsdkref_url.md" %} for details.
+      Apps can use the [`getUser()`](https://authsdk-ref-guide.netlify.app/classes/authprovider#getUser) method to obtain the user's name, email, login token ([[concept-arcana-jwt-token|{{config.extra.arcana.company_name}} JWT Token]], [[concept-did-token|DID Token]]), wallet address, etc. See [Auth SDK Reference]({{config.extra.arcana.auth_sdk_ref_url}}) for details.
 
 ??? an-faq "For Twitter, the `getUser()` function of the `AuthProvider` does not always return the user's email?"
 
diff --git a/docs/img/arcana-logo-bw.png b/docs/img/arcana-logo-bw.png
diff --git a/docs/img/favicon-bw.webp b/docs/img/favicon-bw.webp
diff --git a/docs/quick-start/auth-ca-wagmi-quick-start.md b/docs/quick-start/auth-ca-wagmi-quick-start.md
@@ -66,7 +66,7 @@ To enable social login, you need to integrate with the {{config.extra.arcana.sdk
 
 {% include "./text-snippets/quick-start-deploy.md" %}
 
-For details, see {% include "./text-snippets/wagmi_authsdkref_url.md" %}.
+For details, see [Auth Wagmi SDK Reference]({{config.extra.arcana.wagmi_sdk_ref_url}}).
 
 Next, you need to integrate the Web3 app with the {{config.extra.arcana.ca_wagmi_sdk_name}} to enable chain abstracted transactions via unified balance.
 
diff --git a/docs/setup/config-wallet-chains.md b/docs/setup/config-wallet-chains.md
@@ -171,4 +171,4 @@ For details refer to the [[web-auth-usage-guide#wallet_addethereumchain|{{config
 * [[solana-dashboard-user-guide| Configure Solana Chains]]
 * [[mvx-dashboard-user-guide| Configure MultiversX Chains]]
 * [[near-dashboard-user-guide| Configure Near Chains]]
-* {% include "./text-snippets/authsdkref_url.md" %}
+* [Auth SDK Reference]({{config.extra.arcana.auth_sdk_ref_url}})
diff --git a/docs/stylesheets/custom.css b/docs/stylesheets/custom.css
@@ -3,13 +3,13 @@
 :root > * {
   --md-nav-padding: 0.05rem;
   --md-an-pink-color: #FF4E9F;
-  --md-an-pink-color-light: #FF4E9F;
-  --md-an-highlight-color: var(--md-an-blue-color);
-  --md-an-highlight-color-light: var(--md-an-blue-color-light);
+  --md-an-pink-color-light: #f8eaf0;
+  --md-an-highlight-color: var(--md-an-pink-color);
+  --md-an-highlight-color-light: var(--md-an-pink-color-light);
   --md-an-blue-color: #3169b3;
   --md-an-blue-color-light: rgba(49, 105, 179, 0.25);
   --md-an-green-color: #0f8584;
-  --md-an-green-color-light: #D1EEEC;
+  --md-an-green-color-light: #d1eeec70;
   --md-an-black-color: #19191D;
   --md-an-gray-light-color: #DBDFE7;
   --md-an-gray-dark-color: #5F6776;
@@ -22,15 +22,17 @@
   --md_an_yellow-color-light: #FFF9DE;
   --md-an-purple-color: #5A2ABD;
   --md-an-cyan-color: #25BAEF;
+  --md-an-cyan-color-light: #bfe4f4bf;
+  --md-an-admonition-blue-color: #406edad0;
+  --md-an-admonition-blue-color-light: #406eda26;
   --md-an-gray-color-lighter: #ece6e81c;
   --md-an-img-bg: var(--md-an-gray-color-lighter);
   --md-default-bg-color--light: #aaaaaa;
   --md-default-bg-color--lighter: #e7f6ff;
   --md-typeset-a-color: var(--md-an-highlight-color);
   --md-accent-fg-color: rgb(132, 144, 149);
   --md-accent-fg-color--transparent: hsla(190, 5%, 49%, 0.1);
-  --md-accent-bg-color: hsla(0, 0%, 100%, 1);
-  --md-accent-bg-color--light: hsla(0, 0%, 100%, 0.7);
+  --md-accent-bg-color: hsl(56, 84%, 93%);
   --md-text-font: "Inter";
   --md-admonition-icon-an-faq: url('/img/icons/icons8-question-mark-48.webp');
   --md-admonition-icon-an-trbs: url('/img/icons/exclamation.webp');
@@ -46,10 +48,9 @@
   --md-an-banner-bg: var(--md-an-highlight-color);
   --md-text-font-family: "Inter";
   --md-mermaid-node-bg-color: var(--md-default-bg-color);
-  --md-nav-bg-active-color: var(--md-an-highlight-color-light);
   --md-nav-bg-hover-color: #eaeaea;
-  --md-an-admonition-note: var(--md-an-blue-color-light);
-  --md-admonition-icon-an-note-color: var(--md-an-blue-color);
+  --md-an-admonition-note: var(--md-an-admonition-blue-color-light);
+  --md-admonition-icon-an-note-color: var(--md-an-admonition-blue-color);
   --md-an-admonition-info: var(--md-an-gray-light-color);
   --md-admonition-icon-an-info-color: var(--md-an-gray-dark-color);
   --md-an-admonition-tip: var(--md-an-green-color-light);
@@ -60,9 +61,10 @@
   --md-admonition-icon-an-danger-color: var(--md-an-red-color);
   --md-an-admonition-example: #f6e3f865;
   --md-admonition-icon-an-example-color: var(--md-an-purple-color);
-  --md-an-admonition-abstract: #e9f2f663;
+  --md-an-admonition-abstract: var(--md-an-cyan-color-light);
   --md-admonition-icon-an-abstract-color: var(--md-an-cyan-color);
   --md-an-header-shadow-color: #eaeaea;
+  --md-an-img-bg: var(--md-an-gray-color-lighter);
   --md-primary-fg-color: #101010;
   --md-primary-fg-color--lighter: #929292;
   --md-primary-fg-color--light: #c2c2c2;
@@ -93,7 +95,6 @@
   --md-an-color-light-purple: rgb(26, 24, 38);
   --md-accent-bg-color: var(--md-default-bg-color);
   --md-an-img-bg: rgba(36, 37, 46, 0.85);
-  --md-nav-bg-active-color: rgba(49, 105, 179, 0.75);
   --md-nav-bg-hover-color: rgb(#321724);
   --md-an-admonition-note: #202331;
   --md-admonition-icon-an-note-color: var(--md-an-blue-color);
@@ -215,7 +216,7 @@
   /*padding-top: 0.25rem;
   padding-bottom: 0.25rem;*/
   border-radius: 5px;
-  background-color: var(--md-nav-bg-active-color);  /*background-color: #f4c3d9e6;*/
+  background-color: var(--md-an-highlight-color-light);  /*background-color: #f4c3d9e6;*/
   color: var(--md-an-highlight-color);
 }
 
@@ -271,14 +272,14 @@ li.md-nav__item, a.md-nav__link, .md-nav__link {
 }*/
 
 .md-typeset .tabbed-set {
-  border: 0.0125rem solid var(--md-an-highlight-color);
+  border: 0.0125rem solid var(--md-an-highlight-color-light);
   border-radius: 9px;
   margin-top: 1.5rem;
   margin-bottom: 1.5rem;
 }
 
 .md-typeset .tabbed-labels>label>[href]:first-child {
-  background-color: var(--md-an-highlight-color-light);
+  /*background-color: var(--md-an-highlight-color-light);*/
 }
 
 .md-typeset h3 {
@@ -317,7 +318,7 @@ li.md-nav__item, a.md-nav__link, .md-nav__link {
 }
 
 .md-typeset .tabbed-labels {
-  background-color: var(--md-nav-bg-active-color);
+  /*background-color: var(--md-an-highlight-color-light);*/
   border-top-right-radius: inherit;
   border-top-left-radius: inherit;
 }
@@ -722,6 +723,7 @@ details.an-abstract {
 
 .md-typeset .critic.block {
   border-radius: 9px;
+  background-color: var(--md-accent-bg-color);
 }
 
 /* Text Marker Highlight: Arcana Styling */
diff --git a/includes/text-snippets/auth_react_sdk_quicklinks.md b/includes/text-snippets/auth_react_sdk_quicklinks.md
@@ -1,7 +1,7 @@
 !!! an-info "{{config.extra.arcana.react_sdk_name}} Quick Links"
 
     * {% include "./text-snippets/react_authsdkref_url.md" %}
-    * {% include "./text-snippets/authsdkref_url.md" %}
+    * [Auth SDK Reference]({{config.extra.arcana.auth_sdk_ref_url}})
     * [[rn-latest-auth|{{config.extra.arcana.sdk_name}} Release notes]]
     * [Changelog](https://github.com/arcana-network/auth-react/releases)
     * [Download SDK](https://www.npmjs.com/package/@arcana/auth-react)
diff --git a/includes/text-snippets/auth_sdk_quicklinks.md b/includes/text-snippets/auth_sdk_quicklinks.md
@@ -1,6 +1,6 @@
 !!! an-info "{{config.extra.arcana.sdk_name}} Quick Links"
 
-    * {% include "./text-snippets/authsdkref_url.md" %}
+    * [Auth SDK Reference]({{config.extra.arcana.auth_sdk_ref_url}})
     * [[rn-latest-auth|Release notes]]
     * [Changelog](https://github.com/arcana-network/auth/releases)
     * [Download SDK](https://www.npmjs.com/package/@arcana/auth)
diff --git a/includes/text-snippets/auth_wagmi_sdk_quicklinks.md b/includes/text-snippets/auth_wagmi_sdk_quicklinks.md
@@ -1,6 +1,6 @@
 !!! an-info "{{config.extra.arcana.wagmi_sdk_name}} Quick Links"
 
-    * {% include "./text-snippets/wagmi_authsdkref_url.md" %}
+    * [Auth Wagmi SDK Reference]({{config.extra.arcana.wagmi_sdk_ref_url}})
     * [[rn-latest-auth|Release notes]]
     * [Changelog](https://github.com/arcana-network/auth-wagmi/releases)
     * [Download SDK](https://www.npmjs.com/package/@arcana/auth-wagmi)
diff --git a/includes/text-snippets/authsdkref_url.md b/includes/text-snippets/authsdkref_url.md
diff --git a/includes/text-snippets/build-passkey-login.md b/includes/text-snippets/build-passkey-login.md
@@ -53,4 +53,4 @@ Authenticated users can instantly access the in-app {{config.extra.arcana.wallet
 * [[index-config-social-providers|Configure Social Providers]]
 * [[web-auth-error-msg|{{config.extra.arcana.sdk_name}} Errors]]
 * [[web-auth-usage-guide|{{config.extra.arcana.sdk_name}} Usage Guide]]
-* {% include "./text-snippets/authsdkref_url.md" %}
+* [Auth SDK Reference]({{config.extra.arcana.auth_sdk_ref_url}})
diff --git a/includes/text-snippets/build-passkey-signup.md b/includes/text-snippets/build-passkey-signup.md
@@ -40,4 +40,4 @@ Authenticated users can instantly access the in-app {{config.extra.arcana.wallet
 * [[index-config-social-providers|Configure Social Providers]]
 * [[web-auth-error-msg|{{config.extra.arcana.sdk_name}} Errors]]
 * [[web-auth-usage-guide|{{config.extra.arcana.sdk_name}} Usage Guide]]
-* {% include "./text-snippets/authsdkref_url.md" %}
+* [Auth SDK Reference]({{config.extra.arcana.auth_sdk_ref_url}})
diff --git a/includes/text-snippets/build-pwdless-auth.md b/includes/text-snippets/build-pwdless-auth.md
@@ -56,4 +56,4 @@ Authenticated users can instantly access the in-app {{config.extra.arcana.wallet
 * [[index-config-social-providers|Configure Social Providers]]
 * [[web-auth-error-msg|{{config.extra.arcana.sdk_name}} Errors]]
 * [[web-auth-usage-guide|{{config.extra.arcana.sdk_name}} Usage Guide]]
-* {% include "./text-snippets/authsdkref_url.md" %}
+* [Auth SDK Reference]({{config.extra.arcana.auth_sdk_ref_url}})
diff --git a/includes/text-snippets/quick-start-int-auth-evm.md b/includes/text-snippets/quick-start-int-auth-evm.md
@@ -6,4 +6,4 @@
 
 !!! an-warning "Initialize First!"
 
-    The app must use `await` until the `init()` call is complete, before invoking any of the other {{config.extra.arcana.sdk_name}} functions listed in {% include "./text-snippets/authsdkref_url.md" %}.
+    The app must use `await` until the `init()` call is complete, before invoking any of the other {{config.extra.arcana.sdk_name}} functions listed in the [Auth SDK Reference]({{config.extra.arcana.auth_sdk_ref_url}}).
diff --git a/includes/text-snippets/quick-start-int-auth.md b/includes/text-snippets/quick-start-int-auth.md
@@ -6,4 +6,4 @@
 
 !!! an-warning "Initialize First!"
 
-    The app must use `await` until the `init()` call is complete, before invoking any of the other {{config.extra.arcana.sdk_name}} functions listed in {% include "./text-snippets/authsdkref_url.md" %}.
+    The app must use `await` until the `init()` call is complete, before invoking any of the other {{config.extra.arcana.sdk_name}} functions listed in [Auth SDK Reference]({{config.extra.arcana.auth_sdk_ref_url}}).
diff --git a/includes/text-snippets/wagmi_authsdkref_url.md b/includes/text-snippets/wagmi_authsdkref_url.md
diff --git a/mkdocs.yml b/mkdocs.yml
@@ -20,14 +20,16 @@ copyright: Copyright &copy; 2025 Arcana Network
 theme:
   name: material
   language: en
-  logo: img/arcana-logo-light.png
+  #logo: img/arcana-logo-bw.png
+  logo: img/arcana-logo-pink.png
   icon:
     repo: fontawesome/brands/git-alt
     edit: material/pencil
     view: material/eye
     admonition:
       note: fontawesome/solid/note-sticky
-  favicon: /img/favicon-light.webp
+  #favicon: /img/favicon-bw.webp
+  favicon: /img/favicon-pink.webp
   custom_dir: docs/overrides
   features:
     #- announce.dismiss
@@ -102,12 +104,15 @@ extra:
     ca_wagmi_sdk_codesandbox_url: https://codesandbox.io/p/github/arcana-network/ca-wagmi-example/main
     auth_ca_wagmi_sdk_codesandbox_url: https://codesandbox.io/p/github/shaloo/sample-arcana-auth-ca-wagmi-sdks/sample-auth-ca-wagmi-integration    
     auth_sdk_download_url: https://www.npmjs.com/package/@arcana/auth
+    auth_sdk_ref_url: https://authsdk-ref-guide.netlify.app/
     auth_sdk_demo_url: https://demo.arcana.network
     sdk_name: Arcana Auth SDK
     react_sdk_name: Arcana Auth React SDK
     react_sdk_download_url: https://www.npmjs.com/package/@arcana/auth-react
     wagmi_sdk_name: Arcana Auth Wagmi SDK
     wagmi_sdk_download_url: https://www.npmjs.com/package/@arcana/auth-wagmi
+    #wagmi_sdk_ref_url: https://wagmi-authsdk-ref-guide.netlify.app/ 
+    wagmi_sdk_ref_url: https://deploy-preview-28--wagmi-authsdk-ref-guide.netlify.app/
     web3_react_sdk_name: Arcana Auth Web3 React SDK
     web3_react_sdk_download_url: https://www.npmjs.com/package/@arcana/auth-web3-react
     auth_core_sdk_name: Arcana Auth-Core SDK

Original file line number	Diff line number	Diff line change
`@@ -18,4 +18,4 @@ This decision is made at the time of SDK integration. This choice is not governe`
`18`	`18`
`19`	`19`	After installing and integrating with the {{config.extra.arcana.sdk_name}}, create the `AuthProvider`, use `init` function to initialize the provider, create the necessary user interface hooks and call the `loginWithSocial` function with the desired social login provider to onboard users. For email-based onboarding, utilize the `loginWithOTP`(deprecated), `loginWithOTPStart` and `loginWithOTPComplete` functions, which sends users a verification link on the specified user email.
`20`	`20`
`21`		`-Here is an example of [[google-social-auth\|how to onboard users via 'Google' as the social login provider and a custom login UI]]. See {% include "./text-snippets/authsdkref_url.md" %} for more details.`
	`21`	`+Here is an example of [[google-social-auth\|how to onboard users via 'Google' as the social login provider and a custom login UI]]. See [Auth SDK Reference]({{config.extra.arcana.auth_sdk_ref_url}}) for more details.`