Topology mismatch between `auth.http` port `4000`, `useGameStore` port `4001`, and README port `3001`

[mercy60]

Internal ID: #38

Imported from ISSUES.md via scripts/import-issues.mjs.

Problem Statement. Three sources of truth about the backend port:

1. backend/src/auth/auth.http declares @baseUrl = http://localhost:4000.
2. frontend/store/useGameStore.js hardcodes http://localhost:4001.
3. README.md says "API → localhost:3001".

This is incoherent. Contributors cannot tell which port to use.

Expected Outcome. One source: .env exposes PORT, BACKEND_URL, FRONTEND_URL. Apps read from env.

Acceptance Criteria.

• README, .http files, store all reference process.env.NEXT_PUBLIC_API_URL.

Implementation Notes.

• Add NEXT_PUBLIC_API_URL to frontend/.env.example.
• Replace localhost:4001 in useGameStore.js.

Files / modules affected.

• frontend/store/useGameStore.js
• frontend/store/reward/nft-reward-store.js
• backend/src/auth/auth.http
• README.md

Dependencies. None.

Difficulty / Effort. Easy / S (≈ 2 hours).

Labels. area:backend, area:frontend, developer-experience

[DavisVT]

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

i'm a developer well fit for implementing this task
Kindly assign them to me

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

[kike-alt]

@kike-alt has applied to work on this issue as part of the Stellar Wave Program's 7th wave.

Hi, I'd like to work on this issue.

I'm a full-stack developer with solid experience in modern JavaScript/TypeScript, REST APIs, and frontend frameworks like React. I enjoy working in open source and following existing project conventions.

I've looked into this issue closely and I'm confident in my ability to deliver a high-quality implementation here.

Looking forward to contributing — please assign this issue to me.

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

[drips-wave]

Congratulations, @kike-alt! 🎉 Your application was accepted by the repo's maintainers, and the issue is due on July 30, 2026.

🧑‍💻 @kike-alt: Please resolve the issue such that the repo's maintainers have enough time to review your contribution before the due date. You'll earn Points for completing the issue on-time, which will make you eligible for a share of the Stellar Wave Program's reward pool.

Warning

When opening a PR, please link it to this issue to ensure it gets tracked accurately. Points are awarded when this issue is marked as completed by the maintainer.

🤠 Repo maintainers: Please keep an eye on the contributor's progress and review their work before the due date. You can manage this issue, including adjusting its complexity and points, here.

🌊 Happy Wave 🌊

[drips-wave]

This issue has been completed by @kike-alt as part of the Stellar Wave Program's 7th Wave 🥳

😎 @kike-alt: You earned 200 Points for completing this issue! After the current Wave ends, you'll be eligible for a percentage of the Wave's reward pool based on the percentage of total points you've earned. Learn more here. You can also Leave a review to share your experience working on this issue.

🧑‍💻 Repo maintainers: How'd the contributor do? Leave a review to share your experience working with them.