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

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

Short answers about Newly (app.newly.app). Each answer links to the page with the details. For error messages, see [Messages explained](https://docs.newly.app/help/messages.md).

## Credits and billing

> [accordion] Is Newly 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](https://docs.newly.app/billing/plans-and-top-ups.md).

> [accordion] 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](https://docs.newly.app/billing/how-credits-work.md).

> [accordion] 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](https://docs.newly.app/billing/how-credits-work.md) and [Prompting tips](https://docs.newly.app/build/prompting-tips.md).

> [accordion] 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. Plan and Ask can read your project but can't change files or build.
>
> See [Build, Plan and Ask](https://docs.newly.app/build/modes.md).

> [accordion] Do previews, builds or TestFlight uploads use credits?
>
> Not today. Previews, cloud simulators, 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.
>
> You still need a positive balance to create a project or a Newly Backend. See [How credits work](https://docs.newly.app/billing/how-credits-work.md).

> [accordion] 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](https://docs.newly.app/billing/plans-and-top-ups.md).

> [accordion] 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**.
>
> See [Running out of credits](https://docs.newly.app/billing/out-of-credits.md).

> [accordion] 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](https://docs.newly.app/billing/out-of-credits.md).

> [accordion] 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](https://docs.newly.app/help/getting-help.md).

> [accordion] 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. A plan Newly granted you can be cancelled and resumed the same way.
>
> See [Change, cancel or manage your plan](https://docs.newly.app/billing/manage-your-plan.md).

## Getting Newly

> [accordion] Do I need to install anything?
>
> No. Newly at app.newly.app works in your browser.
>
> See [Build your first app](https://docs.newly.app/get-started/quickstart.md).

> [accordion] Is there a Newly phone app?
>
> There's no Newly phone app to download. Use the web app to build. To try your own app on an iPhone, use TestFlight.
>
> See [Testing on a real phone](https://docs.newly.app/preview/test-on-a-phone.md).

## Building and previewing

> [accordion] How do I put my app on my phone?
>
> On iPhone, ask the agent in a 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.
>
> On Android, ask the agent for an APK: Newly builds a release APK you download and install on the phone. See [Download an Android APK](https://docs.newly.app/publish/android-apk.md) and [Testing on a real phone](https://docs.newly.app/preview/test-on-a-phone.md).

> [accordion] Can I use Expo Go or a QR code?
>
> No. Newly 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](https://docs.newly.app/preview/overview.md).

> [accordion] Can I publish to Google Play or download an APK?
>
> You can download an APK. Ask the agent for an Android APK and Newly builds a standalone release APK you can install on any Android phone. See [Download an Android APK](https://docs.newly.app/publish/android-apk.md).
>
> You can also publish to Google Play. An organization owner or admin connects your Google Play account in the Deploy tab, and Newly builds, signs and uploads the app to internal testing, ready to release to production. You can start it from the chat too: ask the agent to publish to Google Play. See [From TestFlight to the App Store](https://docs.newly.app/publish/app-store-and-google-play.md#google-play).

> [accordion] Which AI model does Newly use?
>
> Newly chooses the model behind Newly Agent and may change it.
>
> See [Chatting with the agent](https://docs.newly.app/build/chatting-with-the-agent.md).

> [accordion] What happens if I close the tab while the agent works?
>
> The agent keeps working. Come back later and the results are there.
>
> See [Chatting with the agent](https://docs.newly.app/build/chatting-with-the-agent.md).

> [accordion] Why does my chat say Parked?
>
> A 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](https://docs.newly.app/build/sleep-and-limits.md).

## Code, sharing and integrations

> [accordion] 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](https://docs.newly.app/code/get-your-code.md).

> [accordion] Does my project sync to GitHub?
>
> Yes, if you connect it. Open **Integrations**, then **GitHub**, install the Newly GitHub App, then create a new repository or link one you already have. Changes sync both ways. Newly keeps its own copy too. Only an organization owner or admin can connect GitHub.
>
> See [Connect GitHub](https://docs.newly.app/code/github.md).

> [accordion] 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 account first. Every turn in your project uses credits from the project owner's organization, whoever sends the message.
>
> See [Share a project](https://docs.newly.app/code/sharing-projects.md).

> [accordion] 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, add `--env prod` to both commands. You need to own the project or have **Admin** access.
>
> See [Production and secrets](https://docs.newly.app/backend/production-and-secrets.md).

> [accordion] Can I schedule database backups myself?
>
> Yes. Run the manual `newly db backup create` command from your own cron job, CI workflow or other scheduler. Production snapshots require the project owner's credentials. You manage the job, credentials, retention and failure monitoring. Newly doesn't configure a managed backup schedule or create a snapshot automatically before deployment.
>
> CLI snapshots require Newly to be available. For an independent database export, save your owner connection URL beforehand and run Postgres tools such as `pg_dump` from infrastructure you control.
>
> See [Database backups](https://docs.newly.app/backend/database-backups.md) for a GitHub Actions example, limits and recovery commands.

> [accordion] Does Newly support Supabase, RevenueCat or OneSignal?
>
> Yes for Supabase: if your app uses it, connect your own Supabase project from a card in the chat or from **Integrations**, and the agent deploys Edge Functions and database changes to it. See [Supabase](https://docs.newly.app/backend/integrations.md#supabase). Newly doesn't connect to Firebase or other backend providers; when your app needs a backend, the agent adds Newly Backend. For push notifications, ask in a chat and a card connects OneSignal, managed by Newly with no OneSignal account needed, or with your own OneSignal account. For subscriptions, ask for a paywall and a card connects RevenueCat. Both are also in your project's **Integrations** tab.
>
> See [Integrations](https://docs.newly.app/backend/integrations.md).

## Account

> [accordion] How do I delete my account?
>
> Open the account menu, select **Account**, then **Delete account**, and type your email to confirm. It cancels your plan right away and removes your projects. You have 30 days to sign back in and restore your account.
>
> See [Delete a chat, project or account](https://docs.newly.app/account/delete.md).

> [accordion] How do I sign in?
>
> With your email and a one-time code, or with Google or GitHub. There are no passwords.
>
> See [Sign up and sign in](https://docs.newly.app/get-started/sign-in.md).


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.