added connecting identity to desktop page + minor fixes in other pages

Author: Pnlpz

advanced/connect-identity.mdx

@@ -0,0 +1,59 @@
+---
+title: 'Connect Your Identity to Shinkai Desktop'
+description: 'Connect your identity so you can take part in the Shinkai Network and use p2p capabilities'
+icon: 'plug'
+---
+
+After following [the previous documentation on registering your identity on-chain](/advanced/shinkai-identity), you should have your identity keys downloaded on your machine. 
+
+Now we will move forward with connecting this identity, using the keys, to your Shinkai node (Shinkai Desktop).
+
+<Note>
+### Requirements
+
+Before moving forward make sure you have Shinkai Desktop installed. If you don't, please reference the [Installation and Setup Guide](/quickstart) page for instructions.
+
+Also, make sure you've registered an identity on-chain following the [Registering Your Shinkai Identity](/advanced/shinkai-identity) documentation. 
+
+> You must follow the instructions and register an identity by clicking the link in Shinkai Desktop, not by registering an identity through the dApp directly (otherwise the correct keys from Shinkai Desktop will not be used when registering your identity).
+
+</Note>
+
+## How to Connect Your Identity to Shinkai Desktop
+
+<Steps titleSize="h3">
+  <Step title="Copy the Keys in your Desktop App">
+    Open your Shinkai Desktop App > Go to `Settings` > `Public Keys`.
+    ![Public Keys](/images/public-keys.jpg)
+    <Icon icon="copy" iconType="duotone" /> Copy your `Node Public Keys`.
+  </Step>
+
+  <Step title="Paste the Keys in Your Shinkai Profile">
+    Go to [your profile](https://shinkai-contracts.pages.dev/profile) > Click your `identity` button. 
+    ![Your profile](/images/profile.jpg)
+    
+    Click the `edit` button > <Icon icon="paste" iconType="duotone" /> Paste your `Node Public Keys` as follows:
+    - Node Encryption Key > Encryption Public Key
+    - Node Signature > Signature Public Key
+    - Node address: http://127.0.0.1:9550
+
+    ![Adding Public Keys to Shinkai Identity](/images/keys-pasted.jpg)
+
+    <Icon icon="floppy-disk" iconType="duotone" /> `Save` the changes. 
+
+  </Step>
+
+  <Step title="Restart your Shinkai Desktop App">
+    Restart Shinkai desktop so your identity is refreshed. 
+  </Step>
+
+  <Step title="Copy the name of your registered Shinkai Identity">
+    - Open Shinkai Desktop and click on the Settings tab at the bottom left corner of the application.
+    - Click on the Shinkai Identity input box, input your identity name, and click save. Make sure to include the `@@` prefix so your identity looks like `@@myidentity.arb-sep-shinkai`.
+    - Once you click `save`, you will have your identity connected to Shinkai Desktop!
+    ![Shinkai Identity connected](/images/connected-identity.jpg)
+  </Step>
+
+</Steps>
+
+<Icon icon="hands-clapping" iconType="duotone" /> Congratulations, **you have your identity connected to Shinkai Desktop**! Now you can take part in the Shinkai Network and use p2p capabilities.

advanced/model-install.mdx

@@ -1,7 +1,7 @@
 ---
 title: 'Overview'
 description: 
-icon:
+icon: 'magnifying-glass'
 ---
 
 ## Installing Local AIs Manually

advanced/models/gemini.mdx

@@ -10,15 +10,16 @@ description: 'A step-by-step guide to help you install Gemini models'
       Go to your [Google AI Studio dashboard](https://aistudio.google.com/app/apikey) > Click the `Get API Key` button > Select a project (Gemini API) > Create Key.
 
       ![Generate API Key](/images/gemini-api.jpg)
-      Copy the key > Go to your Shinkai Desktop App
+      <Icon icon="copy" iconType="duotone" />  Copy the key > Go to your Shinkai Desktop App
     </Step>
     <Step title="Install the model in Shinkai">
         Open Shinkai > Go to `AIs` > `+ Add AI` > `+ Manually Add AI`
-      - 1. Select **Gemini** in Model Provider.
-      - 2. Select the **Model Type** you'd like to install (i.e., `Gemini 1.5 Flash, Gemini 1.5 Pro, or Custom` for other models)
-      - (Optional) You can edit the **AI Name** --> This is how it will be displayed in your Chats view. 
+      1. Select **Gemini** in Model Provider.
+      2. Select the **Model Type** you'd like to install (i.e., `Gemini 1.5 Flash, Gemini 1.5 Pro, or Custom` for other models)
+      
+      (Optional) You can edit the **AI Name** --> This is how it will be displayed in your Chats view. 
       <Note>This field only accepts alphanumeric characters and underscores. </Note>
-      - 3. Paste the API key you created in step 1 > `Add AI`
+      3. <Icon icon="paste" iconType="duotone" /> Paste the API key you created in step 1 > `Add AI`
 
       ![Paste API key in Shinkai](/images/gemini-install.jpg)
     </Step>

advanced/models/gpt.mdx

@@ -13,7 +13,7 @@ icon:
       Go to your [OpenAI dashboard](https://platform.openai.com/api-keys) > Select `API keys` from the side menu > Click the `+ Create new secret key` button.
 
       ![Generate API Key](/images/openai-api-key.jpg)
-      Copy the key > Go to Shinkai
+      <Icon icon="copy" iconType="duotone" /> Copy the key > Go to Shinkai Desktop
     </Step>
     <Step title="Paste your API key in Shinkai">
       - Select the **Model Type** you'd like to install (i.e., `GPT 4o, GPT 4o Mini, or Custom` for other models)

advanced/models/groq.mdx

@@ -14,15 +14,16 @@ Integrating Groq AI models in shinkai can enable accelerated processing of AI ta
         Go to your [Groq's Console](hhttps://console.groq.com/keys) > Click the `Create API Key` button >  Name your Key (*e.g., Shinkai*).
 
         ![Generate API Key](/images/groq-key.jpg)
-        Copy the key > Go to your Shinkai Desktop App
+        <Icon icon="copy" iconType="duotone" /> Copy the key > Go to your Shinkai Desktop App
     </Step>
     <Step title="Install the model in Shinkai">
-        Open Shinkai > Go to `AIs` > `+ Add AI` > `+ Manually Add AI`
-      - 1. Select **Groq** in Model Provider.
-      - 2. Select the **Model Type** you'd like to install (i.e., Llama3 Groq 70b, or Custom` for other models)
-      - (Optional) You can edit the **AI Name** --> This is how it will be displayed in your Chats view. 
+      Open Shinkai > Go to `AIs` > `+ Add AI` > `+ Manually Add AI`
+      1. Select **Groq** in Model Provider.
+      2. Select the **Model Type** you'd like to install (i.e., Llama3 Groq 70b, or Custom` for other models)
+      
+      (Optional) You can edit the **AI Name** --> This is how it will be displayed in your Chats view. 
       <Note>This field only accepts alphanumeric characters and underscores. </Note>
-      - 3. Paste the API key you created in step 1 > `Add AI`
+      3. <Icon icon="paste" iconType="duotone" /> Paste the API key you created in step 1 > `Add AI`
 
       ![Paste API key in Shinkai](/images/groq-ai.jpg)
     </Step>

advanced/models/openrouter.mdx

@@ -17,20 +17,22 @@ icon:
 
       ![Generate key OpenRouter](/images/openrouter-key.jpg)
 
-      Copy the key and go to your Shinkai app > Paste the key.
+      <Icon icon="copy" iconType="duotone" /> Copy the key and go to your Shinkai app > Paste the key.
     </Step>
     <Step title="Select the model to install">
       OpenRouter offers over 200 AI models to choose from. We are going to choose the **free** model: `Meta: Llama 3.2 11B`.
-      - Copy the model id (see image)
+      
+      <Icon icon="copy" iconType="duotone" /> Copy the model id (see image)
 
       ![model id](/images/model-id.jpg)
 
     </Step>
     <Step title="Complete the manual installation in your Shinkai app">
-      - Paste the `model id` in the `Custom Model Type` field.
-      - In `AI Name` field you can customize how you want to see this AI displayed in your Chats. 
+      <Icon icon="paste" iconType="duotone" /> Paste the `model id` in the `Custom Model Type` field.
+      
+      In `AI Name` field you can customize how you want to see this AI displayed in your Chats. 
       <Note> This field only accepts alphanumeric characters and underscores. </Note>
-      - Click `Add AI`. You are all set! 
+      Click `Add AI`. You are all set! 
 
       ![Openrouter New AI](/images/openrouter-new-ai.jpg)
 

advanced/shinkai-identity.mdx

@@ -16,23 +16,23 @@ Registering **a Shinkai identity on-chain enables you to connect Shinkai Desktop
 
 ## Step-by-Step Registration Process
 
-<Steps>
-  <Step titleSize="h3" title="Acquire Arbitrum Sepolia (free)">
+<Steps titleSize="h3" >
+  <Step title="Acquire Arbitrum Sepolia (free)">
     Use the following faucet link to acquire Arbitrum Sepolia `Eth` (for gas fees), and Shinkai `KAI` tokens (for registering your identity) at no charge: https://sepolia-faucet.shinkai.com/.
 
     ![Export Connection](/images/sepolia.jpg)
   </Step>
 
-  <Step titleSize="h3" title="Open Shinkai Desktop">
+  <Step title="Open Shinkai Desktop">
     Open Shinkai Desktop and click on the `Settings` tab at the bottom left corner of the application.
   </Step>
 
-  <Step titleSize="h3" title="Click the 'Register your Shinkai Identity' link">
+  <Step title="Click the 'Register your Shinkai Identity' link">
     In `General`, under the `Shinkai identity` field, you will find the link. 
     Once clicked, it will open the Shinkai Identity Registration webpage (with your application's keys automatically filled out for you).
   </Step>
 
-  <Step titleSize="h3" title="Connect Your Wallet">
+  <Step title="Connect Your Wallet">
     On the webpage click `Connect Wallet` & **choose the one you used to receive tokens at the faucet**.
 
     ![Connect your wallet](/images/connect-wl.jpg)
@@ -43,20 +43,20 @@ Registering **a Shinkai identity on-chain enables you to connect Shinkai Desktop
     <Note> Based on the length of the name the amount of tokens required to stake will differ. **The longer the name, the less tokens you need to provide**. </Note>
 
   </Step>
-  <Step titleSize="h3" title="Download the JSON file">
+  <Step title="Download the JSON file">
     Once you've entered your desired name, proceed forward to the next step, where **you will download a JSON file that backs up your application's keys** (node keys) which will be connected to your Shinkai Identity (the identity itself is tied to your wallet making everything secure/resettable).
     ![Download the JSON File](/images/json.jpg)
     Proceed forward by **confirming** you've downloaded the JSON file, and you will now move forward with submitting the transaction on-chain.
     ![Confirm Json File](/images/confirm-json.jpg)
 
   </Step>
 
-  <Step titleSize="h3" title="Confirm Transaction">
+  <Step title="Confirm Transaction">
     Your wallet will pop-up and request to `Confirm` interaction with the smart contract.
     Once this is done, you should see a screen to `Confirm` staking your KAI tokens to register your identity.
     ![Confirm transaction](/images/transaction.jpg)
   </Step>
-  <Step titleSize="h3" title="You Have Registered Your Identity!">
+  <Step title="You Have Registered Your Identity!">
     Once the transaction confirms, **you will have officially registered your first Shinkai Identity!** 
 
     **Your identity is an NFT** which can be added to your wallet for easier tracking if you so desire.
@@ -65,7 +65,7 @@ Registering **a Shinkai identity on-chain enables you to connect Shinkai Desktop
 
   </Steps>
 
-  Congratulations! With your tokens staked they will accrue inflation awards, and **your identity can now be connected to Shinkai Desktop**. 
+    <Icon icon="hands-clapping" iconType="solid" /> Congratulations! With your tokens staked they will accrue inflation awards, and **your identity can now be connected to Shinkai Desktop**. 
 
-  Continue to the next section to learn how to connect your identity.
+  Continue to [the next section](/advanced/connect-identity) to learn how to connect your identity.
 

basics/ai-chats.mdx

@@ -38,7 +38,7 @@ When creating a new chat there are different settings you can adjust:
     Shinkai comes with algorithmic instructions –or workflows– ready to use, helping you optimize tasks and processes. 
     Just click on the workflow icon and it will display the `Workflow Library` where you can select the workflow you'd like to apply in your prompt. 
 
-    Clicking the ➕ plus icon at the top right corner will lead you to the [Playground](/advanced/workflows), where you can create custom workflows adapted to your needs. 
+    Clicking the <Icon icon="plus" iconType="duotone" /> plus icon at the top right corner will lead you to the [Playground](/advanced/workflows), where you can create custom workflows adapted to your needs. 
     <Frame>
       <img src="/images/workflows.jpg" style={{ borderRadius: '0.5rem' }} />
     </Frame>

basics/chat-settings.mdx

@@ -49,15 +49,17 @@ You can access chat settings to adjust how the model generates text. By adjustin
 To achieve optimal responses from an AI model, consider the following setup:
 <Steps>
   <Step title="Determine Your Goals"> 
-    - For **creative tasks** (*e.g., storytelling*), use a higher temperature (around `0.8`) with moderate top-p (`0.9`) and top-k (`30`).
-    - For **factual or structured responses** (*e.g., technical writing*), lower temperature (`0.5`) with lower top-p (`0.7`) and top-k (`20`) may be preferable.
+    For **creative tasks** (*e.g., storytelling*), use a higher temperature (around `0.8`) with moderate top-p (`0.9`) and top-k (`30`).
+    
+    For **factual or structured responses** (*e.g., technical writing*), lower temperature (`0.5`) with lower top-p (`0.7`) and top-k (`20`) may be preferable.
   </Step>
   <Step title="Experiment and Iterate">
-    - Start with recommended values and adjust based on output quality.
-    - Monitor for balance between creativity and coherence; **tweak one parameter at a time to understand its impact**.
+    Start with recommended values and adjust based on output quality.
+    
+    Monitor for balance between creativity and coherence; **tweak one parameter at a time to understand its impact**.
   </Step>
   <Step title="Utilize Feedback Loops">
-    - Incorporate user feedback or evaluation metrics to refine settings further.
+    Incorporate user feedback or evaluation metrics to refine settings further.
   </Step>
 </Steps>
 By carefully tuning these parameters, you can significantly enhance the performance of AI models in generating relevant, coherent, and engaging text outputs tailored to specific applications or audiences.

first-steps.mdx

@@ -27,7 +27,7 @@ The default view when you opening Shinkai Desktop is the `Chats` view. Here you
   </Tab>
   <Tab title="2. Chats">
     Here's where you can access your chats. Notice there are two tabs at the top: `Active` and `Archive`.
-    To keep your active chats view clear, you can archive each by simply hovering your cursor over the chat and clicking the 📦 box icon.  
+    To keep your active chats view clear, you can archive each by simply hovering your cursor over the chat and clicking the <Icon icon="box" iconType="duotone" /> box icon.  
   </Tab>
   <Tab title="4. AI Response Field">
     In this section you will see the AI chat response once you have prompted it with instructions or questions.