add full-stack development setup guide

[Chigybillionz]

closes #366

Summary

This PR adds a new root-level DEVELOPMENT_SETUP.md guide that walks contributors through the full local setup for Agora from zero to a running full-stack environment.

The guide covers:

• Prerequisites for Node/pnpm, Rust/Cargo, Docker, sqlx-cli, and Soroban CLI
• Starting PostgreSQL with Docker
• Running backend migrations and starting the Axum server
• Starting the Next.js frontend
• Running local contract tests
• A master list of env example files that need attention
• Health verification steps for confirming the system is running correctly

What Changed

• Added DEVELOPMENT_SETUP.md at the repository root
• Linked contributors to the existing README files for deeper dives into:
  • apps/web
  • server
  • contract

Why

This creates a single, definitive onboarding guide for first-time contributors who need to get the entire local stack running without jumping between multiple docs.

Verification

Verified the document covers:

• apps/web
• server
• contract

And includes:

• setup prerequisites
• step-by-step execution order
• env file guidance
• health endpoint checks

Closes #366

[vercel]

@Chigybillionz is attempting to deploy a commit to the oseh-svg's projects Team on Vercel.

A member of the Team first needs to authorize it.

[drips-wave]

@Chigybillionz Great news! 🎉 Based on an automated assessment of this PR, the linked Wave issue(s) no longer count against your application limits.

You can now already apply to more issues while waiting for a review of this PR. Keep up the great work! 🚀

Learn more about application limits

[vercel]

The latest updates on your projects. Learn more about Vercel for GitHub.

Project	Deployment	Actions	Updated (UTC)
agora-web	Ready	Preview, Comment	Mar 30, 2026 0:03am