DEV Community

Cover image for Gatsby Develop with iOS Simulator
Chris Otto
Chris Otto

Posted on • Originally published at on

Gatsby Develop with iOS Simulator

Image from @norwood at Unsplash.

Chrome DevTools have come a long way in enabling users to mimic mobile devices. However, if you wanted to debug your Gatsby application locally for mobile specific features you can do that through the iOS Simulator. In order to do this you need to have a Mac, there are other ways around it without a Mac but this post will focus on setting up your Gatsby site to be accessed through the simulator.


  • A Mac computer
  • XCode installed
  • Developer Tools Enabled in your Mac’s Safari browser
    • Launch Safari
    • Click Safari in the Menu
    • Preferences
    • Advanced
    • Enable Show Develop menu in menu bar

Start Gatsby 👨‍🚀

First thing we’ll need to do is start the Gatsby site in a special way allowing for local network access. This can be done by using the -H parameter when starting gatsby develop

gatsby develop -H
Enter fullscreen mode Exit fullscreen mode

Find Your IP Address 💻

Next you need to find your local IP Address within your network and that can be done in the terminal with the following command.

ipconfig getifaddr en0
Enter fullscreen mode Exit fullscreen mode

Launch the Simulator 🚀

For this next part, we’ll be starting XCode and starting to iOS Simulator.

  • Launch XCode
  • Select XCode in the Menu
  • Open Developer Tool
  • Simulator

With the simulator up and running we’ll need to navigate to our locally served instance of our Gatsby site.

  • Open Safari in the simulator
  • In the address bar paste in %IP_ADDRESS%:8000

With the site active in the simulator we can now open up the Safari Developer Tools for debugging our site in the simulator.

  • Start Safari on your computer
  • Go the Develop in the menu
  • Expand the Simulator option
  • Click on the IP Address listed for your site
  • A new Dev Tools window will launch for your simulator session

Now you’ll be able to use your site as a true mobile user would even change geolocation settings, accelerometer settings, and all the other benefits of iOS Simulator for using your Gatsby application.

Top comments (0)