> For the complete documentation index, see [llms.txt](https://aoe.gitbook.io/yell-up/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://aoe.gitbook.io/yell-up/tech-stack.md).

# Tech Stack

YELL-UP is designed as a **web-based dApp** that combines real-time voice analysis with blockchain-based rewards. The architecture emphasizes **privacy**, **performance**, and **modularity**, so it can evolve easily with future tech decisions (e.g., finalizing blockchain layer, token contracts, etc).

***

#### ⚙️ Core Tech Stack

| Layer                   | Technology                                                                  | Description                                         |
| ----------------------- | --------------------------------------------------------------------------- | --------------------------------------------------- |
| **Frontend**            | React.js + Tailwind CSS                                                     | Fast, responsive UI for web app                     |
| **Voice Capture**       | Web Audio API                                                               | Captures and processes mic input in-browser         |
| **Audio Analysis**      | TensorFlow\.js or ONNX.js                                                   | Local AI model to evaluate emotion, intensity, etc. |
| **Authentication**      | Magic Link / Web3Auth                                                       | Email login + embedded wallet generation            |
| **Blockchain Layer**    | TBD *(Solana likely)*                                                       | Used for rewards, point-to-token conversion         |
| **Wallet Provider**     | Phantom (if Solana) / embedded via AA                                       | Users auto-get wallets at login                     |
| **Backend (Optional)**  | Serverless Functions (Vercel / Cloudflare Workers)                          | Only for lightweight metadata & scoring logic       |
| **Database**            | Minimal — only score, timestamp, and wallet address saved (no audio/images) |                                                     |
| **Reward Distribution** | Smart contract (Solana program / EVM contract)                              | Converts ANGRY Points → $YELL tokens                |

***

#### 🔐 Privacy-First Design

* **No voice files stored**
* **No image uploads or media storage**
* **All heavy processing happens locally or in-memory**
* **Only store:**
  * Wallet address
  * Score metadata
  * Timestamps / daily cap tracking

This ensures minimal backend costs and zero sensitive data retention.

***

#### 🛠️ Modular Architecture Diagram

```plaintext
[User Device / Browser]
   │
   ├──> Voice Input (Mic)
   │     └── Web Audio API → AI Analysis (local)
   │
   ├──> UI Interaction (React)
   │
   └──> Auth + Wallet → Magic / Web3Auth
         └── Embedded Wallet Generated
             └── Connected to Blockchain (TBD: Solana?)
                  
[Serverless Backend (Optional)]
   ├── Score Validation
   ├── Daily Limit Checks
   └── Reward Trigger

[Blockchain Layer]
   └── Smart Contract
         ├── Point Tracking (Merkle proofs or off-chain tallying)
         └── $YELL Token Distribution
```

***

#### 🔄 Blockchain Compatibility Options

| Option                 | Pros                           | Cons                   |
| ---------------------- | ------------------------------ | ---------------------- |
| **Solana**             | Fast, cheap, growing dev tools | Less EVM compatibility |
| **Polygon / Optimism** | EVM, easier for token launches | Slightly higher fees   |
| **Base**               | Native to Coinbase ecosystem   | Newer, evolving infra  |

*The architecture allows flexible integration with any chain that supports smart contracts, token distribution, and lightweight interaction from embedded wallets.*

<figure><img src="https://3577417867-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FN3evvfK4PHyW7kuXt4Fi%2Fuploads%2FSHAJWlEQ0dXA301lLxoA%2Fvsoual.png?alt=media&amp;token=8819f5bf-b2be-43a0-a586-c2d7f999cfd1" alt=""><figcaption></figcaption></figure>