Skip to main content
This page is part of an AI coding agent skill and is written for agents, not humans. For the human-readable Base44 docs, see the developer documentation.

​
base44 link

Links an existing local Base44 project to a Base44 app in the cloud. Use this when you have a base44/config.jsonc but haven’t connected it to a Base44 app yet.

​
Syntax

​
Options

​
Non-Interactive Mode

For CI/CD or agent use: Create a new project:
Link to an existing app:
WRONG: npx base44 link --create (missing —name) WRONG: npx base44 link --create --app-id <id> (cannot use both) RIGHT: npx base44 link --create --name my-app RIGHT: npx base44 link --app-id <id>

​
Examples

​
What It Does

  1. Finds the base44/config.jsonc in the current directory (or parent directories)
  2. Verifies no .app.jsonc exists (project not already linked)
  3. Either:
    • Creates a new Base44 app in the cloud (with --create), OR
    • Links to an existing app (with --app-id or interactive selection)
  4. Writes the app ID to base44/.app.jsonc
The interactive selection (and --app-id) lists all of your existing Base44 apps, including ones originally built in the Base44 editor — not just apps previously created via the CLI.

​
Requirements

  • Must have base44/config.jsonc in the project
  • Must NOT have base44/.app.jsonc (use deploy if already linked)
  • Must be authenticated (run npx base44 login first)

​
Notes

  • After linking, you can deploy resources with npx base44 deploy
  • The .app.jsonc file should be git-ignored (contains your app ID)