docs: add hook-pkg documentation

.gitignore

@@ -1,10 +1,3 @@
-<<<<<<< HEAD
-# Compiler files
-cache/
-out/
-
-# Ignores development broadcast logs
-=======
 # =============================================================================
 # Environment Variables - CRITICAL: Never commit .env files
 # =============================================================================
@@ -26,23 +19,14 @@ contracts/foundry-out/
 contracts/out/
 
 # Development broadcast logs (keep broadcast structure, ignore specific chains)
->>>>>>> 8b13a35cb03fb14cdb9f34a7b7b429971bb197b8
 !/broadcast
 /broadcast/*/31337/
 /broadcast/**/dry-run/
 
-<<<<<<< HEAD
-# Docs
-docs/
-
-# Dotenv file
-.env
-=======
 # =============================================================================
 # Hardhat Build Artifacts (if used)
 # =============================================================================
 artifacts/
-cache/
 typechain/
 typechain-types/
 
@@ -141,4 +125,3 @@ agents/
 *.temp
 .cache/
 .temp/
->>>>>>> 8b13a35cb03fb14cdb9f34a7b7b429971bb197b8

README.md

@@ -1,14 +1,54 @@
 # Hook Bazaar Monorepo
 
+<div align="center">
+
+  <img src="https://img.shields.io/badge/Solidity-363636?style=for-the-badge&logo=solidity&logoColor=white" alt="Solidity"/>
+  <img src="https://img.shields.io/badge/Ethereum-3C3C3D?style=for-the-badge&logo=ethereum&logoColor=white" alt="Ethereum"/>
+  <img src="https://img.shields.io/badge/Uniswap-FF007A?style=for-the-badge&logo=uniswap&logoColor=white" alt="Uniswap"/>
+  <img src="https://img.shields.io/badge/TypeScript-3178C6?style=for-the-badge&logo=typescript&logoColor=white" alt="TypeScript"/>
+  <img src="https://img.shields.io/badge/React-61DAFB?style=for-the-badge&logo=react&logoColor=black" alt="React"/>
+  <img src="https://img.shields.io/badge/Vite-646CFF?style=for-the-badge&logo=vite&logoColor=white" alt="Vite"/>
+  <img src="https://img.shields.io/badge/Tailwind_CSS-38B2AC?style=for-the-badge&logo=tailwind-css&logoColor=white" alt="Tailwind CSS"/>
+  <img src="https://img.shields.io/badge/Foundry-000000?style=for-the-badge&logo=foundry&logoColor=white" alt="Foundry"/>
+  <img src="https://img.shields.io/badge/Node.js-339933?style=for-the-badge&logo=node.js&logoColor=white" alt="Node.js"/>
+  <img src="https://img.shields.io/badge/PostgreSQL-4169E1?style=for-the-badge&logo=postgresql&logoColor=white" alt="PostgreSQL"/>
+  <img src="https://img.shields.io/badge/Subsquid-000000?style=for-the-badge&logo=data:image/svg+xml;base64,PHN2Zz48L3N2Zz4=&logoColor=white" alt="Subsquid"/>
+
+</div>
+
+<p align="center">
+  <img src="client2/src/assets/d9960bdb814135603341883999ea9dc547d831b8.png" alt="Description" width="300"/>
+</p>
+
+
+
+## Table of Contents
+- [Hook Bazaar Monorepo](#Hook Bazaar Monorepo)
+  - [Table of Contents](#table-of-contents)
+  - [Demo](#demo)
+  - [Problem Description](#problem-description)
+  - [Solution Overview](#solution-overview)
+  - [Arquitecture](#arquitecture)
+  - [Setup](#setup)
+    - [Build](#build)
+    - [Test](#test)
+    - [Deploy](#deploy)
+  - [References](#references)
+
+
+# Setup
+
 Minimal setup to run the frontend and indexer locally.
 
 ## Prerequisites
 
 - Node.js v18+
 - Docker (for indexer PostgreSQL)
+- Foundry
 
 ## Quick Start
 
+
 ### 1. Install Dependencies
 
 ```bash
@@ -28,51 +68,8 @@ Frontend runs on: **http://localhost:3000**
 
 ### 3. Indexer
 
-#### Setup (first time only)
-
-1. Set RPC endpoint in root `.env`:
-   ```bash
-   RPC_UNI_TESTNET_HTTP=https://your-rpc-endpoint-here
-   ```
-   (The indexer reads from the root `.env` file)
-
-2. Start PostgreSQL:
-   ```bash
-   npm run indexer:db:up
-   ```
-
-3. Build and migrate:
-   ```bash
-   npm run indexer:build
-   npm run indexer:migration
-   ```
-
-#### Run Indexer
-
-```bash
-npm run indexer
-```
-
-Indexer runs on: **PostgreSQL port 5432**
-
-(Optional) GraphQL server on port 4350:
-```bash
-npm run indexer:graphql
-```
-**Note:** Requires `@subsquid/openreader` package (install with `npm install`)
-
-## Available Commands
-
-### Frontend
-- `npm run dev` - Start Vite dev server (port 3000)
-- `npm run build` - Build for production
-
-### Indexer
-- `npm run indexer:build` - Build TypeScript
-- `npm run indexer` - Run indexer processor
-- `npm run indexer:graphql` - Start GraphQL server (port 4350)
-
-### Contracts
+### 4. Contracts
 - `forge build` - Compile contracts
 - `forge test` - Run tests
 
+