# Rork - [Welcome](https://docs.rork.com/index.md): Use this section to understand how Rork works, how projects are structured, and how to begin building with confidence. - [How to tell if your app idea is good](https://docs.rork.com/elements-of-a-good-idea/how-to-tell-if-your-idea-is-good.md): Most app ideas fail before code. Not because the tech is hard, but because the idea itself does not create real pull. This guide helps you decide if an idea is worth building before you spend weeks shipping. - [How to build your first app](https://docs.rork.com/introduction/build-your-first-app.md): Get started by building your first app. - [How to prompt succesfully](https://docs.rork.com/introduction/introduction/prompting-strategy.md): How to prompt Rork to build more polished, high-quality apps. - [iPhone, Android, or web: what's the difference](https://docs.rork.com/swift-vs-react-native/whats-the-difference.md): Rork builds native iPhone apps with Swift, native Android apps with Kotlin, and web apps with React. This page explains what each one is good at, so you can pick the right one for your product. - [Build a native iPhone app with Rork](https://docs.rork.com/iphone/rork-iphone.md): Rork writes native iPhone apps in Swift with SwiftUI, runs them on a cloud iOS simulator next to the chat, and submits the build to TestFlight and the App Store. - [Build a native Android app with Rork](https://docs.rork.com/android/rork-android.md): Rork writes native Android apps in Kotlin with Jetpack Compose, runs them on a cloud Android emulator next to the chat, signs the App Bundle for you, and sends the release to Google Play. - [Rork Web: build and publish a web app](https://docs.rork.com/web/rork-web.md): Rork builds web apps with Vite and React, previews them next to the chat, and publishes them to your own address on rork.app. Use it for a website, a dashboard, a client portal, or an admin tool. - [What happened to Expo?](https://docs.rork.com/expo.md): Rork used to build Expo (React Native) apps. Internal benchmarks showed the agent writes better Swift apps, so we switched. Existing Expo projects keep working. - [Convert your Lovable app to a mobile app](https://docs.rork.com/import/lovable-to-mobile-app.md): How to convert a Lovable app to a native iOS and Android mobile app: import your Lovable project into Rork, keep your Supabase backend, and ship to the App Store. No APK wrappers, no webviews. - [Import a GitHub repository into Rork](https://docs.rork.com/import/import-from-github.md): How to import a GitHub repo into Rork and build a mobile app from it: paste the repository URL, connect the Rork GitHub App, and continue your existing project with AI, with two-way GitHub sync. - [Move your project from any app builder to Rork](https://docs.rork.com/import/import-from-any-app-builder.md): Migrate a project from Bolt, v0, Replit, FlutterFlow, Bubble, Glide, Softr, or Base44 into Rork and get a native mobile app: export your code to GitHub, then import. Includes per-builder export steps. - [Turn your website into a mobile app](https://docs.rork.com/import/website-to-mobile-app.md): How to convert a website to an app for iOS and Android: import your site into Rork and get a real native mobile app, not a webview wrapper or APK converter output. - [Convert your app between iOS, Android, and web](https://docs.rork.com/import/convert-between-platforms.md): Convert an Android app to iOS with AI (or the reverse), turn a React Native codebase into native Swift and Kotlin, and ship every platform from one Rork project. - [Design mode, Plan mode, and building](https://docs.rork.com/features/agent-modes.md): Rork can design your app before it writes code, write a plan before it changes files, or build straight away. This page explains the three paths, where the switches are, and what each one costs. - [Element Selection](https://docs.rork.com/features/element-selection.md): Select any element in the iOS, Android, or web preview and tell Rork how to change it. Rork reads the element you picked and edits that part of the app. No screenshots needed. - [Undo a change and go back a version](https://docs.rork.com/features/undo-and-history.md): Every Rork message is a version you can return to. Undo the last change, revert to any earlier answer, review the exact files that changed, and stop a message that is going the wrong way. - [Images, video, audio, and 3D models](https://docs.rork.com/features/assets.md): Rork generates the pictures, video, sound, and 3D models your app needs, keeps them in the Assets tab, and puts them into the code for you. Ask for them in chat. - [Image Generation](https://docs.rork.com/features/imagegeneration.md): This document outlines how you can use AI Image Generation with your Rork applications. - [What is an API?](https://docs.rork.com/features/index.md): An external third party API can enhance the functionality of your apps and help you build the unthinkable. This document explains what they are, which ones are already available on Rork, and how to quickly add new custom ones. - [Connecting an API to Rork](https://docs.rork.com/features-apis/apis/how-to-connect-an-api-to-your-project.md): API's are great because they essentially allow your apps to do anything without you needing to do it. - [API keys and environment variables](https://docs.rork.com/features/secrets.md): Store API keys in your Rork project instead of pasting them into code. This page explains the Secrets editor, which variables reach the phone, and how to keep a private key private. - [Share a project and work together](https://docs.rork.com/collaborate/share-a-project.md): Invite people to view or edit your Rork project, leave comments for each other, see who is online, and clone a project into a fresh copy you can change freely. - [How to sync your project with Github](https://docs.rork.com/tutorials/how-to-connect-github.md): Full guide on how to connect your Rork project to GitHub for a 2-way sync - [Open your project in Xcode](https://docs.rork.com/how-to-set-up-xcode/how-to-set-up-xcoe.md): An optional workflow for developers who want to export a Rork iPhone app through GitHub and build or debug it locally on a Mac. - [Project analytics and revenue](https://docs.rork.com/features/analytics.md): The Analytics tab shows how much you have built in a project and, once you connect RevenueCat, what your app earns: revenue, MRR, subscriptions, trials, and conversion. - [Build a game with Rork](https://docs.rork.com/games/build-a-game.md): Rork builds 2D and 3D games without a game engine: SpriteKit and RealityKit on iPhone, three.js in the browser. It generates the 3D models, the animations, and the sound for you. - [NanoBanana AI Image App Tutorial](https://docs.rork.com/quick-start-examples/nano-banana-image-app.md): Build a custom AI image app that uses Google's popular NanoBanana API. - [Do You Need a Backend for Your App?](https://docs.rork.com/backend/index.md): Learn exactly when your Rork project requires backend setup and when you can skip it entirely. This guide helps you avoid building a backend for no reason. - [What is Rork Cloud](https://docs.rork.com/backend/rork-cloud.md): Why use Rork's built-in backend instead of setting up your own, what it costs, and what to expect. - [Add accounts and sign-in to your app](https://docs.rork.com/integrations/backend/how-to-set-up-oauth.md): Rork Auth adds Google and Apple sign-in with no setup and no backend. Supabase Auth covers email and password, magic links, and phone codes. This page explains which one to pick, and why a project uses only one. - [What is Rork's Backend Capabilities?](https://docs.rork.com/building-complex-apps/backend/what-is-rork-toolkit.md): Rork provides an optional backend infrastructure for applications requiring server-side functionality. Currently in its beta phase, if you run into any issues, please reach out to Support. - [How to add a Supabase backend to Rork](https://docs.rork.com/backend/supabase.md): This guide will help you create a Supabase backend for your Rork project. This includes authentication for users and also custom database schemas for functionalities in your app. - [How to add a Firebase backend to Rork](https://docs.rork.com/backend/firebase.md): This guide will help you create a backend with Firebase for your Rork project. This includes authentication for users and also custom database schemas for functionalities in your app. - [Rork simulator](https://docs.rork.com/features/simulator.md): Test your app, take screenshots, and record the screen right in Rork. Attach captures to the chat or download them to share what you are building. - [Rork Max app for iPhone](https://docs.rork.com/rork-max/rork-max-app.md): Rork Max is the first mobile app that lets you build Swift and Web apps, install, and publish to the App Store on the go. It runs the native iOS apps you build with Rork right on your iPhone, replacing Xcode and TestFlight without compromising performance. - [Rork Companion for Windows and Mac](https://docs.rork.com/rork-max-swift.md): Use the free Rork Companion desktop app to install Rork Max or a Swift app you built on your iPhone over USB. - [Read the code and read the logs](https://docs.rork.com/features/code-and-logs.md): Every Rork project is a real codebase you can open, read, and on a paid plan edit by hand. The Logs panel underneath shows what your app printed while it ran. - [How to get out of an error loop](https://docs.rork.com/introduction/introduction/agent-loops.md): Sometimes, Rork will be unable to fix the error and/or start to hallucinate. In this doc, we will go over how to solve that - [Publish your app](https://docs.rork.com/introduction/deploy-your-app.md): Where your finished app can go: the App Store, Google Play, or the web. Each store has its own account, its own review, and its own waiting time. Start here and pick your route. - [Create your Apple Developer Account to publish to App Store](https://docs.rork.com/store-guides/apple-developer-account.md): This guide will help you get your Apple Developer account setup to publish apps in the App Store. - [Publish Your App to the Apple App Store](https://docs.rork.com/store-guides/publish-app-store.md): This guide will publish your Rork project to the App Store in minutes. - [Publishing](https://docs.rork.com/publishing.md): The short version of an App Store submission from Rork: create the Apple Developer account, press Publish, sign in, and enter the verification code. - [TestFlight: put your app on real phones](https://docs.rork.com/store-guides/testflight-beta-testers.md): Rork uploads your iPhone build to TestFlight, then gives you a link to invite testers. This page covers the submission steps, the beta link, and exactly what a tester has to do. - [Submission errors](https://docs.rork.com/submitting-to-app-store/apple/submission-errors.md): Here are the most common issues with submissions on Rork and the work arounds. - [App Store Checklist](https://docs.rork.com/submitting-to-app-store/apple/app-store-checklist.md): Now that your app is complete here's everything you have to do to make sure your app is App Store ready! - [App Store screenshots](https://docs.rork.com/appstore-screenshots/app-store-screenshots.md): This guide walks through how to create high-quality App Store screenshots, the tools you can use, and what Apple expects when you upload them - [Screenshot Studio: App Store screenshots in a minute](https://docs.rork.com/store-guides/screenshot-studio.md): Screenshot Studio turns your raw app screens into a designed App Store deck: written headlines, painted backgrounds, and iPhone frames, exported at the size App Store Connect accepts. - [AI App Store Reviewer](https://docs.rork.com/ai-app-store-reviewer.md): Rork reads your iOS build against the App Store Review Guidelines before Apple does, and reports each rejection risk with its guideline number, the evidence behind it, and a suggested fix. - [App Review guide](https://docs.rork.com/appstore-submission-checklist/app-review-guide.md): This guide explains how Apple's App Store review process works, how long it usually takes, what can slow it down, and how to request an expedited review when timing matters. - [Main App Store rejection reasons](https://docs.rork.com/appstore-submission-checklist/whats-next-after-the-apps-finished.md): These are the most common reasons for App Store rejections - [Reply to App Store reviews](https://docs.rork.com/store-guides/app-store-reviews.md): Your App Store ratings and written reviews arrive inside the Rork project. Rork tells you when a new review lands, and the agent drafts and posts your public developer response after you approve it. - [Create your Google Play developer account](https://docs.rork.com/store-guides/google-play-developer-account.md): What you need before Rork can publish your Android app: a Google Play developer account, identity verification, and, for new personal accounts, a closed test with 12 testers for 14 days. - [How to test Android apps on your Android device](https://docs.rork.com/submitting-to-play-store/apk-file.md): How to test your Rork app on a real Android phone, and how to get an installable APK build when you need one. - [How to publish your Rork app to Google Play Store](https://docs.rork.com/submitting-to-play-store/creating-the-aab-file.md): Google Play requires an AAB (Android App Bundle) file for distribution. This guide shows how to get the AAB for your Rork project and upload it to the Play Console, starting with an internal testing release. - [How to add a paywall to your Rork app with RevenueCat](https://docs.rork.com/payment-guides/revenuecat-copied-1.md): Are you ready to add payments to your app? Use this guide to setup Rork with RevenueCat paywall and deploy your app to Production with a full feature gated payment system! - [How to add a Free Trial](https://docs.rork.com/make-your-app-profitable/paywalls/how-to-add-a-free-trial.md): This guide goes over how to add an free trial offer to your IOS app - [How To Create a privacy policy, Terms and conditions, and EULA](https://docs.rork.com/make-your-app-profitable/paywalls/how-to-set-up-your-policies.md): Every app must include Terms & Conditions, a Privacy Policy, and an EULA to be approved on the App Store and to protect you legally. - [Ideation](https://docs.rork.com/rork-playbook/playbook.md): How to come to a successful idea - [Posting Organic Content](https://docs.rork.com/rork-playbook/untitled-page.md): Guide to organic content - [Winning influencer creatives](https://docs.rork.com/rork-playbook/untitled-page-1.md): How to run profitable influencer marketing - [Finding Influencers and negotiating with them](https://docs.rork.com/rork-playbook/untitled-page-2.md): How to find and negotiate profitable deals with influencers - [Onboarding and Monetization](https://docs.rork.com/rork-playbook/untitled-page-3.md): How to make money from an app: onboarding into a paywall, what to charge, and how to test your pricing. - [Helpful Resources](https://docs.rork.com/rork-playbook/untitled-page-4.md): Outside reading we recommend on paywall design, onboarding, influencer marketing, and App Store optimisation. - [How to Scale Your Mobile App to $50k+/Month (The Complete Guide)](https://docs.rork.com/rork-playbook/scale-to-50k-month.md): The complete playbook our top builders use to scale: how to pick the right app, get your first paying users, nail your onboarding, and scale distribution. - [The 7 Ways to Scale Your App](https://docs.rork.com/rork-playbook/seven-ways-to-scale-your-app.md): The 7 ways to scale your app, broken down in detail with case studies from some of the most successful app founders in the space. - [Plans & Subscriptions](https://docs.rork.com/introduction/subscriptions.md): Rork pricing explained: the Free, Rork Pro, and Rork Max plans, Design mode vs Build mode, what credits are, what each plan includes (iPhone, Android, web), and how to upgrade, downgrade, or cancel your subscription. - [Build credits vs Cloud credits](https://docs.rork.com/billing/build-credits-vs-cloud-credits.md): Rork has two separate balances: build credits for creating your app with the agent, and Cloud credits for the AI and cloud features your finished app uses. - [Overview](https://docs.rork.com/faq/index.md): FAQ master list. - [General](https://docs.rork.com/faq/general.md): General FAQ questions for Rork - [Technical](https://docs.rork.com/faq/technical.md): Frequently Asked Questions about technical building with Rork - [Integrations](https://docs.rork.com/faq/integrations.md): Frequently Asked Questions about Integrations with Rork - [Publishing](https://docs.rork.com/faq/publishing.md): Frequently Asked Questions about publishing with Rork - [Code Export](https://docs.rork.com/faq/code-export.md): Frequently Asked Questions about code export with Rork - [Collaboration](https://docs.rork.com/faq/collaboration.md): Frequently Asked Questions about collaboration with Rork - [Billing](https://docs.rork.com/faq/billing.md): Frequently Asked Questions about billing with Rork - [Support](https://docs.rork.com/faq/support.md): Frequently Asked Questions about support with Rork - [Request Documentation](https://docs.rork.com/request-documentation.md): Missing a guide? Tell us what you need documented and we will write it. - [SKILL](https://docs.rork.com/.cursor/skills/rork-docs/SKILL.md): Write and edit pages for the Rork documentation site (docs.rork.com, Mintlify). Covers page structure, voice, verified-facts rule, the screenshot capture workflow with the Cursor browser, docs.json navigation, UTM tagging, and the checks to run before a PR. Use when adding or editing any .mdx page i… ## Optional - [Discord Community](https://discord.gg/rxBHytVKaT) - [Blog](https://rork.com/blog) - [Guides](https://rork.com/guides)