Skip to main content
Base44 apps are standard React apps built with Vite. Your project includes modern web development tools and seamless Base44 backend integration.

Project structure

In the Code Tab and when you connect to GitHub, you’ll see the complete React/Vite project structure:
src
pages
api
hooks
lib
utils
entities
functions
package.json
vite.config.js
tailwind.config.js
index.html

Project directories

Your project contains the following directories:
  • src/ - Frontend app code organized into these directories:
    • pages - The pages in your app. Each file is a route. Home.jsx becomes /, Settings.jsx becomes /settings.
    • components - Reusable UI elements. The ui/ subfolder contains pre-built UI components.
    • api - Base44 SDK client configuration for communicating with your backend.
    • hooks - Custom React hooks for UI and state management.
    • lib - Base44 integration and app configuration code.
    • utils - Utility functions and helper methods.
  • entities/ - Your data model definitions. Each entity has a JSON schema file that defines its fields.
  • functions/ - Backend functions for backend logic. Each TypeScript file in this directory is a separate function.
Entities: When using GitHub 2-way integration, entities are managed in Base44 and are not included in your local repository.

Configuration files

The root directory includes all the configuration needed to run independently:
  • package.json - Dependencies and scripts (includes @base44/sdk)
  • vite.config.js - Build configuration with Base44 plugin
  • tailwind.config.js - Styling configuration
  • index.html - Main HTML entry point

Run locally

To run the exported project locally: npm install then npm run dev.