From 8113aaef33b68c76f889a651abf79c4f2067e0ce Mon Sep 17 00:00:00 2001
From: 0xEdmundo <0xedmundo@gmail.com>
Date: Fri, 30 Jan 2026 21:04:29 +0300
Subject: [PATCH] docs: add project structure section and document Bridge app

---
 README.md | 24 +++++++++++++++++++++++-
 1 file changed, 23 insertions(+), 1 deletion(-)

diff --git a/README.md b/README.md
index efa3d4fc42e..af79dc0d79a 100644
--- a/README.md
+++ b/README.md
@@ -47,16 +47,38 @@ To start a development server on localhost, run `yarn workspace @app/<project> d
 
 For example, to start the `web` app locally, you would run `yarn workspace @app/web dev`.
 
+## Project Structure
+
+```
+.
+├── apps/
+│   ├── bridge/           # Base Bridge application
+│   └── web/              # Main base.org website
+├── libs/
+│   └── base-ui/          # Shared UI component library
+└── tools/                # Build and development tools
+```
+
 ## Projects
 
-There are three projects which can be run individually.
+There are two applications and a shared library in this monorepo.
 
 ### Web
 
+The main base.org website.
+
 ```
 yarn workspace @app/web dev
 ```
 
+### Bridge
+
+The Base Bridge application.
+
+```
+yarn workspace @app/bridge dev
+```
+
 ## Contributing
 
 We welcome contributions to Base! For guidelines on how to contribute please refer to [CONTRIBUTING.md](CONTRIBUTING.md).