Engineering Gap
No .env.example files found for backend, frontend, mobile, or onchain services. Environment variables documented only in code comments and service READMEs. 50+ env vars used across services with no centralized configuration reference.
Codebase Evidence
- No
.env.example in app/backend/, app/frontend/, app/mobile/, app/onchain/
app/backend/src/main.ts lines 21-26: searches for .env in 3 locations at startup
app/frontend/src/lib/env.ts: 10+ NEXT_PUBLIC_* vars without example file
app/mobile/src/config/index.ts: 8 EXPO_PUBLIC_* vars without example
app/ai-service/config.py: Settings class with env vars but no example file
Risk Profile
Current Risk
Onboarding friction — developers guess at required env vars. Production misconfiguration from missing documentation.
Business Impact
Slower developer onboarding. Production incidents from missing env vars. Non-reproducible builds.
Remediation Strategy
Create .env.example in each service with all required/supported vars, sensible defaults, and descriptions. Reference in each README.
Success Conditions
Change Surface
New files: 4 .env.example files across services
Security Review
No secrets in example files — use placeholder values only. No security impact.
Completion Checklist
Engineering Gap
No .env.example files found for backend, frontend, mobile, or onchain services. Environment variables documented only in code comments and service READMEs. 50+ env vars used across services with no centralized configuration reference.
Codebase Evidence
.env.exampleinapp/backend/,app/frontend/,app/mobile/,app/onchain/app/backend/src/main.tslines 21-26: searches for .env in 3 locations at startupapp/frontend/src/lib/env.ts: 10+ NEXT_PUBLIC_* vars without example fileapp/mobile/src/config/index.ts: 8 EXPO_PUBLIC_* vars without exampleapp/ai-service/config.py: Settings class with env vars but no example fileRisk Profile
Current Risk
Onboarding friction — developers guess at required env vars. Production misconfiguration from missing documentation.
Business Impact
Slower developer onboarding. Production incidents from missing env vars. Non-reproducible builds.
Remediation Strategy
Create
.env.examplein each service with all required/supported vars, sensible defaults, and descriptions. Reference in each README.Success Conditions
app/backend/.env.examplewith all vars documentedapp/frontend/.env.examplewith NEXT_PUBLIC_* documentedapp/mobile/.env.examplewith EXPO_PUBLIC_* documentedapp/onchain/.env.examplewith contract/network configChange Surface
New files: 4
.env.examplefiles across servicesSecurity Review
No secrets in example files — use placeholder values only. No security impact.
Completion Checklist