docs: guide for token detection

contribution-guides/vue-typescript.md

@@ -217,3 +217,64 @@ instead of:
   }
 }
 ```
+
+## Working with UI Library
+
+### Testing Component Changes
+
+To test unpublished UI library changes in the main application:
+
+1. **Build the Library**
+
+   ```sh
+   pnpm run build:prod
+   ```
+
+2. **Link to Application**
+   - Open `package.json` in rotki main directory `frontend/app/package.json`
+   - Change UI library version to point to local build:
+     ```json
+     {
+       "dependencies": {
+         "@rotki/ui-library": "file:../../../ui-library" // adjust path based on your UI library location
+       }
+     }
+     ```
+3. **Update Application**
+
+   ```sh
+   pnpm install
+   ```
+
+4. **Refresh Changes**
+   - Rebuild library after changes
+   - Run `pnpm install` in frontend directory
+   - Restart development server
+
+### Troubleshooting
+
+If experiencing display issues:
+
+1. Clean modules:
+
+   ```sh
+   pnpm run clean:modules
+   ```
+
+2. Reinstall dependencies:
+
+   ```sh
+   pnpm install
+   ```
+
+3. Restart development server
+   ```sh
+   pnpm run dev
+   ```
+
+### Branch Compatibility
+
+- UI Library: `main` branch
+- Rotki App: `develop` branch
+
+These branches should be compatible. If encountering issues, try cleaning and reinstalling modules to resolve caching problems.

usage-guides/assets.md

@@ -17,6 +17,36 @@ To solve this problem we added a whitelist which you can add assets to as can be
 
 ![Whitelist asset](/images/asset_whitelist_menu.png)
 
+## Whitelisting and Re-detecting Missing Tokens
+
+If a token doesn't appear in your balances, there are several ways to troubleshoot this. First you should check if it's been automatically or manually ignored. And then run a manual token detection.
+
+### Check Token is not Ignored or Marked as Spam
+
+Go to the Manage Assets -> Assets page. Use the search to find the token by name or address. Verify if the token is ignored. If ignored, unignore it. If you did not ignore it on purpose click to whitelist it so the spam detection algorithm does not falsely flag it as spam.
+
+![Example of managing assets and whitelisting a token in the Manage Assets page.](/images/manage-assets-refresh.png)
+
+### Token Detection Methods
+
+**Single Account Per-Chain Detection**
+
+The best way to detect tokens for a single address is to go to blockchain & accounts balances, scroll down to the EVM accounts view, expand the dropdown at the account, go to the per chain tab and click on the detect tokens toggle 🔃.
+
+![Example of detecting tokens for a specific chain](/images/redetect-per-chain-view.png)
+
+**All Accounts Per-Chain Detection**
+
+Go to Account & Balances -> Blockchain Balances. Scroll down to EVM accounts and click on Re-detect tokens (🔃). Here you can select specific chains to detect tokens for all your wallets. This will take a bit of time depending on tracked addresses per chain. The slowest chain for detection is ethereum.
+
+![Example of re-detecting tokens for all EVM chains in the Blockchain Balances section.](/images/redetect-tokens-chain.png)
+
+**Dashboard Full Detection**
+
+For a complete re-detection of all tokens across all your addresses and all supported chains, use the re-detect toggle (🔃) in the main dashboard view. This will perform a full scan of your addresses on every chain but will probably take quite a long time depending on amount of tracked addresses and chains.
+
+![Example of performing a full token detection using the re-detect toggle on the dashboard.](/images/redetect-tokens-dashboard.png)
+
 ## Adding/editing an asset
 
 ![Add or edit an asset](/images/rotki_add_edit_asset.png)

usage-guides/troubleshooting.md

@@ -34,6 +34,8 @@ If you just registered your ENS name and you don't see the name and/or avatar be
 
 If your asset is not showing in rotki, even though you are sure that you have a balance, you need to first ensure that the asset is present on the list of assets (read [inspecting list of assets](/usage-guides/assets.html#inspecting-list-of-assets)).
 
-If you still cannot find your asset, it might be ignored. By default, rotki only displays un-ignored assets in the table. To also show the ignored assets, choose the `Filter by ignored status → Show all`, and then unignore the asset manually. Additionally, you can whitelist the asset to prevent it from being automatically ignored by rotki's spam detection. (read: [whitelisting of ignored assets](/usage-guides/assets.html#whitelisting-of-ignored-assets))
+If you still cannot find your asset, it might be ignored. By default, rotki only displays un-ignored assets in the table. To also show the ignored assets, choose the `Filter by ignored status → Show all`, and then unignore the asset manually. Additionally, you can whitelist the asset to prevent it from being automatically ignored by rotki's spam detection (read: [whitelisting of ignored assets](/usage-guides/assets.html#whitelisting-of-ignored-assets)).
+
+After whitelisting the token, you may need to re-detect it to see it in your balances (read: [token detection methods](/usage-guides/assets.html#whitelisting-and-re-detecting-missing-tokens)).
 
 If the asset is still not showing, you may need to add it manually.