From c1d75b80e47bb1a38380d65164dceb30773a808f Mon Sep 17 00:00:00 2001
From: SimplyRayYZL <116981513+SimplyRayYZL@users.noreply.github.com>
Date: Wed, 13 May 2026 11:48:05 +0300
Subject: [PATCH 1/2] docs: add quick start to README

---
 README.md | 9 +++++++++
 1 file changed, 9 insertions(+)

diff --git a/README.md b/README.md
index 2bea737..1d4174a 100644
--- a/README.md
+++ b/README.md
@@ -37,6 +37,15 @@ MVP in progress. Current focus: Phase 1 (Core MVP on Solana).
 - [ ] Agents: x402 + MCP server + agent wallets
 - [ ] Base as second chain (Phase 2)
 
+## Quick Start
+
+```bash
+pnpm install
+pnpm --filter frontend dev
+```
+
+The frontend starts on `http://localhost:3000` by default. Copy any needed environment values from the package-specific `.env.example` files before running services that talk to wallets, Supabase, or the relayer.
+
 ## Stack
 
 - **Frontend:** Next.js + Vercel, RainbowKit (EVM) + wallet-adapter (Solana)

From 7051407dbbcb2696c073167788d975b83e4768f6 Mon Sep 17 00:00:00 2001
From: SimplyRayYZL <116981513+SimplyRayYZL@users.noreply.github.com>
Date: Wed, 20 May 2026 21:18:58 +0300
Subject: [PATCH 2/2] docs: complete quick start acceptance criteria

---
 README.md | 13 +++++++++++--
 1 file changed, 11 insertions(+), 2 deletions(-)

diff --git a/README.md b/README.md
index 1d4174a..68dfc57 100644
--- a/README.md
+++ b/README.md
@@ -39,12 +39,21 @@ MVP in progress. Current focus: Phase 1 (Core MVP on Solana).
 
 ## Quick Start
 
+Prerequisites:
+
+- Node 24+
+- pnpm 10+
+- Solana CLI
+
+Run the final command from `frontend/`.
+
 ```bash
 pnpm install
-pnpm --filter frontend dev
+cp frontend/.env.example frontend/.env.local
+pnpm dev
 ```
 
-The frontend starts on `http://localhost:3000` by default. Copy any needed environment values from the package-specific `.env.example` files before running services that talk to wallets, Supabase, or the relayer.
+The frontend starts on `http://localhost:3000` by default.
 
 ## Stack