The CLI requires Node.js 20.19.0 or higher.
Setup
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
.app.jsonc.
Next steps
Now that your Base44 project is set up, you can:- Add entities, backend functions, and agents. If you’re working in TypeScript, generate types to get autocomplete and type safety.
- Build or connect a frontend application using the SDK.
- Deploy updates with
base44 deploy.
Build a frontend
Create a frontend app using your preferred framework. Install the Base44 JavaScript SDK:base44/.app.jsonc) and use it to interact with your entities:
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. You can also runbase44 dev to start a local development server that handles backend functions, entities, and media uploads on your machine. This lets you test changes without deploying. See Local development for details.
Deploy your frontend
If you want to deploy your frontend to Base44’s hosting platform, configure theoutputDirectory in your base44/config.jsonc:
outputDirectory tells the CLI where your build tool outputs the compiled files. Build your frontend, then deploy with the site deploy command.
See also
- Project Structure: How project files are organized
- CLI Command Reference: All available CLI commands
- JavaScript SDK: Connect your app to the backend
- Example apps: Sample projects to learn from

