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.
ScenarioCommand
Starting fresh, no base44/ foldernpx base44 create
Have base44/config.jsonc but no .app.jsoncnpx base44 link
Project already linked (has .app.jsonc)Already done, use deploy

​
Syntax

npx base44 link [options]

​
Options

OptionDescriptionRequired
-c, --createCreate a new project (skip selection prompt)No
-n, --name <name>Project name (required when --create is used)With --create
-d, --description <description>Project descriptionNo
--app-id <id>App ID to link to an existing project (global flag, skips selection prompt)No

​
Non-Interactive Mode

For CI/CD or agent use: Create a new project: 
npx base44 link --create --name my-app
Link to an existing app: 
npx base44 link --app-id <app-id>
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

# Interactive mode - prompts for project details
npx base44 link

# Non-interactive - create and link in one step
npx base44 link --create --name my-app

# With description
npx base44 link --create --name my-app --description "My awesome app"

# Link to a specific existing project by ID
npx base44 link --app-id abc123

​
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

​
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)