Quick Index by Stage
| Stage | See |
|---|---|
| Idea | Idea & Intent |
| Intent | Idea & Intent |
| Platform | Platform |
| Payment | Payment (Solana), Payment (Dodo), Payment (General) |
| Execution | Execution |
| Download & GitHub | Download & GitHub |
| Setup & config | Setup & configuration |
Common Issues
Idea & Intent
| Issue | What’s going on |
|---|---|
| Idea returns no analysis or questions | AI key missing or wrong; model/env misconfigured; or API/network error |
| “Idea is required” | Idea field was empty or not sent |
| Stuck on Intent; no refined requirements | Answers not sent, sessionId missing, or workflow/idea not found |
| “Workflow context not found” / “Idea is required. Please start from the idea stage” | Wrong or expired sessionId; DB/store lost the workflow; or you skipped Idea |
| “Answers are required” | No answers array or all empty |
Platform
| Issue | What’s going on |
|---|---|
No platform options on /platform | Intent not completed; /api/platform or refined requirements missing |
| “Workflow session not found. Please start from the beginning” | sessionId unknown or workflow never created |
| “Refined requirements not found. Please complete the intent stage first.” | Intent step not done or not saved |
| “Workflow context not found” / “Failed to save platform selection” | DB or in-memory update failed |
| “Selected platform is required” | Platform not chosen or not sent |
Payment (Solana)
| Issue | What’s going on |
|---|---|
| Insufficient funds | Not enough SOL or $SCRIPT for transfer + fees |
| Use wallet connect button in header | Wallet not connected |
| Balance fetch timed out / RPC error | RPC misconfigured or down |
| Wrong network | Wallet and app network mismatch |
| Wallet doesn’t open | Wallet locked or blocked |
| Invalid agent address | TREASURY_WALLET missing or invalid |
| Tx succeeds but workflow fails | On-chain OK; DB update failed |
Payment (Dodo)
| Issue | What’s going on |
|---|---|
| Failed to create checkout session | Dodo API key or product setup wrong |
| Redirect fails | Redirect blocked or URL issue |
| Verifying payment stuck | Confirm-payment failing |
| Verification failed | Workflow update failed |
| Paid but Execution blocked | Webhook or confirm-payment failed |
Payment (General)
| Issue | What’s going on |
|---|---|
| No Active Session | /payment opened without sessionId |
| Workflow context not found | Platform not completed |
| Wallet public key required | Solana payment missing wallet key |
| Payment ok, redirect fails | Workflow not updated |
Execution
| Issue | What’s going on |
|---|---|
| Workflow context not found | Platform/payment not saved |
| Selected platform required | Platform missing |
| Refined requirements not found | Intent not completed |
| Invalid transaction signature | Solana verification failed |
| Agents disabled by admin | Agents turned off |
| Execution never finishes | API/AI slow or failing |
| Review failed / no ZIP | ReviewAgent blocked delivery |
Download & GitHub
| Issue | What’s going on |
|---|---|
| Project not found | Generate not run |
| Project directory empty | Files not written |
| Failed to download ZIP | Server or network error |
| GitHub not connected | OAuth not completed |
| Project files not found | Server path mismatch |
| No files to upload | Empty project directory |
| Failed to create repository | Repo exists or missing scope |
| GitHub OAuth not configured | OAuth env vars missing |
Setup & configuration
| Issue | What’s going on |
|---|---|
| DB errors | Wrong DATABASE_URL or migrations |
| No AI reply | AI keys missing or invalid |
| Build fails | Prisma or Node issues |
| Payment/RPC broken | Env vars missing |
Error Messages
By message (or pattern)
| Message | Where | Cause |
|---|---|---|
| Idea is required | /api/idea | Missing idea |
| Session ID is required | APIs | Missing sessionId |
| Answers are required | /api/intent | Empty answers |
| Workflow context not found | Multiple | Invalid session |
| Refined requirements not found | /api/platform | Intent not saved |
| Selected platform is required | platform/payment | Platform missing |
| Wallet public key required | /api/payment | Solana wallet missing |
| Invalid transaction signature | /api/execute | Tx verify failed |
| Agents disabled by admin | /api/execute | Agents off |
| Execution result not found | /api/projects/generate | Execute not run |
| Project not found | /api/projects/download | ZIP missing |
| GitHub not connected | /api/github/upload | OAuth missing |
| Payment service config error | Dodo | API key missing |
| GitHub OAuth not configured | OAuth | Env missing |
HTTP status codes
| Code | Meaning |
|---|---|
| 400 | Bad request |
| 401 | Unauthorized |
| 404 | Not found |
| 405 | Method not allowed |
| 500 | Server error |
| 503 | Service unavailable |
Solutions
Idea & Intent
- Check AI keys and model
- Restart from Idea if session lost
- Ensure answers array is complete
Platform
- Complete Intent first
- Retry platform selection
- Restart from Idea if session expired
Payment (Solana)
- Add funds
- Match network
- Connect wallet via header
- Contact support with tx signature if DB update failed
Payment (Dodo)
- Verify Dodo config
- Ensure success URL has
sessionIdandplatform - Contact support with receipt if verification fails
Execution
- Ensure Intent and Platform saved
- Use correct redirect URL
- Contact support if agents disabled or execution hangs
Download & GitHub
- Ensure Review passed and ZIP generated
- Connect GitHub before upload
- Retry or contact support if files missing
Setup & configuration
- Verify
DATABASE_URLand migrations - Set AI keys and model
- Run prisma generate and build again
Getting Help
What to include
sessionId- Stage
- Steps taken
- Exact error
- Proof of payment (if any)
Support tickets
Create viaPOST /api/support/tickets with:
sessionIdmessageuserWallet(optional)priority(optional)
Contact
- scriptonia.xyz
- Docs: Overview, Installation, Workflow Guide, Payment Guide, Execution Process, Project Delivery
Finding your sessionId
- In the URL
- On Execution page
- Payment success page
- Local storage (if used)