[DevOps] One-Click Local Mock Development Sandbox & Seed Environment

[blurbeast]

Overview & Background

Onboarding new open-source contributors can be hindered by complex local setups involving Postgres, Redis, and live Stellar Testnet RPCs. A one-click mock development sandbox allows contributors to spin up the entire stack with realistic seed data in seconds.

---

Technical Specification & Architecture

1. Mock Seed Data Generator (scripts/seed-mock-data.ts):
   • Seed 20 diverse streams (Active, Paused, Completed, Cancelled, Vesting Cliffs) across 5 mock users.
   • Seed mock stream event histories with timestamps spanning the last 30 days.
2. Single Startup Script (npm run dev:mock):
   • Launches Postgres and Redis via Docker Compose.
   • Runs Prisma migrations and seeds mock dataset.
   • Boots backend in sandbox mode with mock Soroban RPC.
   • Starts frontend on localhost:3000.

---

Target Files

• scripts/seed-mock-data.ts
• package.json
• docs/DEVELOPMENT.md

---

Acceptance Criteria

• Running npm run dev:mock starts the full local stack with rich prefilled demo streams.
• Contributor can test all UI features without needing a live wallet or testnet funding.
• Step-by-step documentation updated in docs/DEVELOPMENT.md.

[gracepeterfejokwu]

Hi Maintainer,
I would like to contribute to this project.
I have experience working with JavaScript, Python, C++, and Rust, with a primary focus on frontend development using React, Next.js, and TypeScript.
I am committed to continuous learning and am excited about contributing to the GrantFox ecosystem.
Thank you