> ## Documentation Index
> Fetch the complete documentation index at: https://docs.newly.app/llms.txt
> Use this file to discover all available pages before exploring further.
# The web app and Newly for Mac
> What the web app and Newly for Mac each do, and how to install and update the Mac app.
You can use Newly v2 in two places: the web app at app.newly.app, and Newly for Mac. Both use the same account. A project you start in the web app shows up in the Mac app, and the other way around. The exception is a plain folder project you open in a Local chat on your Mac: it stays on that Mac.
## Which one to use
**The web app** needs nothing installed. Every chat in the web app is a Remote chat, which runs in the cloud. You can build, preview on cloud simulators and ship to TestFlight entirely from your browser. (Connecting Apple and publishing to TestFlight needs an organization owner or admin.)
**Newly for Mac** does everything the web app does, and adds Local chats that run on your Mac. In Local chats you can use your own Claude or Codex login and a few Mac-only tools. See [Local chats on your Mac](/mac/local-chats).
If you're not sure, start with the web app. You can install the Mac app later and pick up the same projects.
## What's different
| Feature | Web app | Newly for Mac |
| ---------------------------------- | ------------------------ | ------------------------------------------------------------------------------------------- |
| Remote chats (run in the cloud) | Yes | Yes |
| Local chats (run on your Mac) | No | Yes |
| Your own Claude or Codex login | No | In Local chats |
| **Design** mode | No | In Local chats |
| Voice input | No | Yes |
| App Logs in the preview pane | No | In Remote chats, and in Local chats with Developer mode |
| Store screenshots and AI app icons | No | In Local chats, with your own OpenAI key |
| Share a project | Yes | Yes |
| Transfer project ownership | No | Owner only, in Settings under **People** |
| Settings groups | **Project**, **General** | **People** (with a project open), **Project**, **General**, **Credentials**, **Publishing** |
For more on Settings, see [Settings and Developer mode](/account/settings). For sharing and ownership, see [Share a project](/code/sharing-projects).
## Install Newly for Mac
Newly for Mac needs a Mac with Apple silicon and macOS 14 or later.
Go to newly.app/download and press **Download for macOS**. The app is signed and notarized by Apple.
Open the downloaded file, move Newly to your Applications folder, and open it from there.
Sign in the same way you sign in to the web app: email code, Google or GitHub. See [Sign up and sign in](/get-started/sign-in).
The first time, the Mac app may offer to set up local development, which installs Xcode and the iOS Simulator on your Mac. You only need this to preview on your Mac's own simulator in Local chats. Choose **Set this up later** to skip it and start building right away.
## Updates
The Mac app keeps itself up to date.
* It checks for updates in the background and downloads them while you work.
* An update installs when you quit the app. When one is ready, you see **Update ready** with a **Relaunch now** button, so you can install it straight away.
* Occasionally an update is needed before you can keep working. The app then shows **Update required**, downloads the update and asks you to relaunch to install it.
* If an update can't install, download the app again from newly.app/download and replace the copy in Applications. Your projects and Remote chats are stored in your account, so they're still there when you sign in.
## Things that work a little differently on Mac
**Choosing an Apple API key or signing file for TestFlight.** The Mac app can't open these files from the publishing card. If you see "Open the cloud publishing card in your browser to select a key." or "Open cloud publishing in your browser to import a signing identity.", go to app.newly.app, sign in with the same account, open the same project and chat, and choose the file there. See [Connect Apple and manage signing](/publish/connect-apple).
**Where new chats run.** In the Mac app, a new chat can be Remote or Local. The web app only has Remote chats. See [Projects, chats, Remote and Local](/get-started/projects-and-chats).
## Other platforms
* **Other computers.** Newly for Mac needs a Mac with Apple silicon and macOS 14 or later. On any other computer, use the web app at app.newly.app.
* **Phones.** There's no Newly phone app to download. To try your app on your own iPhone, see [Testing on a real phone](/preview/test-on-a-phone).
## Related
How your work is organized and where it runs.
Your own Claude or Codex login, the Mac simulator and Design mode.