# paulmillr/apps architecture

> Architecture diagram of the GitHub repository paulmillr/apps, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-10-02). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/paulmillr/apps
- Repository: https://github.com/paulmillr/apps

## Overview

This generated collection contains two distinct browser products: ESPLR, a local Ethereum block explorer, and a privacy-oriented Nostr client. ESPLR’s principal workflow is connect to an RPC endpoint, navigate to a block, transaction, or address, and inspect cached blockchain details; its address pages also expose token and NFT information. The Nostr client routes users to feeds, profiles/events, chats, and settings; feeds retrieve relay events for display, while event views support replies and inspection. Several view and integration links are based on documented routes or imports; unsampled runtime wiring is omitted or marked unverified.

Main entry points: [`legacy/esplr/src/router/index.ts`](https://github.com/paulmillr/apps/blob/main/legacy/esplr/src/router/index.ts) (Explorer routes), [`legacy/nostr/src/views/Feed.vue`](https://github.com/paulmillr/apps/blob/main/legacy/nostr/src/views/Feed.vue) (Feed view), [`legacy/nostr/src/router.ts`](https://github.com/paulmillr/apps/blob/main/legacy/nostr/src/router.ts) (Nostr routes), [`legacy/nostr/src/components/EventContent.vue`](https://github.com/paulmillr/apps/blob/main/legacy/nostr/src/components/EventContent.vue) (Event content)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_esplr_entry["ESPLR entry"]
  node_esplr_shell["Explorer shell<br/>[App.vue]"]
  node_esplr_router["Explorer routes<br/>[index.ts]"]
  node_rpc_connection["RPC connection<br/>[App.vue]"]
end

subgraph group_esplr_explorer["ESPLR explorer"]
  node_explorer_search["Explorer search<br/>[Search.vue]"]
  node_main_dashboard["Main dashboard<br/>[MainView.vue]"]
  node_address_details["Address details<br/>[AddressView.vue]"]
  node_tx_details["Transaction details"]
  node_block_details["Block details<br/>[BlockView.vue]"]
  node_nft_details["NFT details<br/>[NftView.vue]"]
end

subgraph group_esplr_state["ESPLR state"]
  node_address_cache[("Address cache")]
  node_page_cache[("Main-page cache")]
  node_favorites["Favorites<br/>[Favorites.vue]"]
  node_settings["Explorer settings<br/>[SettingsView.vue]"]
end

subgraph group_nostr_entry["Nostr entry"]
  node_nostr_shell["Nostr app shell<br/>[App.vue]"]
  node_nostr_router["Nostr routes<br/>[router.ts]"]
end

subgraph group_nostr_social["Nostr social"]
  node_feed_view["Feed view<br/>[Feed.vue]"]
  node_event_list["Relay event list"]
  node_event_content["Event content<br/>[EventContent.vue]"]
  node_event_text["Event text<br/>[EventText.vue]"]
  node_chat_view["Chat view<br/>[Chat.vue]"]
  node_user_view["User and event view<br/>[User.vue]"]
end

subgraph group_nostr_state["Nostr state"]
  node_feed_store["Feed state<br/>[Feed.ts]"]
  node_relay_store["Relay state<br/>[Relay.ts]"]
  node_pool_store["Relay pool<br/>[Pool.ts]"]
  node_settings_view["Nostr settings<br/>[Settings.vue]"]
  node_key_store[("Private key state<br/>[Nsec.ts]")]
end

node_explorer_user(("Explorer user"))
node_rpc_endpoint{{"Ethereum RPC"}}
node_nostr_user(("Nostr user"))
node_nostr_relays{{"Nostr relays"}}

node_explorer_user -->|"opens explorer"| node_esplr_shell
node_esplr_shell -->|"connects through"| node_rpc_connection
node_rpc_connection -->|"sends RPC"| node_rpc_endpoint
node_esplr_shell -->|"renders routes"| node_esplr_router
node_esplr_router -->|"routes to"| node_main_dashboard
node_esplr_router -->|"routes to"| node_address_details
node_esplr_router -->|"routes to"| node_tx_details
node_esplr_router -->|"routes to"| node_block_details
node_esplr_router -->|"routes to"| node_nft_details
node_explorer_search -.->|"searches addresses"| node_address_details
node_address_details -.->|"uses cached data"| node_address_cache
node_main_dashboard -.->|"uses cached data"| node_page_cache
node_favorites -.->|"stores favorites"| node_address_cache
node_settings -.->|"manages local data"| node_address_cache
node_nostr_user -->|"opens client"| node_nostr_shell
node_nostr_shell -->|"renders routes"| node_nostr_router
node_nostr_router -->|"routes to"| node_feed_view
node_nostr_router -->|"routes to"| node_chat_view
node_nostr_router -->|"routes to"| node_user_view
node_nostr_router -->|"routes to"| node_settings_view
node_feed_view -->|"updates state"| node_feed_store
node_feed_view -->|"reads relays"| node_relay_store
node_feed_view -->|"queries events"| node_pool_store
node_feed_view -->|"fetches events"| node_nostr_relays
node_feed_view -->|"renders events"| node_event_list
node_event_list -.->|"displays events"| node_event_content
node_event_content -->|"renders text"| node_event_text
node_event_content -->|"loads thread events"| node_pool_store
node_event_content -->|"publishes replies"| node_nostr_relays
node_nostr_shell -->|"restores key state"| node_key_store

click node_esplr_shell "https://github.com/paulmillr/apps/blob/main/legacy/esplr/src/App.vue"
click node_esplr_router "https://github.com/paulmillr/apps/blob/main/legacy/esplr/src/router/index.ts"
click node_rpc_connection "https://github.com/paulmillr/apps/blob/main/legacy/esplr/src/App.vue"
click node_explorer_search "https://github.com/paulmillr/apps/blob/main/legacy/esplr/src/components/Search.vue"
click node_main_dashboard "https://github.com/paulmillr/apps/blob/main/legacy/esplr/src/views/MainView.vue"
click node_address_details "https://github.com/paulmillr/apps/blob/main/legacy/esplr/src/views/AddressView.vue"
click node_tx_details "https://github.com/paulmillr/apps/blob/main/legacy/esplr/src/views/TransactionView.vue"
click node_block_details "https://github.com/paulmillr/apps/blob/main/legacy/esplr/src/views/BlockView.vue"
click node_nft_details "https://github.com/paulmillr/apps/blob/main/legacy/esplr/src/views/NftView.vue"
click node_address_cache "https://github.com/paulmillr/apps/blob/main/legacy/esplr/src/cache/address/localstorage-address-storage.ts"
click node_page_cache "https://github.com/paulmillr/apps/blob/main/legacy/esplr/src/cache/main-page/localstorage-main-page-storage.ts"
click node_favorites "https://github.com/paulmillr/apps/blob/main/legacy/esplr/src/components/main-view/Favorites.vue"
click node_settings "https://github.com/paulmillr/apps/blob/main/legacy/esplr/src/views/SettingsView.vue"
click node_nostr_shell "https://github.com/paulmillr/apps/blob/main/legacy/nostr/src/App.vue"
click node_nostr_router "https://github.com/paulmillr/apps/blob/main/legacy/nostr/src/router.ts"
click node_feed_view "https://github.com/paulmillr/apps/blob/main/legacy/nostr/src/views/Feed.vue"
click node_feed_store "https://github.com/paulmillr/apps/blob/main/legacy/nostr/src/stores/Feed.ts"
click node_relay_store "https://github.com/paulmillr/apps/blob/main/legacy/nostr/src/stores/Relay.ts"
click node_pool_store "https://github.com/paulmillr/apps/blob/main/legacy/nostr/src/stores/Pool.ts"
click node_event_list "https://github.com/paulmillr/apps/blob/main/legacy/nostr/src/components/RelayEventsList.vue"
click node_event_content "https://github.com/paulmillr/apps/blob/main/legacy/nostr/src/components/EventContent.vue"
click node_event_text "https://github.com/paulmillr/apps/blob/main/legacy/nostr/src/components/EventText/EventText.vue"
click node_chat_view "https://github.com/paulmillr/apps/blob/main/legacy/nostr/src/views/Chat.vue"
click node_user_view "https://github.com/paulmillr/apps/blob/main/legacy/nostr/src/views/User.vue"
click node_settings_view "https://github.com/paulmillr/apps/blob/main/legacy/nostr/src/views/Settings.vue"
click node_key_store "https://github.com/paulmillr/apps/blob/main/legacy/nostr/src/stores/Nsec.ts"

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_esplr_shell,node_esplr_router,node_rpc_connection,node_explorer_user,node_nostr_user toneBlue
class node_explorer_search,node_main_dashboard,node_address_details,node_tx_details,node_block_details,node_nft_details toneAmber
class node_address_cache,node_page_cache,node_favorites,node_settings toneMint
class node_nostr_shell,node_nostr_router toneRose
class node_feed_view,node_event_list,node_event_content,node_event_text,node_chat_view,node_user_view,node_rpc_endpoint,node_nostr_relays toneIndigo
class node_feed_store,node_relay_store,node_pool_store,node_settings_view,node_key_store toneTeal
```

## Components

### ESPLR entry

- [Explorer shell](https://github.com/paulmillr/apps/blob/main/legacy/esplr/src/App.vue): `legacy/esplr/src/App.vue`
- [Explorer routes](https://github.com/paulmillr/apps/blob/main/legacy/esplr/src/router/index.ts): `legacy/esplr/src/router/index.ts`
- [RPC connection](https://github.com/paulmillr/apps/blob/main/legacy/esplr/src/App.vue): `legacy/esplr/src/App.vue`

### ESPLR explorer

- [Explorer search](https://github.com/paulmillr/apps/blob/main/legacy/esplr/src/components/Search.vue): `legacy/esplr/src/components/Search.vue`
- [Main dashboard](https://github.com/paulmillr/apps/blob/main/legacy/esplr/src/views/MainView.vue): `legacy/esplr/src/views/MainView.vue`
- [Address details](https://github.com/paulmillr/apps/blob/main/legacy/esplr/src/views/AddressView.vue): `legacy/esplr/src/views/AddressView.vue`
- [Transaction details](https://github.com/paulmillr/apps/blob/main/legacy/esplr/src/views/TransactionView.vue): `legacy/esplr/src/views/TransactionView.vue`
- [Block details](https://github.com/paulmillr/apps/blob/main/legacy/esplr/src/views/BlockView.vue): `legacy/esplr/src/views/BlockView.vue`
- [NFT details](https://github.com/paulmillr/apps/blob/main/legacy/esplr/src/views/NftView.vue): `legacy/esplr/src/views/NftView.vue`

### ESPLR state

- [Address cache](https://github.com/paulmillr/apps/blob/main/legacy/esplr/src/cache/address/localstorage-address-storage.ts): `legacy/esplr/src/cache/address/localstorage-address-storage.ts`
- [Main-page cache](https://github.com/paulmillr/apps/blob/main/legacy/esplr/src/cache/main-page/localstorage-main-page-storage.ts): `legacy/esplr/src/cache/main-page/localstorage-main-page-storage.ts`
- [Favorites](https://github.com/paulmillr/apps/blob/main/legacy/esplr/src/components/main-view/Favorites.vue): `legacy/esplr/src/components/main-view/Favorites.vue`
- [Explorer settings](https://github.com/paulmillr/apps/blob/main/legacy/esplr/src/views/SettingsView.vue): `legacy/esplr/src/views/SettingsView.vue`

### Nostr entry

- [Nostr app shell](https://github.com/paulmillr/apps/blob/main/legacy/nostr/src/App.vue): `legacy/nostr/src/App.vue`
- [Nostr routes](https://github.com/paulmillr/apps/blob/main/legacy/nostr/src/router.ts): `legacy/nostr/src/router.ts`

### Nostr social

- [Feed view](https://github.com/paulmillr/apps/blob/main/legacy/nostr/src/views/Feed.vue): `legacy/nostr/src/views/Feed.vue`
- [Relay event list](https://github.com/paulmillr/apps/blob/main/legacy/nostr/src/components/RelayEventsList.vue): `legacy/nostr/src/components/RelayEventsList.vue`
- [Event content](https://github.com/paulmillr/apps/blob/main/legacy/nostr/src/components/EventContent.vue): `legacy/nostr/src/components/EventContent.vue`
- [Event text](https://github.com/paulmillr/apps/blob/main/legacy/nostr/src/components/EventText/EventText.vue): `legacy/nostr/src/components/EventText/EventText.vue`
- [Chat view](https://github.com/paulmillr/apps/blob/main/legacy/nostr/src/views/Chat.vue): `legacy/nostr/src/views/Chat.vue`
- [User and event view](https://github.com/paulmillr/apps/blob/main/legacy/nostr/src/views/User.vue): `legacy/nostr/src/views/User.vue`

### Nostr state

- [Feed state](https://github.com/paulmillr/apps/blob/main/legacy/nostr/src/stores/Feed.ts): `legacy/nostr/src/stores/Feed.ts`
- [Relay state](https://github.com/paulmillr/apps/blob/main/legacy/nostr/src/stores/Relay.ts): `legacy/nostr/src/stores/Relay.ts`
- [Relay pool](https://github.com/paulmillr/apps/blob/main/legacy/nostr/src/stores/Pool.ts): `legacy/nostr/src/stores/Pool.ts`
- [Nostr settings](https://github.com/paulmillr/apps/blob/main/legacy/nostr/src/views/Settings.vue): `legacy/nostr/src/views/Settings.vue`
- [Private key state](https://github.com/paulmillr/apps/blob/main/legacy/nostr/src/stores/Nsec.ts): `legacy/nostr/src/stores/Nsec.ts`

### Other components

- **Explorer user**
- **Ethereum RPC**
- **Nostr user**
- **Nostr relays**

## Connections

- Explorer user → Explorer shell: opens explorer
- Explorer shell → RPC connection: connects through (evidence: `legacy/esplr/src/App.vue`)
- RPC connection → Ethereum RPC: sends RPC (evidence: `legacy/esplr/src/App.vue`)
- Explorer shell → Explorer routes: renders routes (evidence: `legacy/esplr/src/App.vue`)
- Explorer routes → Main dashboard: routes to (evidence: `legacy/esplr/src/router/index.ts`)
- Explorer routes → Address details: routes to (evidence: `legacy/esplr/src/router/index.ts`)
- Explorer routes → Transaction details: routes to (evidence: `legacy/esplr/src/router/index.ts`)
- Explorer routes → Block details: routes to (evidence: `legacy/esplr/src/router/index.ts`)
- Explorer routes → NFT details: routes to (evidence: `legacy/esplr/src/router/index.ts`)
- Explorer search → Address details: searches addresses
- Address details → Address cache: uses cached data
- Main dashboard → Main-page cache: uses cached data
- Favorites → Address cache: stores favorites
- Explorer settings → Address cache: manages local data
- Nostr user → Nostr app shell: opens client
- Nostr app shell → Nostr routes: renders routes (evidence: `legacy/nostr/src/App.vue`)
- Nostr routes → Feed view: routes to (evidence: `legacy/nostr/src/router.ts`)
- Nostr routes → Chat view: routes to (evidence: `legacy/nostr/src/router.ts`)
- Nostr routes → User and event view: routes to (evidence: `legacy/nostr/src/router.ts`)
- Nostr routes → Nostr settings: routes to (evidence: `legacy/nostr/src/router.ts`)
- Feed view → Feed state: updates state (evidence: `legacy/nostr/src/views/Feed.vue`)
- Feed view → Relay state: reads relays (evidence: `legacy/nostr/src/views/Feed.vue`)
- Feed view → Relay pool: queries events (evidence: `legacy/nostr/src/views/Feed.vue`)
- Feed view → Nostr relays: fetches events (evidence: `legacy/nostr/src/views/Feed.vue`)
- Feed view → Relay event list: renders events (evidence: `legacy/nostr/src/views/Feed.vue`)
- Relay event list → Event content: displays events
- Event content → Event text: renders text (evidence: `legacy/nostr/src/components/EventContent.vue`)
- Event content → Relay pool: loads thread events (evidence: `legacy/nostr/src/components/EventContent.vue`)
- Event content → Nostr relays: publishes replies (evidence: `legacy/nostr/src/components/EventContent.vue`)
- Nostr app shell → Private key state: restores key state (evidence: `legacy/nostr/src/App.vue`)
