Documentation
Feedback
Guides
App Development

App Development
Local development
Linking an app

For development, an app can be linked to a development workspace so that any local code change can be automatically synced and made available in that corresponding workspace.

Linking an app to a production workspace is not possible.

Step by step

  1. Open the terminal and log in to your VTEX account.

_10
vtex login {account}

  1. Change to a development workspace.

_10
vtex use {workspace}

  1. Change to your app's directory.

_10
cd {directory}

  1. Link your app to the current workspace by running the following command:

_10
vtex link

Once your local files are uploaded and synced to your development environment, you should see the following message: App linked successfully. Use https://{workspace}--{account}.myvtex.com, where workspace is the development workspace in use and account is the name of your VTEX account, to check your local version of the app.

Notice that the synced app will only be available within the specified development workspace.

If you are comfortable with your changes and want to make your changes publicly available, please refer to this guide.

Contributors
2
Photo of the contributor
Photo of the contributor
+ 2 contributors
Was this helpful?
Yes
No
Suggest edits (Github)
Contributors
2
Photo of the contributor
Photo of the contributor
+ 2 contributors
On this page