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. There’s no Download ZIP or export button in the app. Instead, use the newly command-line tool (CLI).

​
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 development secrets. 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.