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

# General FAQ

> Common questions about Voxcode — the voice-first AI coding assistant.

<AccordionGroup>
  <Accordion title="What is Voxcode and who is it for?">
    Voxcode is a voice-first AI coding assistant that lets you build, edit, and preview web applications using natural voice commands — no keyboard required. You speak your intent, and Voxcode generates code in real time with a live preview.

    Voxcode is built for:

    * **Mobile developers** who want to code on the go without a physical keyboard
    * **Rapid prototypers** who think faster than they type
    * **Developers of all skill levels** who want an AI pair-programmer they can talk to

    You can also use text input if you prefer, so Voxcode works equally well on desktop.
  </Accordion>

  <Accordion title="Does Voxcode work on mobile?">
    Yes. Voxcode is designed mobile-first. The interface uses large tap targets, swipe gestures, and a responsive layout optimized for phones and tablets.

    On mobile, you can swipe right to open your conversation history and swipe left to open the file explorer. Voice mode works hands-free: after you tap the microphone once, Voxcode keeps listening and automatically picks up your next command after each AI response — no need to tap again between turns.

    Voxcode is also installable as a PWA (Progressive Web App), so you can add it to your home screen and launch it like a native app.
  </Accordion>

  <Accordion title="What AI models does Voxcode support?">
    Voxcode connects to 15+ AI models via OpenRouter, organized into three tiers:

    * **Free models** — Zero credit cost. Includes Gemini 2.5 Flash, Claude Haiku 4.5, Qwen 3 Coder Plus, OpenAI o4 Mini High, and more.
    * **Beta models** — Experimental and cutting-edge. Includes Grok 4.1 Fast, GPT 5.1 Codex Mini, MiMo-V2-Flash (free), and others.
    * **Premium models** — Most powerful. Includes Claude Sonnet 4.5, Claude Opus 4.5, Gemini 2.5 Pro, GPT 5.1 Codex, and Grok 3.

    You can switch models at any time in the settings menu. If you have a Premium plan, you can also bring your own API key (BYOK) and use any model without consuming Voxcode credits.
  </Accordion>

  <Accordion title="Is my code saved? Where is it stored?">
    Your code is saved automatically in your browser's `localStorage` via Voxcode's Virtual File System (VFS). Every file the AI generates — HTML, CSS, JavaScript, TypeScript, React components — is written to the VFS instantly and persists between sessions on the same device and browser.

    Your conversation history and account data are stored securely in Voxcode's database. The VFS is local to your browser, so clearing your browser data will remove your project files. Use the export feature to download your code before clearing storage.

    <Note>
      GitHub sync (push/pull from repositories) is coming soon. Check the roadmap for updates.
    </Note>
  </Accordion>

  <Accordion title="Do I need an API key to use Voxcode?">
    No. On the Free, Starter, and Premium plans, Voxcode handles all API access for you — you just sign in and start coding. Credits are deducted automatically based on the model you use.

    If you are on the **Premium plan**, you have the option to bring your own API key (BYOK) from OpenRouter or another supported provider. When you use your own key, requests go directly to your provider and do not consume any Voxcode credits.
  </Accordion>

  <Accordion title="What happens if I run out of credits?">
    When your credit balance reaches zero, you will no longer be able to send requests to paid models. You can still use **Free models** (marked with `!` in the model selector), which cost zero credits regardless of your plan.

    To continue using paid models, you can:

    * **Top up credits** — Purchase a credit pack (40, 100, 200, or 420 credits) at any time. Top-up credits never expire.
    * **Upgrade your plan** — Move to Starter ($7/month) or Premium ($15/month) for a larger monthly credit allowance.
    * **Use BYOK** — On the Premium plan, add your own API key to bypass the credit system entirely.

    Your monthly subscription credits reset each billing cycle. Unused subscription credits do not roll over, but purchased top-up credits do.
  </Accordion>

  <Accordion title="Can I export or download my code?">
    Yes. You can download any file or your entire project from the file explorer. Individual code blocks in the chat also have a copy button so you can grab specific snippets instantly.

    Export your project before clearing browser storage or switching devices, since the VFS lives in your browser's `localStorage`.
  </Accordion>

  <Accordion title="Does Voxcode work offline?">
    Partially. The Virtual File System (VFS) is stored in your browser and remains accessible offline — you can view and browse your existing files without an internet connection.

    However, AI code generation, voice transcription (Whisper), and voice synthesis (ElevenLabs) all require an active internet connection. Offline AI generation is not currently supported.
  </Accordion>

  <Accordion title="What browsers does Voxcode support?">
    Voxcode works best in modern Chromium-based browsers:

    * **Google Chrome** (recommended)
    * **Microsoft Edge**
    * **Brave**

    Firefox and Safari have limited support for the Web Speech API used for voice input. If you experience issues with voice recognition on those browsers, Voxcode falls back to Whisper-based transcription where possible, but Chrome is recommended for the most reliable voice experience.

    For the WebContainer preview (Node.js projects), you need a browser that supports SharedArrayBuffer, which requires a secure context (HTTPS).
  </Accordion>

  <Accordion title="Is there a free plan? What's included?">
    Yes. The Free plan gives you **20 credits** to start and access to all Free-tier models (marked `!`), which cost zero credits per request. Free models include Gemini 2.5 Flash, Claude Haiku 4.5, Qwen 3 Coder Plus, and more — capable models that handle most coding tasks well.

    If you need access to more powerful models or more credits, you can upgrade:

    | Plan    | Price      | Credits/month | Models                  |
    | ------- | ---------- | ------------- | ----------------------- |
    | Free    | \$0        | 20 (one-time) | Free models             |
    | Starter | \$7/month  | 100           | Free + Beta + 2 Premium |
    | Premium | \$15/month | 250           | All models + BYOK       |

    You can also purchase credit top-ups at any time on any plan.
  </Accordion>

  <Accordion title="What languages and frameworks can Voxcode generate?">
    Voxcode can generate code in any language or framework the underlying AI models support. Common use cases include:

    * **HTML, CSS, JavaScript** — Static sites, landing pages, portfolios
    * **React / JSX / TSX** — Component libraries, full React apps
    * **TypeScript** — Typed components and utilities
    * **Node.js** — Server-side scripts, Express apps, API routes
    * **Vue, Svelte** — With appropriate preview setup
    * **Python, SQL, Bash** — For scripting and data tasks (text output, no live preview)

    The live preview system auto-detects your project type: static HTML/CSS renders in an iframe, React projects run in Sandpack, and Node.js projects boot in a WebContainer.
  </Accordion>

  <Accordion title="How do I give feedback or report a bug?">
    You can reach the Voxcode team at **[support@voxcode.app](mailto:support@voxcode.app)**. When reporting a bug, it helps to include:

    * A description of what you expected to happen
    * A description of what actually happened
    * The browser and device you were using
    * Any error messages visible in the chat or browser console

    For feature requests and general discussion, you can also open an issue or start a thread on the Voxcode GitHub repository.
  </Accordion>
</AccordionGroup>