How the system is organized

The relationship between the landing site, docs app, web3 app, contracts, subgraph, and supporting diagrams.

Workspace View

landing

Brand voice, high-level product positioning, and visual reference.

web3-app

User-facing protocol client for Arbitrum Sepolia.

smart-contracts

Protocol implementation, tests, and deployment scripts.

subgraph

GoldSky indexing layer used by the app.

Runtime Relationship

User opens the app, connects a wallet, mints or burns, and then inspects activity through the account dialog.

Operators and keepers interact with Controller, StrategyManager, ExitQueue pricing, and deployment or upgrade workflows outside the web app.

Documentation Boundary

This docs app does not own protocol logic or frontend logic, but it must remain aligned with them. That means the docs source of truth is spread across:

smart-contracts/README.md
frontend-app/web3-app/README.md
frontend-app/web3-app/src/config/index.ts
frontend-app/web3-app/subgraph/*
mermaid/*.md