Skip to main content
Link a local project to Base44. You can create a new backend project or link to an existing Base44 project, including apps built in the Base44 online app editor, such as a clone of a repo created by the GitHub integration. The command writes the project ID to your .app.jsonc file. The .app.jsonc file is gitignored, so linking is per checkout. Every fresh clone needs base44 link, or the --app-id flag, before app-scoped commands like dev can run. Use this when you have a local project but haven’t yet connected it to Base44.
If you don’t have any project files yet, use base44 create to generate a new project. The create command generates new code, while link connects existing code files to a backend. For a complete guide, see Link an Existing Backend Project.

​
Requirements

  • Must be run from a directory containing a base44/config.jsonc file.
  • Project must not already be linked. If an .app.jsonc file with an app ID already exists, the command will fail.

​
Usage

An interactive prompt will guide you through creating a new project or selecting an existing one. For a step-by-step guide on linking existing projects, see Link an Existing Backend Project.

​
Flags

​
Non-interactive usage

For scripts or CI environments, use the flags to skip prompts: Create a new project:
Create a new project in a specific workspace:
Link to an existing project. You can find the app ID in the app’s URL in the Base44 online app editor, app.base44.com/apps/<id>/...:

​
See also