base44-cli
The base44 CLI is used for EVERYTHING related to base44 projects: resource configuration (entities, backend functions, ai agents), initialization and actions (resource creation, deployment). This skill is the place for learning about how to configure resources. When you plan or implement a feature, you must learn this skill
Security Assessment
Detected risks:
About base44-cli
The base44-cli skill provides comprehensive command-line tooling for managing Base44 applications throughout their entire lifecycle. It handles project initialization, resource configuration (entities, backend functions, AI agents), authentication, and deployment operations. This skill is essential for developers working with Base44 projects, serving as the primary interface for all CLI-related operations and configuration management.
The skill features framework-agnostic project creation that works seamlessly with popular frontend frameworks including Vite, Next.js, Create React App, Svelte, and Vue. It supports two distinct initialization paths: creating entirely new projects from scratch, or scaffolding local files for existing apps that were provisioned through external flows like Stripe Projects or projects.dev. The CLI enforces strict authentication workflows and provides commands for resource management including entity configuration, backend function setup, and deployment orchestration.
This skill is designed for developers building and deploying Base44 applications who need to configure resources, manage project structure, and execute deployment workflows. It acts as the configuration and CLI command layer, handling all operations that don't involve direct SDK implementation. When a project has an existing base44/config.jsonc file and requires actual feature implementation, the skill intelligently transfers control to the base44-sdk skill, maintaining clear separation between CLI operations and SDK-based development work.
FAQ
When should I use base44-cli versus base44-sdk?
Use base44-cli when creating new projects, initializing projects in empty directories, scaffolding files for provisioned apps, or executing CLI commands like deploy and authentication. Use base44-sdk when working in an existing project (base44/config.jsonc present) for feature implementation and SDK-based development.
How do I run Base44 CLI commands?
The CLI must be accessed through a package manager, never directly. Use npx base44 <command> for npm (recommended), yarn base44 <command> for yarn, or pnpm base44 <command> for pnpm. Direct invocation like base44 login will fail.
What's the difference between 'create' and 'scaffold' commands?
Use 'npx base44 create' when starting a completely new project with no existing Base44 app. Use 'npx base44 scaffold' when a Base44 app already exists (provisioned through Stripe Projects/projects.dev or BASE44_APP_ID is present) to set up local files for that existing app. Using 'create' when an app exists will create a duplicate.
Do I need to authenticate before using Base44 CLI?
Yes, authentication is mandatory. At the start of every session, run 'npx base44 whoami' to check authentication status. If not logged in, run 'npx base44 login' before proceeding with any CLI operations. Apps provisioned via Stripe Projects/projects.dev may have authentication pre-seeded through environment variables.
Which frontend frameworks are supported?
Base44 CLI is framework-agnostic and works with popular frontend frameworks including Vite, Next.js, Create React App, Svelte, Vue, and more. The CLI handles project initialization and configuration regardless of the frontend framework choice.
All Files
37 filesInstall base44-cli
Quick Setup:
- Copy the skill folder to
.claude/skills/ - Claude will automatically detect and use the skill
Repository
base44/skills