# thedatafoundation/protocol-explorer-app architecture

> Architecture diagram of the GitHub repository thedatafoundation/protocol-explorer-app, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-11-21). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/thedatafoundation/protocol-explorer-app
- Repository: https://github.com/thedatafoundation/protocol-explorer-app

## Overview

This is a Story Protocol web app for exploring IP organizations, assets, licenses, relationships, hooks, modules and transactions, and for submitting protocol actions. Users browse overview and entity pages, inspect related data, then use action forms or the SDK admin panel to create and register on-chain records. The graph follows documented page composition and sampled SDK-client calls; several views and write handlers are represented from the source index, so their internal behavior is not inferred beyond those references.

Main entry points: [`app/(main)/ipo/[ipOrgId]/page.tsx`](https://github.com/thedatafoundation/protocol-explorer-app/blob/main/app/(main)/ipo/%5BipOrgId%5D/page.tsx) (Organization detail), [`app/(creatorView)/view/[ipOrgId]/[ipAssetId]/page.tsx`](https://github.com/thedatafoundation/protocol-explorer-app/blob/main/app/(creatorView)/view/%5BipOrgId%5D/%5BipAssetId%5D/page.tsx) (Asset detail), [`app/(main)/page.tsx`](https://github.com/thedatafoundation/protocol-explorer-app/blob/main/app/(main)/page.tsx) (Overview dashboard), [`app/(main)/admin/page.tsx`](https://github.com/thedatafoundation/protocol-explorer-app/blob/main/app/(main)/admin/page.tsx) (SDK admin console)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_browse["Protocol browsing"]
  node_overview["Overview dashboard<br/>[page.tsx]"]
  node_orglist["IP organization list<br/>[page.tsx]"]
  node_assetlist["IP asset list<br/>[page.tsx]"]
  node_orgdetail["Organization detail<br/>[page.tsx]"]
  node_assetdetail["Asset detail<br/>[page.tsx]"]
  node_orgviews["Org, hook, module views"]
  node_assetviews["Asset and relationship views"]
  node_licenseviews["License views"]
  node_transactions["Transaction views"]
end

subgraph group_actions["Protocol actions"]
  node_adminpage["SDK admin console<br/>[page.tsx]"]
  node_orgwrite["Organization writes"]
  node_assetwrite["Asset writes"]
  node_relationshipwrite["Relationship writes"]
  node_typewrite["Relationship type writes"]
  node_licensewrite["License actions"]
  node_form["Write input form"]
  node_createassethook["Create asset hook"]
  node_registertypehook["Register type hook"]
end

subgraph group_client["SDK and transaction client"]
  node_storyhook["Wallet-aware client hook<br/>[useStoryClient.ts]"]
  node_storyclient["Server Story client<br/>[SP.ts]"]
  node_context["Story client context"]
end

subgraph group_ui["Presentation components"]
  node_grid["Grid component<br/>[Grid.tsx]"]
  node_skeletons["Loading placeholders<br/>[SkeletonGrid.tsx]"]
  node_cardcontainer["Card container<br/>[CardContainer.tsx]"]
  node_tableui["Table primitives<br/>[table.tsx]"]
  node_tabsui["Tab primitives<br/>[tabs.tsx]"]
end

node_visitor(("Browser user"))

node_visitor -->|"opens"| node_overview
node_visitor -->|"opens"| node_orglist
node_visitor -->|"opens"| node_assetlist
node_visitor -->|"opens"| node_orgdetail
node_visitor -->|"opens"| node_assetdetail
node_visitor -->|"opens"| node_adminpage
node_overview -->|"lists transactions"| node_storyclient
node_overview -->|"renders"| node_transactions
node_overview -->|"renders"| node_orgviews
node_orglist -->|"renders"| node_orgviews
node_orglist -->|"renders"| node_orgwrite
node_assetlist -->|"renders"| node_assetviews
node_orgdetail -->|"gets org"| node_storyclient
node_orgdetail -->|"renders"| node_assetviews
node_orgdetail -->|"renders"| node_orgviews
node_orgdetail -->|"renders"| node_licenseviews
node_orgdetail -->|"renders"| node_transactions
node_orgdetail -->|"offers action"| node_assetwrite
node_orgdetail -->|"offers action"| node_typewrite
node_assetdetail -->|"renders"| node_assetviews
node_assetdetail -->|"renders"| node_licenseviews
node_assetdetail -->|"renders"| node_transactions
node_assetdetail -->|"offers action"| node_relationshipwrite
node_assetdetail -->|"offers action"| node_licensewrite
node_adminpage -->|"renders"| node_orgwrite
node_adminpage -->|"renders"| node_assetwrite
node_adminpage -->|"renders"| node_relationshipwrite
node_adminpage -->|"renders"| node_typewrite
node_orgwrite -->|"uses form"| node_form
node_assetwrite -->|"uses form"| node_form
node_assetwrite -->|"executes via"| node_createassethook
node_relationshipwrite -->|"uses form"| node_form
node_typewrite -->|"uses form"| node_form
node_typewrite -->|"executes via"| node_registertypehook
node_createassethook -->|"gets client"| node_storyhook
node_registertypehook -->|"gets client"| node_storyhook
node_transactions -->|"lists transactions"| node_storyclient
node_storyhook -.->|"uses wallet"| node_visitor
node_skeletons -->|"uses grid"| node_grid
node_overview -.->|"uses tabs"| node_tabsui
node_tableui -->|"supports loading"| node_skeletons
node_cardcontainer -.->|"used by cards"| node_overview

click node_overview "https://github.com/thedatafoundation/protocol-explorer-app/blob/main/app/(main)/page.tsx"
click node_orglist "https://github.com/thedatafoundation/protocol-explorer-app/blob/main/app/(main)/ipo/page.tsx"
click node_assetlist "https://github.com/thedatafoundation/protocol-explorer-app/blob/main/app/(main)/ipa/page.tsx"
click node_orgdetail "https://github.com/thedatafoundation/protocol-explorer-app/blob/main/app/(main)/ipo/%5BipOrgId%5D/page.tsx"
click node_assetdetail "https://github.com/thedatafoundation/protocol-explorer-app/blob/main/app/(creatorView)/view/%5BipOrgId%5D/%5BipAssetId%5D/page.tsx"
click node_orgviews "https://github.com/thedatafoundation/protocol-explorer-app/tree/main/components/views/IPOrg"
click node_assetviews "https://github.com/thedatafoundation/protocol-explorer-app/tree/main/components/views/Asset"
click node_licenseviews "https://github.com/thedatafoundation/protocol-explorer-app/tree/main/components/views/Licenses"
click node_transactions "https://github.com/thedatafoundation/protocol-explorer-app/blob/main/components/views/Transactions/TransactionTableWrapper.tsx"
click node_adminpage "https://github.com/thedatafoundation/protocol-explorer-app/blob/main/app/(main)/admin/page.tsx"
click node_orgwrite "https://github.com/thedatafoundation/protocol-explorer-app/blob/main/app/(main)/admin/IPOrgWriteAccordion.tsx"
click node_assetwrite "https://github.com/thedatafoundation/protocol-explorer-app/blob/main/app/(main)/admin/IPAssetWriteAccordion.tsx"
click node_relationshipwrite "https://github.com/thedatafoundation/protocol-explorer-app/blob/main/app/(main)/admin/RelationshipWriteAccordion.tsx"
click node_typewrite "https://github.com/thedatafoundation/protocol-explorer-app/blob/main/app/(main)/admin/RelationshipTypeWriteAccordion.tsx"
click node_licensewrite "https://github.com/thedatafoundation/protocol-explorer-app/blob/main/app/(main)/admin/CreateIpaBoundLicenseWriteAccordion.tsx"
click node_form "https://github.com/thedatafoundation/protocol-explorer-app/blob/main/app/(main)/admin/WriteAccordionInputForm.tsx"
click node_createassethook "https://github.com/thedatafoundation/protocol-explorer-app/blob/main/hooks/useCreateIpAsset.ts"
click node_registertypehook "https://github.com/thedatafoundation/protocol-explorer-app/blob/main/hooks/useRegisterRelationshipType.ts"
click node_storyhook "https://github.com/thedatafoundation/protocol-explorer-app/blob/main/hooks/useStoryClient.ts"
click node_storyclient "https://github.com/thedatafoundation/protocol-explorer-app/blob/main/lib/SP.ts"
click node_context "https://github.com/thedatafoundation/protocol-explorer-app/blob/main/app/(main)/context/StoryClientContext.tsx"
click node_grid "https://github.com/thedatafoundation/protocol-explorer-app/blob/main/components/Grid/Grid.tsx"
click node_skeletons "https://github.com/thedatafoundation/protocol-explorer-app/blob/main/components/Skeletons/SkeletonGrid.tsx"
click node_cardcontainer "https://github.com/thedatafoundation/protocol-explorer-app/blob/main/components/cards/CardContainer.tsx"
click node_tableui "https://github.com/thedatafoundation/protocol-explorer-app/blob/main/components/ui/table.tsx"
click node_tabsui "https://github.com/thedatafoundation/protocol-explorer-app/blob/main/components/ui/tabs.tsx"

classDef toneNeutral fill:#f8fafc,stroke:#334155,stroke-width:1.5px,color:#0f172a
classDef toneBlue fill:#dbeafe,stroke:#2563eb,stroke-width:1.5px,color:#172554
classDef toneAmber fill:#fef3c7,stroke:#d97706,stroke-width:1.5px,color:#78350f
classDef toneMint fill:#dcfce7,stroke:#16a34a,stroke-width:1.5px,color:#14532d
classDef toneRose fill:#ffe4e6,stroke:#e11d48,stroke-width:1.5px,color:#881337
classDef toneIndigo fill:#e0e7ff,stroke:#4f46e5,stroke-width:1.5px,color:#312e81
classDef toneTeal fill:#ccfbf1,stroke:#0f766e,stroke-width:1.5px,color:#134e4a
class node_overview,node_orglist,node_assetlist,node_orgdetail,node_assetdetail,node_orgviews,node_assetviews,node_licenseviews,node_transactions,node_visitor toneBlue
class node_adminpage,node_orgwrite,node_assetwrite,node_relationshipwrite,node_typewrite,node_licensewrite,node_form,node_createassethook,node_registertypehook toneAmber
class node_storyhook,node_storyclient,node_context toneMint
class node_grid,node_skeletons,node_cardcontainer,node_tableui,node_tabsui toneRose
```

## Components

### Protocol browsing

- [Overview dashboard](https://github.com/thedatafoundation/protocol-explorer-app/blob/main/app/(main)/page.tsx): `app/(main)/page.tsx`
- [IP organization list](https://github.com/thedatafoundation/protocol-explorer-app/blob/main/app/(main)/ipo/page.tsx): `app/(main)/ipo/page.tsx`
- [IP asset list](https://github.com/thedatafoundation/protocol-explorer-app/blob/main/app/(main)/ipa/page.tsx): `app/(main)/ipa/page.tsx`
- [Organization detail](https://github.com/thedatafoundation/protocol-explorer-app/blob/main/app/(main)/ipo/%5BipOrgId%5D/page.tsx): `app/(main)/ipo/[ipOrgId]/page.tsx`
- [Asset detail](https://github.com/thedatafoundation/protocol-explorer-app/blob/main/app/(creatorView)/view/%5BipOrgId%5D/%5BipAssetId%5D/page.tsx): `app/(creatorView)/view/[ipOrgId]/[ipAssetId]/page.tsx`
- [Org, hook, module views](https://github.com/thedatafoundation/protocol-explorer-app/tree/main/components/views/IPOrg): `components/views/IPOrg`
- [Asset and relationship views](https://github.com/thedatafoundation/protocol-explorer-app/tree/main/components/views/Asset): `components/views/Asset`
- [License views](https://github.com/thedatafoundation/protocol-explorer-app/tree/main/components/views/Licenses): `components/views/Licenses`
- [Transaction views](https://github.com/thedatafoundation/protocol-explorer-app/blob/main/components/views/Transactions/TransactionTableWrapper.tsx): `components/views/Transactions/TransactionTableWrapper.tsx`

### Protocol actions

- [SDK admin console](https://github.com/thedatafoundation/protocol-explorer-app/blob/main/app/(main)/admin/page.tsx): `app/(main)/admin/page.tsx`
- [Organization writes](https://github.com/thedatafoundation/protocol-explorer-app/blob/main/app/(main)/admin/IPOrgWriteAccordion.tsx): `app/(main)/admin/IPOrgWriteAccordion.tsx`
- [Asset writes](https://github.com/thedatafoundation/protocol-explorer-app/blob/main/app/(main)/admin/IPAssetWriteAccordion.tsx): `app/(main)/admin/IPAssetWriteAccordion.tsx`
- [Relationship writes](https://github.com/thedatafoundation/protocol-explorer-app/blob/main/app/(main)/admin/RelationshipWriteAccordion.tsx): `app/(main)/admin/RelationshipWriteAccordion.tsx`
- [Relationship type writes](https://github.com/thedatafoundation/protocol-explorer-app/blob/main/app/(main)/admin/RelationshipTypeWriteAccordion.tsx): `app/(main)/admin/RelationshipTypeWriteAccordion.tsx`
- [License actions](https://github.com/thedatafoundation/protocol-explorer-app/blob/main/app/(main)/admin/CreateIpaBoundLicenseWriteAccordion.tsx): `app/(main)/admin/CreateIpaBoundLicenseWriteAccordion.tsx`
- [Write input form](https://github.com/thedatafoundation/protocol-explorer-app/blob/main/app/(main)/admin/WriteAccordionInputForm.tsx): `app/(main)/admin/WriteAccordionInputForm.tsx`
- [Create asset hook](https://github.com/thedatafoundation/protocol-explorer-app/blob/main/hooks/useCreateIpAsset.ts): `hooks/useCreateIpAsset.ts`
- [Register type hook](https://github.com/thedatafoundation/protocol-explorer-app/blob/main/hooks/useRegisterRelationshipType.ts): `hooks/useRegisterRelationshipType.ts`

### SDK and transaction client

- [Wallet-aware client hook](https://github.com/thedatafoundation/protocol-explorer-app/blob/main/hooks/useStoryClient.ts): `hooks/useStoryClient.ts`
- [Server Story client](https://github.com/thedatafoundation/protocol-explorer-app/blob/main/lib/SP.ts): `lib/SP.ts`
- [Story client context](https://github.com/thedatafoundation/protocol-explorer-app/blob/main/app/(main)/context/StoryClientContext.tsx): `app/(main)/context/StoryClientContext.tsx`

### Presentation components

- [Grid component](https://github.com/thedatafoundation/protocol-explorer-app/blob/main/components/Grid/Grid.tsx): `components/Grid/Grid.tsx`
- [Loading placeholders](https://github.com/thedatafoundation/protocol-explorer-app/blob/main/components/Skeletons/SkeletonGrid.tsx): `components/Skeletons/SkeletonGrid.tsx`
- [Card container](https://github.com/thedatafoundation/protocol-explorer-app/blob/main/components/cards/CardContainer.tsx): `components/cards/CardContainer.tsx`
- [Table primitives](https://github.com/thedatafoundation/protocol-explorer-app/blob/main/components/ui/table.tsx): `components/ui/table.tsx`
- [Tab primitives](https://github.com/thedatafoundation/protocol-explorer-app/blob/main/components/ui/tabs.tsx): `components/ui/tabs.tsx`

### Other components

- **Browser user**

## Connections

- Browser user → Overview dashboard: opens
- Browser user → IP organization list: opens
- Browser user → IP asset list: opens
- Browser user → Organization detail: opens
- Browser user → Asset detail: opens
- Browser user → SDK admin console: opens
- Overview dashboard → Server Story client: lists transactions (evidence: `app/(main)/page.tsx`)
- Overview dashboard → Transaction views: renders (evidence: `app/(main)/page.tsx`)
- Overview dashboard → Org, hook, module views: renders (evidence: `app/(main)/page.tsx`)
- IP organization list → Org, hook, module views: renders (evidence: `app/(main)/ipo/page.tsx`)
- IP organization list → Organization writes: renders (evidence: `app/(main)/ipo/page.tsx`)
- IP asset list → Asset and relationship views: renders (evidence: `app/(main)/ipa/page.tsx`)
- Organization detail → Server Story client: gets org (evidence: `app/(main)/ipo/[ipOrgId]/page.tsx`)
- Organization detail → Asset and relationship views: renders (evidence: `app/(main)/ipo/[ipOrgId]/page.tsx`)
- Organization detail → Org, hook, module views: renders (evidence: `app/(main)/ipo/[ipOrgId]/page.tsx`)
- Organization detail → License views: renders (evidence: `app/(main)/ipo/[ipOrgId]/page.tsx`)
- Organization detail → Transaction views: renders (evidence: `app/(main)/ipo/[ipOrgId]/page.tsx`)
- Organization detail → Asset writes: offers action (evidence: `app/(main)/ipo/[ipOrgId]/page.tsx`)
- Organization detail → Relationship type writes: offers action (evidence: `app/(main)/ipo/[ipOrgId]/page.tsx`)
- Asset detail → Asset and relationship views: renders (evidence: `app/(creatorView)/view/[ipOrgId]/[ipAssetId]/page.tsx`)
- Asset detail → License views: renders (evidence: `app/(creatorView)/view/[ipOrgId]/[ipAssetId]/page.tsx`)
- Asset detail → Transaction views: renders (evidence: `app/(creatorView)/view/[ipOrgId]/[ipAssetId]/page.tsx`)
- Asset detail → Relationship writes: offers action (evidence: `app/(creatorView)/view/[ipOrgId]/[ipAssetId]/page.tsx`)
- Asset detail → License actions: offers action (evidence: `app/(creatorView)/view/[ipOrgId]/[ipAssetId]/page.tsx`)
- SDK admin console → Organization writes: renders (evidence: `app/(main)/admin/page.tsx`)
- SDK admin console → Asset writes: renders (evidence: `app/(main)/admin/page.tsx`)
- SDK admin console → Relationship writes: renders (evidence: `app/(main)/admin/page.tsx`)
- SDK admin console → Relationship type writes: renders (evidence: `app/(main)/admin/page.tsx`)
- Organization writes → Write input form: uses form (evidence: `app/(main)/admin/IPOrgWriteAccordion.tsx`)
- Asset writes → Write input form: uses form (evidence: `app/(main)/admin/IPAssetWriteAccordion.tsx`)
- Asset writes → Create asset hook: executes via (evidence: `app/(main)/admin/IPAssetWriteAccordion.tsx`)
- Relationship writes → Write input form: uses form (evidence: `app/(main)/admin/RelationshipWriteAccordion.tsx`)
- Relationship type writes → Write input form: uses form (evidence: `app/(main)/admin/RelationshipTypeWriteAccordion.tsx`)
- Relationship type writes → Register type hook: executes via (evidence: `app/(main)/admin/RelationshipTypeWriteAccordion.tsx`)
- Create asset hook → Wallet-aware client hook: gets client (evidence: `hooks/useCreateIpAsset.ts`)
- Register type hook → Wallet-aware client hook: gets client (evidence: `hooks/useRegisterRelationshipType.ts`)
- Transaction views → Server Story client: lists transactions (evidence: `components/views/Transactions/TransactionTableWrapper.tsx`)
- Wallet-aware client hook → Browser user: uses wallet
- Loading placeholders → Grid component: uses grid (evidence: `components/Skeletons/SkeletonGrid.tsx`)
- Overview dashboard → Tab primitives: uses tabs
- Table primitives → Loading placeholders: supports loading
- Card container → Overview dashboard: used by cards
