Skip to main content

​
General

What is Scriptonia? Scriptonia turns a short idea into a full project blueprint: PRD, PLAN, frontend/backend/infra specs, and LLM prompts. You go through Idea → Intent → Platform → Payment → Execution → Completion and get a ZIP (and optional GitHub repo). How much does it cost? One unified price per project: 0.02 SOL (or about $4 USD with Dodo). It’s the same for Website, Web Application, Android, and iOS. How long does a run take? Roughly: Website ~45 s, Web Application ~75 s, Android / iOS ~100 s. It can vary with AI and load. Can I use Scriptonia for a DApp or smart contracts? For DApp UIs and backend: choose Web Application (or Website/Android/iOS) and describe chain, wallet, and on-chain flows in your Idea and Intent. Scriptonia does not generate smart contract source. You get specs and integration points; you (or tools like ChainGPT) write and audit contracts.

​
Workflow and usage

Do I need to finish each stage in one go? No. The sessionId from Idea links all steps. You can stop after Intent or Platform and continue later as long as the workflow (DB or in-memory) is still there. I lost my sessionId. Can I recover? If you didn’t save it, you can’t. Restart from Idea. For important runs, store sessionId (e.g. in the completion or download URL). Can I change platform after Platform selection? You’d need to run Platform again with a new choice. The current flow doesn’t support “swap platform” in place; use a new run if needed. Why do I get “Workflow context not found”? Usually: wrong or expired sessionId, or the workflow was never created (e.g. Idea failed or DB was cleared). Start from Idea and keep the same sessionId for Intent → Platform → Payment → Execute. What if I only want a PRD, not a full blueprint? The platform templates always produce PRD, PLAN, and more. To get “only PRD,” use the full run and ignore the rest, or extend the app to add a “PRD-only” mode.

​
Payment

Which payment methods are supported?
  • Solana: Phantom (or other Solana wallets via AppKit). You pay in SOL (placeholder mode).
  • Dodo: Card or UPI. You’re redirected to Dodo and return to the success page; the webhook (or confirm-payment) updates the workflow.
Why “Insufficient funds” when I have SOL? In SOL placeholder mode the UI expects a fixed 0.02 SOL. Ensure:
  1. Correct network (devnet vs mainnet)
  2. Enough balance for the required amount plus fees
I paid with Dodo but Execute says payment required. The workflow may not be updated yet. The Dodo webhook (or confirm-payment) sets paymentMethod: 'dodo' and dodoPaymentId. Check: webhook URL and DODO_WEBHOOK_SECRET, sessionId and platform in return_url and metadata. On the success page, the app can call confirm-payment as a fallback. Can I get a refund? Refunds are handled by the payment provider (Solana: your own process; Dodo: via Dodo’s dashboard and refund webhooks). Scriptonia does not automate refunds.

​
Execution and output

What do I actually get? A ZIP with: README, PRD, PLAN, frontend/backend/db/infra specs, LLM prompts, and meta files. Exact layout depends on the platform. Is the generated code runnable? The outputs are specs and prompts, not a full runnable app. You use the prompts and specs to generate and wire up code. The goal is a production-ready blueprint. Execution is slow or times out. Causes include many files, slow AI/network, or DB/API issues. Check server logs. For very long runs, consider moving Execute to a background job. “The following agents are currently disabled by admin.” An admin has disabled one or more execution agents. Re-enable them via admin tools or contact the operator.

​
GitHub and download

How does GitHub upload work? You connect via OAuth. After execution, Upload creates a new repo and pushes files from projects/{sessionId}. Requires GitHub OAuth credentials. “Project files not found” or “No files to upload.” Upload reads from projects/{sessionId} under the app’s working directory. If only a ZIP exists in the DB, extract it first or adjust upload logic. Download gives “Project not found” or “Please generate files first.” Download uses the stored ZIP first, then projects/{sessionId}. If both are missing, this appears. Ensure execution completed successfully.

​
Setup and configuration

What do I need to run Scriptonia? At least:
  • Node.js 18+
  • PostgreSQL
  • DATABASE_URL
  • One OpenRouter API key
For Payment: Solana or Dodo For GitHub: OAuth credentials Can I use OpenAI instead of OpenRouter? The codebase is built around OpenRouter. Using OpenAI directly would require changes; it’s not configured by default. How do I switch AI models? Set DEFAULT_MODEL to GROK, QWEN, or GEMINI and ensure the matching OpenRouter key is set. Some flows may still call a specific model in code. Is there an API for integrations? Yes. Idea, Intent, Platform, Payment, Execute, and others are HTTP APIs. There is no API key auth on workflow endpoints by default.

​
Getting help

Where do I report bugs or ask for help? Use the project’s issue tracker, community chat, or support channel if documented. Include sessionId and the step where it failed when reporting issues.