Skip to main content
Create a backend only Base44 project with entities and functions. Use this template when you want to build your own frontend or integrate with existing apps.
The CLI requires Node.js 20.19.0 or higher.

​
Setup

1

Install the Base44 CLI

Install the Base44 CLI globally:
npm install -g base44
2

Create a project

Create a new Base44 project:
base44 create
If you’re not already logged in, the command will prompt you to authenticate.Select Create a basic project when prompted, then follow the prompts to configure your project.
When complete, you’ll see your project name and a link to your Base44 dashboard. The CLI creates your project with the following structure:
<your-project-name>
base44
.app.jsonc
config.jsonc
.gitignore
Your app ID is automatically added to .app.jsonc.

​
Next steps

Now that your Base44 project is set up, you can: Your project includes Base44 skills that teach AI coding assistants how to work with Base44. You can open your project in Cursor, Claude Code, or your preferred AI assistant and describe what you want to build.

​
Build a frontend

Create a frontend app using your preferred framework. Install the Base44 JavaScript SDK: 
npm install @base44/sdk
Configure the SDK client with your app ID (from base44/.app.jsonc) and use it to interact with your entities: 
import { createClient } from '@base44/sdk';

const base44 = createClient({
  appId: 'your-app-id'
});

const tasks = await base44.entities.Task.list();
Learn more in the JavaScript SDK documentation.

​
Local development

Most frontend frameworks support local development servers with hot reloading. Through the SDK, your local frontend will connect to Base44’s hosted backend. Entity and function changes must be deployed to Base44 using deploy before they appear in your local app.

​
Deploying your frontend

If you want to deploy your frontend to Base44’s hosting platform, configure the outputDirectory in your base44/config.jsonc: 
{
  "name": "basic-test-app",
  
  // Site/hosting configuration
  "site": {
    "outputDirectory": "./dist"
  }
}
The outputDirectory tells the CLI where your build tool outputs the compiled files. Build your frontend, then deploy with the site deploy command.

​
See also