Getting a complete Base44 export instead of a preview build
React application export
Base44 apps export as React projects. The presentation layer converts well; app logic backed by Base44's platform does not travel.
Quick answer
Export the Base44 app from the project settings, zip the downloaded folder and upload it — the engine renders the React app before converting.
Where do I find the ZIP?
- Open your Base44 app and go to the project/export settings
- Download the application source or connect the project to GitHub
- Keep package.json and the source folder together
- Upload the ZIP or paste the GitHub repository URL
What your upload should contain
package.jsonsrc/index.htmlpublic/ assets
Base44 troubleshooting
Pages behind login are missing
Only public routes are converted. Move any content you need into public pages before exporting.
Data-driven lists are empty
Base44 entities load from its backend. Hard-code the content you want in the theme or rebuild it with a WordPress custom post type.
Blank render
The runtime render pass handles client-only apps; verify the app boots locally without backend errors first.
Best practices before exporting
- Export the full project, not a single screen
- Replace platform data calls with static content
- Keep the design system files in the export
- Verify the project builds locally
How to export
Method 1 — Project export ZIP (best result)
- Open the app in Base44
- Use the export/download code option
- Keep the ZIP intact
- Upload it to the converter
Method 2 — GitHub
- Connect the project to GitHub
- Push the latest version
- Paste the repository URL into the converter
Method 3 — Build output
- Run the build locally
- Zip the dist/ folder
- Upload it
Accepted input
- ZIP archive
- GitHub repository
- Static export
- Source project
- Build output
Not recommended
- Old build folders from a previous version of the project
- Incomplete exports that are missing package.json or index.html
- Screenshots, Figma files, PSD files or design mockups
- node_modules — always exclude it, it makes uploads slow and adds nothing
Supported features
- React pages and layout
- Design tokens and CSS
- Static assets
- Client routing
Unsupported features
- Base44 data layer
- Platform authentication
- Server workflows
Common mistakes
- Exporting only a partial screen
- Leaving platform SDK calls that fail during build
- Missing environment placeholders
Conversion tips
- Strip the SDK provider from the root component before export
- Give each screen a real route path
Readiness checklist
- Navigation — Use real anchor links with readable labels. Menus built purely from JavaScript state are harder to map to WordPress menu locations.
- Images — Reference images from your project folder (imports or /public). Images loaded from a temporary preview host may not be reachable at conversion time.
- Assets — Fonts, icons and CSS should live inside the project. Locally hosted assets are copied into the theme automatically.
- Forms — Standard form markup is converted to Contact Form 7 or WPForms. Custom JavaScript submit handlers are replaced by the WordPress form handler.
- Routing — Every route you want as a WordPress page must be reachable from the navigation, a sitemap or a route manifest.
- Animations — CSS animations and common libraries survive. Heavy scroll-timeline or canvas effects may render differently in WordPress.
- SEO — Titles, meta descriptions and canonical tags are extracted per page and mapped into the theme and your SEO plugin.
- Responsive — Breakpoints are preserved as-is. Check mobile before exporting — the converter never fixes a layout that was already broken.
Base44 FAQ
Does my Base44 data come along?
No. The conversion produces a WordPress theme from the presentation layer; data must be recreated in WordPress.
Can I upload GitHub?
Yes, if you have connected the project to a repository.
Does Base44 data convert?
No. Entities and workflows are backend features; the converted theme keeps layout and static content.
Which pipeline is used?
The runtime-rendered pipeline, which boots the app in a headless browser and captures each route.
Can I convert only the marketing pages?
Yes, and it is the recommended approach for app-style Base44 projects.
Do I need to install anything to convert a Base44 project?
No. Everything runs server-side. You upload a ZIP or paste a repository URL and receive a WordPress theme ZIP plus a live preview in the browser.
Should I remove node_modules before uploading?
Yes, always. node_modules is reinstalled during conversion, so including it only makes the upload slow and can push you over the size limit.
Can I preview the result before paying?
Yes. The WordPress preview is free for every conversion. Payment is only required when you download the theme ZIP.
What happens to my forms?
Standard HTML form markup is mapped to Contact Form 7 or WPForms shortcodes. Custom JavaScript submit handlers are replaced by the WordPress form handler.
Will my SEO titles and meta descriptions survive?
Yes. Titles, meta descriptions and canonical tags are extracted per page and written into the theme templates so your SEO plugin can take over.