[Update]: workflow documentation for better clarity and system understanding

README.md

@@ -57,11 +57,9 @@
 
 ## Project Workflow
 
-![Identity Workflow](docs/workflow.svg)
+To understand the development process, contribution flow, and project structure, please refer to the detailed workflow guide:
 
-The diagram above gives an overview of the identity token flow: self-issued identity minting, on-chain storage of identities, endorsements between holders, optional revocation, frontend interaction with chain data, and external verification by third-party services.
-
-For more details, see [docs/workflow.md](docs/workflow.md).
+👉 [View Workflow](docs/workflow.md)
 
 ---
 

docs/workflow.md

@@ -1,17 +1,87 @@
-# Identity Tokens — Project Workflow
+# 📘 WORKFLOWS
 
-![Identity Workflow](./workflow.svg)
+This document provides an overview of all major workflows in the system. Each section includes a brief explanation and a visual diagram to help you quickly understand how different parts of the platform interact.
 
-## Overview
+---
 
-- **Self-issued identity token minting:** Users create and mint their own identity tokens, optionally attaching metadata. No central issuer is required.
+## 🔗 Connect Wallet
 
-- **On-chain identity storage:** Identity tokens and their metadata are stored on-chain (e.g. as ERC-721 NFTs), providing a portable, verifiable record.
+This is the entry point for users. By connecting a wallet, users can securely interact with the platform, sign transactions, and access features like token creation and endorsements.
 
-- **Endorsement by other identity holders:** Holders of identity tokens can endorse other identities on-chain, building a graph of attestations and trust.
+<p align="center">
+  <img src="../public/assets/workflows/connect.png" width="600"/>
+</p>
 
-- **Optional revocation:** Endorsements or credentials can support revocation (e.g. via a registry or expiry), so trust can be updated or withdrawn when needed.
+---
 
-- **Frontend reading on-chain data:** The frontend reads identity and endorsement data from the chain (e.g. via RPC and events) to display profiles, endorsements, and status.
+## 🪙 Create DIT Token (Using Platform)
 
-- **External services verifying identity:** Third-party services can verify identity and endorsements by reading the same on-chain data, enabling use cases like access control or credential checks without relying on the frontend alone.
+Users can create a DIT token through a simple and guided UI. The platform handles contract interaction, metadata setup, and transaction flow, making it beginner-friendly.
+
+<p align="center">
+  <img src="../public/assets/workflows/create-token.png" width="600"/>
+</p>
+
+---
+
+## ⚙️ Create DIT Token (Without Platform)
+
+This workflow is for advanced users who prefer direct interaction with smart contracts. It involves manually calling contract functions and handling parameters without the platform UI.
+
+<p align="center">
+  <img src="../public/assets/workflows/create-token-N.png" width="600"/>
+</p>
+
+---
+
+## 🔄 Internal Flow for Token Creation
+
+This flow explains what happens behind the scenes when a token is created — including contract deployment/interactions, metadata linking, and backend processes (if any).
+
+<p align="center">
+  <img src="../public/assets/workflows/Internal-flow-create.png" width="600"/>
+</p>
+
+---
+
+## 📦 Fetch Token Metadata
+
+This workflow shows how token metadata is retrieved using the token URI. It includes fetching details like title, description, and other attributes stored off-chain or on-chain.
+
+<p align="center">
+  <img src="../public/assets/workflows/fetch-token-metadata.png" width="600"/>
+</p>
+
+---
+
+## 👍 Endorsement Flow
+
+Users can endorse a token to validate or support it. This process includes wallet confirmation, on-chain verification, and updating the endorsement state.
+
+<p align="center">
+  <img src="../public/assets/workflows/endorsement-flow.png" width="600"/>
+</p>
+
+---
+
+## 🔄 Un-Endorsement Flow
+
+This flow allows users to remove their endorsement. It ensures proper validation and updates the blockchain state accordingly while maintaining data integrity.
+
+<p align="center">
+  <img src="../public/assets/workflows/unEndorsement-flow.png" width="600"/>
+</p>
+
+---
+
+## 🔍 Auto-fetch Metadata via Token URI
+
+Wallets and applications can automatically fetch token metadata using the token URI. This improves usability by displaying token details without manual input.
+
+<p align="center">
+  <img src="../public/assets/workflows/tokenUri.png" width="600"/>
+</p>
+
+---
+
+> 💡 These workflows provide a clear understanding of how users and the system interact, covering both user-facing actions and internal processes.