How to Generate Ios Folder in React Native
If you want to know how to generate ios folder in React Native, the short answer is that the folder is usually created automatically when you initialize a new project with the React Native CLI. You normally do not create it by hand in an existing app, and if it is missing, the cause is often that the project was created with Expo or that the iOS native files were never generated in the first place.
What the ios folder means in React Native
In a standard React Native project, the ios folder contains the native iOS project files needed to build and run the app on iPhone and iPad. This is where Xcode project settings, native dependencies, signing configuration, and iOS-specific build files live.
If you are building a cross-platform app and want one codebase for both platforms, the iOS folder is part of the native structure that makes that possible. It sits alongside the android folder and the shared JavaScript or TypeScript code.
How to generate the ios folder in React Native
The most reliable way to generate the ios folder is to create the app with the React Native CLI. When you use the CLI, React Native scaffolds the project and includes the iOS native project automatically.
1. Make sure your Mac has the required tools
To build iOS apps locally, you need a Mac with Apple developer tools installed. At minimum, check that you have:
- Node.js
- Watchman, which is commonly used on macOS for file watching
- Xcode from the Mac App Store
- CocoaPods for iOS dependency management
Without Xcode, you can still create the project, but you will not be able to run it on the iOS Simulator or build the iOS app locally.
2. Create a new React Native project with the CLI
Use the official React Native project generator. A typical command looks like this:
npx react-native@latest init MyApp
This creates a new project folder and includes both the ios and android directories.
If you use this route, the iOS folder is generated for you. You do not need a separate command just for iOS.
3. Confirm that the ios folder exists
After initialization, open the project directory and check for an ios folder at the root level. In a normal React Native CLI project, you should also see files such as:
- Xcode workspace files
- Project configuration files
- Podfile
- App delegate and native source files
If those files are present, the iOS project has been generated correctly.
Open the iOS project in Xcode
Once the folder exists, open the iOS workspace in Xcode. In most React Native projects, you should open the .xcworkspace file after installing pods, not the .xcodeproj file.
That matters because CocoaPods integrates native dependencies into the workspace. If you open the wrong file, some native libraries may not appear correctly.
Install iOS dependencies with CocoaPods
After creating the project, go into the ios directory and install pods:
cd ios pod install cd ..
This step fetches and links iOS dependencies used by React Native and any native modules you add later. If pod installation fails, check that CocoaPods is installed correctly and that your Ruby environment is healthy.
For many developers, this is the step that makes the iOS project usable in Xcode and on the simulator.
Run the app on the iOS Simulator
After the project is generated and pods are installed, you can launch the app on the iOS Simulator from the command line or from Xcode.
A common command is:
npx react-native run-ios
This builds the iOS app, starts Metro if needed, and opens the simulator. If you prefer Xcode, open the workspace, choose a simulator target, and press Run.
Why the ios folder may be missing
If you expected an ios folder but do not see one, the project probably falls into one of these cases:
- You created an Expo managed app, which does not expose native folders in the same way by default.
- You did not use the React Native CLI, so the native project was never scaffolded.
- The project setup was interrupted, and the native files were not fully generated.
- You are looking in the wrong directory, especially in monorepos or nested app structures.
Before trying to recreate anything, confirm which workflow you used. That usually explains the missing folder right away.
React Native CLI vs Expo for iOS projects
The biggest difference is how much native project structure you can see and manage directly.
| Workflow | iOS folder visible | Best for | Typical note |
|---|---|---|---|
| React Native CLI | Yes | Projects that need native iOS access | Generates ios and android folders automatically |
| Expo managed workflow | Usually no | Faster setup and simpler app development | Native folders are abstracted unless you prebuild or eject |
| Expo prebuild or bare workflow | Yes | Apps that need Expo tooling plus native code access | Native project files are generated into the app structure |
If your goal is to build app for Android and iOS from one codebase, React Native CLI and Expo can both work, but they do not expose the native iOS project in the same way.
What to do if you already have a project and need iOS support
If you started with an Expo managed project and now need native iOS files, your path depends on your setup. In some cases, you may use Expo prebuild to generate native folders. In others, you may create a new React Native CLI project and move your shared JavaScript code into it.
If the project is already a React Native app but the ios folder is gone, recover the missing native files from version control if possible. Recreating them manually is risky unless you know exactly which native settings your app needs.
This is especially important for apps that use native SDKs, custom permissions, push notifications, or features like camera and location services.
Common mistakes when generating the ios folder
- Using the wrong command, such as creating a plain Node project instead of a React Native app.
- Expecting Expo managed projects to look like CLI projects.
- Opening the .xcodeproj file instead of the .xcworkspace file after pods are installed.
- Skipping pod install and then wondering why the iOS build fails.
- Assuming the folder should be created manually in an existing project.
Helpful checks before you build an iOS app in React Native
If your broader goal is how to build an iOS app from scratch, or even how to build a simple iOS app, this workflow is a strong starting point because it gives you one codebase for native iOS and Android support. Before you move into feature development, confirm these basics:
- The project was created with the right toolchain
- Xcode is installed and up to date
- CocoaPods has finished successfully
- The simulator runs cleanly
- Your JavaScript code starts without Metro errors
Once those pieces are in place, you can build features such as authentication, feeds, chat, or a messaging UI without fighting the setup.
Troubleshooting checklist
If the ios folder exists but the app still will not run, try this checklist:
- Verify that you are using a React Native CLI project, not a plain Expo managed project.
- Run pod install inside the ios directory.
- Open the .xcworkspace file in Xcode.
- Confirm that Xcode command line tools are installed.
- Try a clean build or restart the simulator.
- Check for native dependency issues after adding third-party packages.
If the folder is missing entirely, it is usually faster to create a new React Native CLI app than to rebuild the native structure by hand.
When React Native is the right choice
React Native is a practical option when you want to build apps for iOS and Android with shared business logic and a single codebase. It is often a good fit for teams that want faster development than building separate native apps in Swift and Kotlin.
That said, if your app needs deep custom iOS behavior, you may still spend time in Xcode and native code. Knowing how the ios folder works helps you manage that boundary more confidently.
Frequently Asked Questions About how to generate ios folder in react native
How do I generate the ios folder in React Native?
Create the app with the React Native CLI, for example with npx react-native@latest init MyApp. The ios folder is generated automatically in a new CLI project.
Why is my ios folder missing in React Native?
It is usually missing because the project was created with Expo managed workflow, the wrong command was used, or the native setup was never completed.
Do I need Xcode to build a React Native iOS app?
Yes, if you want to build or run the app on iOS locally. Xcode is required for the iOS Simulator and for native iOS builds on macOS.
Can I create an iOS app in React Native without Expo?
Yes. React Native CLI is the common way to create a project with full ios and android folders from the start.
How do I open the iOS project in Xcode?
After running CocoaPods, open the .xcworkspace file in the ios folder. That is usually the correct file for React Native iOS development.
How do I run a React Native app on the iPhone simulator?
Use npx react-native run-ios from the project root, or open the workspace in Xcode and press Run with a simulator selected.
What is the difference between ios and android folders in React Native?
They contain the native platform projects for each operating system. The shared JavaScript or TypeScript code powers both, while the ios and android folders hold platform-specific build files and native configuration.
Conclusion
The best way to generate ios folder in React Native is to start a project with the React Native CLI, because that is what creates the native iOS structure automatically. If the folder is missing, check whether you are using Expo managed workflow, confirm your project was created correctly, and install the iOS dependencies with CocoaPods before opening the workspace in Xcode. Once the setup is in place, you can build and run your app on the iOS Simulator and continue developing both iOS and Android from one codebase.