> ## Documentation Index
> Fetch the complete documentation index at: https://docs.scriptonia.xyz/llms.txt
> Use this file to discover all available pages before exploring further.

# Frequently Asked Questions

> Common questions, concerns, and answers.

## 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.
