Hello everyone, and welcome to this special guide! 🎉

This documentation is specifically designed for students who initially started their React Native development journey on a Windows machine and will later decide to transition to macOS for iOS development. If you're planning to make that switch and want to ensure a smooth transition, keep this article bookmarked! You'll find it invaluable for avoiding common pitfalls and ensuring your app runs seamlessly on macOS. 🌟

I've crafted this guide because transitioning from one operating system to another can be filled with unexpected challenges, especially when you're targeting a new platform like iOS. So, before you jump into transferring files and running commands, make sure to revisit our previous videos on environment setup for macOS. This will ensure your development environment is primed and ready to go. 🛠️

Step 1: Re-watch Environment Setup Videos

Before you even think about moving your project files, re-watch our previous lectures on setting up your macOS environment for React Native development. This is crucial to ensure that you have all the necessary tools and configurations in place.

Step 2: Transfer Your Project Files

To start, you'll need to move your React Native project files from your Windows system to your Mac. Whether you use cloud storage, Git, or a direct wire transfer is up to you.

Step 3: Clean the Caches

You will find the cache cleaning .sh file inside resources of this article. Download it and run it to make sure that caches are cleaned from your previous development and you can start fresh without facing any issues.

Step 4: Install Node Package Dependencies

If you do not use the resources folder for cleaning the caches you might need to reinstall node package dependencies for the project you've setup. After transferring the files, open the terminal, go to your project's directory, and run npm install --legacy-peer-deps. This command installs all the dependencies listed in your project's package.json file.

Step 5: Run CocoaPods

Again, if you have not used resources folder with cleaning the caches, you'll need to manually execute this step as well. Next, go into your project's 'ios' directory and execute the command pod install. After completion, make sure to return to your project's root directory by typing cd ...

Step 6: Revise Configuration Files

If you've used Firebase setup in your project, you'd need to make sure to generate appropriate files, make firebase supporting changes in your project & install any necessary pods. If you have used firebase, cleaning the caches will not help you - you'd have to make sure to setup the firebase correctly on your project. For this refer to the section of Authentication in Donation application.

Step 7: Debug Like a Pro

Should you encounter any errors or warnings, you can use debugging tools such as Xcode or React DevTools to pinpoint and resolve these issues.

And there you have it! You're now fully equipped to transfer your React Native project from a Windows machine to macOS for iOS development. Keep this guide handy for future reference, and happy coding! 🎉👩‍💻👨‍💻