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

# Newly v2 FAQ

> Short answers to the most common questions about Newly v2, with links to the full pages.

Short answers about Newly v2, at app.newly.app and in Newly for Mac. Each answer links to the page with the details. For error messages, see [Messages explained](/help/messages).

## Credits and billing

<AccordionGroup>
  <Accordion title="Is Newly v2 free?">
    No. There's no free plan, and a new account starts with 0 credits. You can't create a project or run a Newly Agent prompt at 0 credits unless Newly gives you credits or a gift plan. If Newly sent you a gift link, it gives you one free month of the \$25 plan.

    See [Plans and top-ups](/billing/plans-and-top-ups).
  </Accordion>

  <Accordion title="Is one message one credit?">
    No. Credits follow the work the agent does, not the number of messages you send. A quick question can use a fraction of a credit. A first build or a long fix can use many more.

    See [How credits work](/billing/how-credits-work).
  </Accordion>

  <Accordion title="Why did one message use so many credits?">
    Every step the agent takes to answer uses credits: reading your project, writing code, building and checking the app. Big requests, large projects, long conversations, attached images and repeated build-and-fix loops all cost more. Automatic fix turns after a failed build or crash use credits too.

    To spend less, ask for one change at a time, be specific, and press **Stop** if a turn heads the wrong way. See [How credits work](/billing/how-credits-work) and [Prompting tips](/build/prompting-tips).
  </Accordion>

  <Accordion title="Are Ask and Plan cheaper than Build?">
    They're charged the same way as **Build**, by the work done. They often cost less only because the agent does less. In Remote chats, Plan and Ask can read your project but can't change files or build.

    See [Build, Plan, Ask and Design](/build/modes).
  </Accordion>

  <Accordion title="Do previews, builds or TestFlight uploads use credits?">
    Not today. Previews, cloud simulators, the Web view, native builds, TestFlight uploads, Newly Backend hosting, **Restore to here** and **Undo** don't draw down credits. What uses credits is the agent's work and the requests your app makes to AI models.

    You still need a positive balance to create a project or a Newly Backend. See [How credits work](/billing/how-credits-work).
  </Accordion>

  <Accordion title="Do unused credits roll over?">
    It depends on where they came from. Plan credits expire at the end of each allowance month. Top-ups last 12 months. Credits from Newly never expire, but a plan granted by Newly works like any plan, so its credits expire monthly. Newly spends plan credits first, then top-ups, then credits from Newly.

    See [Plans and top-ups](/billing/plans-and-top-ups).
  </Accordion>

  <Accordion title="Can I set a spending limit?">
    No, there's no setting to cap spending. Keep an eye on your balance in the account footer or in **Billing**. If your app uses AI models, remember that your app's users spend your credits too.

    See [Running out of credits](/billing/out-of-credits).
  </Accordion>

  <Accordion title="What happens when I run out of credits?">
    The agent stops and you see "You’re out of credits, so this run stopped here. Everything so far is saved." Add credits with **Buy more credits →**, then send another message in the same chat.

    See [Running out of credits](/billing/out-of-credits).
  </Accordion>

  <Accordion title="Can I get a refund?">
    There's no refund button in the app. If you have a question about a charge, contact support with the date and amount.

    See [Getting help](/help/getting-help).
  </Accordion>

  <Accordion title="How do I cancel my plan?">
    Only an organization owner or admin can cancel. Open the account menu at the bottom of the sidebar, select **Billing**, scroll to **Subscription** and select **Cancel subscription**, then confirm. Your plan stays active until the end of the period you paid for, and top-ups stay usable. If Newly gave you your plan, contact support to change it.

    See [Change, cancel or manage your plan](/billing/manage-your-plan).
  </Accordion>

  <Accordion title="I'm paying for Newly v1 and Newly v2. Is that right?">
    Newly v1 and Newly v2 are separate products with separate accounts and subscriptions, even with the same email. If you pay for both, you'll see two separate charges. Cancel each one in its own product.

    See [Which Newly am I using?](/get-started/which-newly) and [Change, cancel or manage your plan](/billing/manage-your-plan).
  </Accordion>
</AccordionGroup>

## Newly v1 and Newly v2

<AccordionGroup>
  <Accordion title="Where are my Newly v1 projects?">
    If you built projects in Newly v1 (legacy), they're still in Newly v1, at newly.app. Newly v1 and v2 are separate. Your v1 projects, credits and subscription stay in v1, and there's no way to move them into v2 today.

    See [Which Newly am I using?](/get-started/which-newly).
  </Accordion>

  <Accordion title="Do I need to install anything?">
    No. The web app at app.newly.app works in your browser. Newly for Mac adds Local chats and lets you use your own Claude or Codex login. It needs a Mac with Apple silicon and macOS 14 or later.

    See [The web app and Newly for Mac](/get-started/web-and-mac).
  </Accordion>

  <Accordion title="Is there a Newly phone app?">
    There's no Newly phone app to download. Use the web app or Newly for Mac to build. To try your own app on an iPhone, use TestFlight.

    See [Testing on a real phone](/preview/test-on-a-phone).
  </Accordion>
</AccordionGroup>

## Building and previewing

<AccordionGroup>
  <Accordion title="How do I put my app on my phone?">
    On iPhone, ask the agent in a Remote chat to publish your app to TestFlight, then install it with Apple's TestFlight app. You need an Apple Developer Program membership, and only an organization owner or admin can connect Apple and publish.

    Newly v2 doesn't produce Android builds you can install on a phone. Test Android on the cloud Android simulator. See [Testing on a real phone](/preview/test-on-a-phone).
  </Accordion>

  <Accordion title="Can I use Expo Go or a QR code?">
    No. Newly v2 has no QR code and no Expo Go link. Your app runs as a real build of your app on cloud simulators, so there's nothing to install.

    See [Previewing your app](/preview/overview).
  </Accordion>

  <Accordion title="Can I publish to Google Play or download an APK?">
    No. Newly v2 doesn't produce Android release builds (APK or AAB), and it doesn't upload to Google Play. If the agent says Android publishing is available somewhere in Newly, it isn't.

    See [From TestFlight to the App Store](/publish/app-store-and-google-play).
  </Accordion>

  <Accordion title="Which AI model does Newly use?">
    Newly chooses the model behind Newly Agent and may change it. There's no model picker in Remote chats. The **AI models** item in the **+** menu is for AI features in your app, not for the agent that builds it.

    See [Chatting with the agent](/build/chatting-with-the-agent).
  </Accordion>

  <Accordion title="Can I use my Claude or Codex subscription?">
    Yes, in Local chats in Newly for Mac. Connect your own Claude or Codex login and those chats don't use Newly credits. The web app and Remote chats always use Newly Agent.

    See [Local chats on your Mac](/mac/local-chats).
  </Accordion>

  <Accordion title="What happens if I close the tab while the agent works?">
    In a Remote chat, the agent keeps working. Come back later and the results are there. A Local chat in the Mac app stops when the app closes or your Mac stops, and the reply is marked "Interrupted - your work is saved".

    See [Chatting with the agent](/build/chatting-with-the-agent).
  </Accordion>

  <Accordion title="Why does my chat say Parked?">
    A Remote chat parks after it has been idle, by default for about 15 minutes. It doesn't park while a turn or native build is running. Your code is kept. Send a message to continue.

    See [Parked chats and limits](/build/sleep-and-limits).
  </Accordion>
</AccordionGroup>

## Code, sharing and integrations

<AccordionGroup>
  <Accordion title="Can I download my code?">
    Yes, with the newly CLI. Install it with `npm i -g @newly/cli`, sign in with `newly login`, then run `newly pull <project-id>`. There's no download button in the app.

    See [Get your code](/code/get-your-code).
  </Accordion>

  <Accordion title="Does my project sync to GitHub?">
    No. Newly keeps your project's code in a private repository it hosts, and Newly v2 projects don't sync to GitHub. Use the newly CLI to download your code.

    See [Get your code](/code/get-your-code).
  </Accordion>

  <Accordion title="Can teammates build in my project, and who pays?">
    Yes. If you own the project or have **Admin** access, select the share icon at the top of the sidebar and add people as **Admin**, **Can edit** or **Can view**. They need a Newly v2 account first. Every turn in your project uses credits from the project owner's organization, whoever sends the message.

    See [Share a project](/code/sharing-projects).
  </Accordion>

  <Accordion title="Where do I put my app's API keys?">
    Never paste secrets into the chat. For your dev backend, set them with the newly CLI, for example `newly secrets set KEY VALUE --service api`, then run `newly deploy --env dev`. Always pass `--service api` or `--service auth`. For production secrets, contact support.

    See [Production and secrets](/backend/production-and-secrets).
  </Accordion>

  <Accordion title="Does Newly support Supabase, RevenueCat or OneSignal?">
    Newly v2 doesn't connect to Supabase, Firebase or other backend providers. When your app needs a backend, the agent adds Newly Backend. For push notifications, the agent can set up OneSignal with your own OneSignal account. There's no built-in RevenueCat or payments connection, so tell the agent what you want to charge for.

    See [Integrations](/backend/integrations).
  </Accordion>
</AccordionGroup>

## Account

<AccordionGroup>
  <Accordion title="How do I delete my account?">
    Contact support to delete your Newly v2 account. Cancel your plan first, because deleting your account doesn't cancel it.

    See [Delete a chat, project or account](/account/delete).
  </Accordion>

  <Accordion title="How do I sign in?">
    With your email and a one-time code, or with Google or GitHub. There are no passwords. Use the same account in the web app and the Mac app.

    See [Sign up and sign in](/get-started/sign-in).
  </Accordion>
</AccordionGroup>