Document local setup, required environment variables, and the Stellar wallet auth flow for contributors

[3m1n3nc3]

Description

Now that authentication runs through SEP-10 + Freighter, there is no single document explaining how a new contributor configures and runs the project on their own machine. Several required environment variables are referenced across the code but absent from app/.env.example (e.g. STELLAR_SERVER_SECRET, STELLAR_NETWORK, STELLAR_HORIZON_URL, STELLAR_HOME_DOMAIN, NEXTAUTH_SECRET, CRON_SECRET). Without STELLAR_SERVER_SECRET, SEP-10 fails fast at runtime with no guidance, and a misconfigured STELLAR_NETWORK silently breaks login (see the network passphrase issue).

More info

• File: app/README.md, app/.env.example, README.md
• Document the full setup path: install (pnpm install), DB provisioning + pnpm prisma migrate dev, generating a Stellar server keypair for STELLAR_SERVER_SECRET, installing the Freighter browser extension, and which network (testnet vs public) to use for local dev.
• Enumerate every required env var with a one-line description and a safe example value; mark which are mandatory vs optional.
• Add a "How authentication works" section describing the challenge → sign → verify SEP-10 flow and how to test it locally.
• Cross-link to the SEP-10 spec and note the testnet caveat once the passphrase issue is resolved.

[amina69]

Application Proposal TemplateHi team,I would like to claim this issue. I am familiar with the Stellar ecosystem, SEP-10 authentication via Freighter, and configuring multi-network environments. I can create clear, thorough documentation to streamline local onboarding for new contributors.Proposed Solution:Complete .env.example: Audit and document all missing environment variables including STELLAR_SERVER_SECRET, STELLAR_NETWORK, STELLAR_HORIZON_URL, STELLAR_HOME_DOMAIN, NEXTAUTH_SECRET, and CRON_SECRET with safe defaults and clear annotations for mandatory vs. optional configurations.Step-by-Step Setup Path: Write explicit execution instructions covering package installation via pnpm, database initialization with Prisma migrations, server-side keypair generation instructions, and Freighter configuration.SEP-10 Flow Section: Document the local challenge-sign-verify authentication loop, cross-link it to the official SEP-10 specification, and explicitly flag the Testnet passphrase caveat to resolve developer runtime blocks.Review and Validation: Validate the newly created instructions against a fresh, sandboxed local clone of the repository to confirm zero-friction installation.Could you please assign this issue to me? Thank you!

[debbieAmoni]

@debbieAmoni has applied to work on this issue as part of the Stellar Wave Program's 6th wave.

hi maintainer please i would love to workon this issue i can work on it immediately

ℹ️ Repo Maintainers: To accept this application, review their application or assign @debbieAmoni to this issue.

[HassanKorey]

@HassanKorey has applied to work on this issue as part of the Stellar Wave Program's 6th wave.

Hi, maintainer. Kindly assign me this task.

ℹ️ Repo Maintainers: To accept this application, review their application or assign @HassanKorey to this issue.

[OTimileyin]

@OTimileyin has applied to work on this issue as part of the Stellar Wave Program's 6th wave.

Hi Maintainer, Kindly assign me this issue. Expect Pr today.

ℹ️ Repo Maintainers: To accept this application, review their application or assign @OTimileyin to this issue.

[exronnin]

@exronnin has applied to work on this issue as part of the Stellar Wave Program's 6th wave.

I would love to resolve this issue, I have experience building beautiful pixel perfect user interfaces.

ℹ️ Repo Maintainers: To accept this application, review their application or assign @exronnin to this issue.