Mobile app development guide

Build a Subscription App with Newly: A Practical Walkthrough

To build a subscription app with Newly, first create the useful free experience, then connect RevenueCat, configure the store products and entitlement, and test a native purchase flow. An owner or admin manages the connection and publishing setup. Keep source export, actual agent-credit usage and store review as separate checkpoints.[6][1][5]

Timothy Lindblom

Founder, Newly

Reviewed . A reproducible walkthrough checked against current product workflows and implementation. The sample app is an example brief; use the measurement log to record your own build results. Published by Newly.

From app brief to release evidence

Use these checkpoints for the example habit tracker below. Mark a step complete only after you have observed and saved its result.

Swipe the table to see every column.

From app brief to release evidence, reviewed 30 October 2026
CheckpointActionEvidence to keep
Useful free appAdd a habit, mark it complete and reopen the app.A working user flow, saved state and the exact prompt used.
RevenueCat connectionAn owner or admin connects the account and selects an authorized project.[6]The selected project, app identity and connection status. Keep private credentials out of screenshots.
Products and entitlementMatch the store products, RevenueCat products and the pro entitlement.[7]Product identifiers, the entitlement mapping and a paywall using current product information.
Native purchase testTest purchase, restore and inactive access using store test accounts.[9]Device and build version, test environment and expected versus observed result.
Code handoverDownload source or connect two-way GitHub sync.[1][4]The exported revision and the dependencies needed to run it independently.
Store releaseUpload a tested build and finish the store listing and review steps.[5]Uploaded version, test distribution and review submission recorded separately.

1. Build the useful free experience

Use a small habit tracker as the example. The free experience lets someone create up to three habits, record today's completion and see a seven-day history. The proposed paid feature is an unlimited habit list and a longer history. Those are example product decisions, not a report of an app already built or released.

Decide whether the first version needs accounts or shared data. Ask the agent to explain the storage model before expanding the app. If you want access to follow a user between devices, plan identity and purchase restoration deliberately rather than assuming that a local flag will travel with the account.

Build a habit tracker for iOS and Android. For the first version, let a user create up to three habits, mark today's completion and view the last seven days. Keep data after reopening the app and explain where it is stored. Add clear empty and error states. Build this free flow first and list any mocked or unfinished behavior before we add subscriptions.

2. Connect RevenueCat with the right account

Once the free flow works, ask the agent to add the subscription. Newly supports a Connect RevenueCat card and a Subscriptions setup flow. A project owner or admin connects the account and selects a RevenueCat project covered by the authorization.[6]

Use the app identity intended for the release. Check which Apple or Google app the products belong to and finish any required account agreements and configuration. If a connection is unavailable or an account lacks access, resolve that setup problem before treating the paywall as ready.

Add a subscription that unlocks unlimited habits and longer history. Use RevenueCat and show the connection step if needed. Keep the free three-habit flow working. Tell me which project, entitlement and store products need to be configured, and which account actions I must complete myself.

3. Map products to access

Choose an entitlement such as pro for the paid access. The entitlement describes what a customer can use; a store product describes the purchase. Map every intended monthly or annual product to the entitlement and verify the mapping before testing.[7]

Ask for the paywall to use the current store product information instead of a hardcoded price string. After a successful purchase or restore, the app should read the entitlement state and unlock the paid feature. A button that changes a local isPro value is a mock, not a complete purchase integration.[7][8]

Keep purchase handling and account identity consistent across devices. Define what should happen when a user signs out, signs in elsewhere or restores a prior purchase. Check the account model supported by the generated app before making promises about cross-device access.

Use the pro entitlement to gate unlimited habits and longer history. Show the localized product price from the store, provide a restore-purchases action and handle loading, cancellation and errors. Do not grant access from a local mock flag. Explain how the app refreshes entitlement state after a purchase, restore, relaunch and sign-in change.

4. Test the purchase flow in a native environment

A cloud preview is useful for layout and the free app flow. For purchase behavior, use the native build and test environment appropriate to the store and SDK. Follow RevenueCat's testing guidance and the store's account setup; a screenshot of a paywall does not establish that billing works.[9]

Record the expected result before each test and the observed result afterward. Keep the build version and test account type with the result, so a later fix can be checked against the same scenario. Use synthetic users and test purchases, and keep account details out of shared recordings.

  • Free user: the free limits work and paid features remain locked.
  • Successful purchase: the intended entitlement becomes active and paid access works.
  • Cancelled purchase: no entitlement is granted and the app remains usable.
  • Restore: a valid prior purchase restores access for the intended account.
  • Inactive or expired access: the app reflects the current entitlement and preserves the user's data.
  • Relaunch and sign-in change: access is refreshed for the current customer rather than copied from stale local state.
  • Network or store error: the app shows a useful state and does not invent a successful purchase.

5. Measure actual credits and completed work

Newly's entry subscription is $25/month with 100 credits. Agent work draws down credits according to the work performed. A prompt is not a fixed unit of cost. Cloud simulators and native builds do not consume those agent credits.[3][2]

Before an agent task, note the available balance and the scope of that task. After it finishes, record the usage shown by Newly and whether the acceptance criteria passed. Separate new-feature work from repair work, and account for any top-ups or other balance changes during the measurement.

Measure elapsed time with start and end timestamps. Separate agent work, native build processing, store processing and review waiting. Keep service subscriptions, app-store account costs and any RevenueCat charges outside the builder-credit total. Check each provider's current pricing for your usage.[10]

Task | starting revision | start/end time | usage shown | balance changes | result | evidence
Free habit flow | record | record | record | record | pass/fail | screenshot or test log
Subscription setup | record | record | record | record | pass/fail | configuration record
Purchase and restore | record | record | record | record | pass/fail | native test results
Source handover | record | record | record | record | pass/fail | exported revision
Store upload | record | record | record | record | pass/fail | uploaded build version

6. Export the code and verify the handover

An owner or admin can download the source ZIP from Settings, Project, Download source. You can also use the Newly CLI or link a repository from Deploy for two-way GitHub sync. Record the branch and revision used for the tested build.[1][4]

Keep a service inventory with the source: RevenueCat project, store apps, product identifiers, entitlement mapping and any backend used by the app. Source export does not automatically transfer live data or account ownership. Have a developer verify configuration and dependencies in a clean environment before calling the handover complete.

7. Upload the tested version and finish review

Newly can build and upload an iOS version to App Store Connect and TestFlight. You complete the required listing, privacy and review submission steps. Android uses its own signing, Play Console setup and testing path, including any first-upload steps required for the project.[5][1]

Use the same product identifiers and app identity you tested. Check the subscription description, price presentation, restore action and reviewer access instructions against the actual app. Save the uploaded version and review outcome as separate records; a successful build is not the same milestone as a public release.

Frequently asked questions

Can Newly build an app with subscriptions?

Newly supports a RevenueCat connection, subscription-product setup and paywall generation. An owner or admin manages the connection. You still need the appropriate store accounts, product configuration, entitlement checks and native purchase testing.

Do I need RevenueCat and app-store accounts?

For the workflow in this guide, you connect a RevenueCat account and configure the relevant Apple or Google app and products. Required agreements, permissions and account setup remain part of your release work.

How much does a subscription app cost to build with Newly?

The entry subscription is $25/month with 100 credits, but the credits used by a particular app depend on the agent's work and iterations. Measure actual usage for your project and budget separately for third-party services and app-store accounts. This walkthrough does not claim a measured total build cost.

Can I test subscriptions just by looking at the cloud preview?

Use the preview to inspect the app and paywall, then verify purchases and restores in an appropriate native build and store test environment. A visible paywall or a local mock entitlement is not evidence of a working purchase flow.

Can I export the subscription app's code?

Yes. An owner or admin can download the source ZIP, use the Newly CLI or connect two-way GitHub sync through Deploy. Keep RevenueCat configuration, store products, service access and live-data handover separate from the source export.

Does Newly complete the final App Store review submission?

Newly can build and upload the iOS version to App Store Connect and TestFlight. You finish the store requirements and submit it for review yourself. Record upload, testing, review submission and approval as separate milestones.

Sources and review date

Sources reviewed 30 October 2026. Product capabilities and plan requirements can change; check the linked source before choosing a plan.

  1. Newly: current product FAQ and source export
  2. Newly: how credits work
  3. Newly: plans and top-ups
  4. Newly: connect GitHub
  5. Newly: App Store and Google Play publishing
  6. Newly: subscription setup and RevenueCat
  7. RevenueCat: creating and checking entitlements
  8. RevenueCat: checking subscription status
  9. RevenueCat: sandbox testing
  10. RevenueCat: current pricing