Skip to main content
You can download your app’s code from Newly v2, at app.newly.app and in Newly for Mac, to your own computer. The fastest way is the Download source button in the project’s Settings: it saves a ZIP of the complete project — the React Native / TypeScript app, configuration files, assets and your Newly backend code — packed from the released branch (main). For a specific branch, an empty-folder checkout the CLI keeps linked to the project, or an automated script, use the newly command-line tool (CLI) below.

​
Download a ZIP from Settings

1

Open the project

Open the project in the web app or in Newly for Mac.
2

Open Settings

Choose Settings in the sidebar.
3

Download source

Under Project, press Download ZIP on the Download source row. Your browser (on Mac, your Downloads folder, shown in Finder) gets a <project>-source-main.zip.
The ZIP is everything Newly builds your app from, minus the folders a fresh npm install recreates (.git, node_modules, build output). It always comes from main, the released copy. To download the draft your chats are working on instead, use newly pull below (dev is its default).
One chat’s live workspace — including changes not yet committed to any branch — is a different export: open the chat’s ⋯ menu and choose Download session files.

​
Download your project with the CLI

You’ll need a computer with Node.js 20 or later and a terminal.
1

Install the CLI

2

Sign in

Sign in with your Newly account:
Or use newly login --google or newly login --github. With --email, Newly sends you a code to type into the terminal.
3

Find your project ID

Open the project in the web app. The ID is the last part of the address: app.newly.app/projects/<project-id>.
4

Pull the code

Create an empty folder, open it in your terminal, and run:
The CLI downloads the project’s app and backend code into that folder.

​
Which branch you get

By default, newly pull downloads the dev branch, which is where your chats work. If the project has no dev branch, it downloads main. See Where your code lives for how the two branches differ.

​
Options

Very large projects may be too big to download this way. If newly pull refuses a project for its size, contact support.

​
Other useful commands

  • newly whoami shows which account you’re signed in with.
  • newly logout signs you out.

​
What you can and can’t do with the code

  • You can open the code in your own editor, read it and keep a backup.
  • You can’t send app code from your computer back into a Newly project. To change the app in Newly, ask the agent in a chat.
The CLI can also deploy your Newly Backend and manage its secrets, for dev and production. See Production and secrets.
On Mac: if you want to keep working in your own editor alongside the agent, open a folder on your Mac with Open Existing Project. The agent then works directly in that folder. The folder’s path can’t contain spaces. See Local chats on your Mac.

​
GitHub

Newly v2 projects can’t connect to GitHub, and there’s no automatic sync to a GitHub repository. To put your code on GitHub, download it with newly pull and push it to a repository yourself. Remember that later changes made in Newly won’t reach GitHub unless you pull and push again.

​
The “Github to Mobile App” starter

The Github to Mobile App starter on the Home screen doesn’t import a repository. To base a new app on an existing website’s look, paste the public link to that website into the prompt box. The agent copies its style into a mobile app.

Where your code lives

Saved versions, branches and Promote to main.

Production and secrets

Deploy your backend and set secrets with the CLI.