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 entities push

Push local entity definitions to Base44.

Syntax

Options

Authentication

Required: Yes. If not authenticated, you’ll be prompted to login first.

What It Does

  1. Pushes all entities that exist in the base44/entities folder
  2. Validates that entities exist in the folder
  3. Displays the count of entities to be pushed
  4. Asks for confirmation before overwriting remote entities (unless -y/--yes is passed)
  5. Uploads entities to the Base44 backend
  6. Reports the results: created, updated, and deleted entities

Prerequisites

  • Must be run from a Base44 project directory
  • Project must have entity definitions in the base44/entities folder

Confirmation Prompt

This push overwrites your app’s entities with your local copy and deletes any not present locally. Before pushing, the CLI warns you and asks for confirmation:
In non-interactive mode (--json, CI/CD, no TTY), you must pass -y/--yes or the command throws.

Output

Entity Synchronization

The push operation synchronizes your local entity schema with Base44:
  • Created: New entities that didn’t exist in Base44
  • Updated: Existing entities with modified schema or configuration
  • Deleted: Entities that were removed from your local configuration

Error Handling

If no entities are found in your project:

Use Cases

  • After defining new entities in your project
  • When modifying existing entity schemas
  • To sync entity changes before deploying
  • As part of your development workflow when data models change

Notes

  • This command syncs the entity schema/structure, not the actual data
  • Changes are applied to your Base44 project immediately
  • Make sure to test entity changes in a development environment first
  • Entity definitions are located in the base44/entities/ directory