React Quickstart

Create a full-stack Base44 project with a Base44 backend and a Vite-powered React frontend

Follow this quickstart to scaffold a project, define an entity, and run your app locally. This project includes a pre-configured Base44 SDK client, UI components, and Tailwind CSS styling.

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@latest
   
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 Start from a template when prompted, then follow the prompts to configure your project, push entities, and deploy your site.

When complete, you’ll see your project name, a link to your Base44 dashboard, and your live application URL.

The generated project structure:

<your-project-name>

base44

.app.jsonc

config.jsonc

entities

task.jsonc

src

api

components

App.jsx

main.jsx

index.css

.gitignore

.nvmrc

components.json

index.html

jsconfig.json

package.json

postcss.config.js

README.md

tailwind.config.js

vite.config.js

For more information about the files in this project, see Project Structure.

This project includes an example Task entity in base44/entities/task.jsonc which was pushed to Base44 during project creation. You can modify this entity or create additional ones.

Next steps

Now that your Base44 backend is integrated with your project, you can:

• Use the SDK to add more functionality to your frontend.
• Add entities, backend functions, and agents. If you’re working in TypeScript, generate types to get autocomplete and type safety.
• Test locally with base44 dev. See Local development for setup instructions.
• Deploy updates with base44 deploy.
• Open your deployed site with base44 site open.

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.

See also

• CLI Command Reference: All available CLI commands
• Project Structure: How project resources are organized
• Entities: Learn about database schema configuration
• Example apps: Sample projects to learn from