Skip to main content
Export your Bloom app to get the complete source code as a ZIP file. Once exported, you can run it locally, deploy it to your own infrastructure, or continue development in your preferred IDE.
Code export is available on Starter plans and above. View pricing →

​
Downloading Your Code

Click the Download as ZIP button in your app’s workspace to export the full codebase. The export includes everything you need to run your app independently:
  • Complete monorepo structure
  • Expo frontend (apps/default/)
  • Convex backend (packages/backend/)
  • All dependencies and configuration files
  • Environment variable template (.env.example)
See App Structure for a detailed breakdown of what each file does.

​
Running Locally

After downloading, you can run your app on your own machine.

​
Prerequisites

Install these tools before getting started:

Bun

Fast JavaScript runtime and package manager. Install with curl -fsSL https://bun.sh/install | bash

Convex CLI

Backend runtime for your Convex functions. Install with bun add -g convex

​
Setup Steps

1

Unzip and open the project

Extract the ZIP file and open the folder in your terminal or IDE:
unzip your-app.zip
cd your-app
2

Install dependencies

Install all packages for the monorepo:
bun install
3

Set up environment variables

Copy the example environment file:
cp .env.example .env
Then fill in the required values:
CONVEX_DEPLOYMENT=your-deployment-name
EXPO_PUBLIC_CONVEX_URL=https://your-deployment.convex.cloud
EXPO_PUBLIC_CONVEX_SITE_URL=https://your-deployment.convex.site
You can find these values in your Convex dashboard after creating a project.
4

Start the development server

Run both the frontend and backend:
bun run dev
This starts:
  • Expo dev server for the mobile/web app
  • Convex dev server for the backend functions

​
Setting Up Your Own Convex Backend

If you want to run your app completely independently from Bloom, you’ll need to create your own Convex project.
1

Create a Convex account

Sign up at convex.dev if you don’t have an account.
2

Create a new project

From the Convex dashboard, create a new project. This gives you a fresh deployment URL.
3

Deploy your functions

From your project directory, deploy the backend:
cd packages/backend
bunx convex deploy
Follow the prompts to link your local project to your Convex deployment.
4

Update environment variables

Update your .env file with the new deployment details from your Convex dashboard.
When using your own Convex deployment, you’ll need to configure your own OAuth credentials for authentication. See the Convex Auth documentation for setup instructions.

​
Export vs GitHub Sync

Both options give you access to your code, but they serve different purposes.
FeatureExport (ZIP)GitHub Sync
Plan requiredStarter+Premium+
One-time downloadYesNo
Ongoing syncNoYes
BidirectionalNoYes
Best forSnapshots, archiving, independent hostingActive development, collaboration
Use ZIP export when you want to:
  • Archive a version of your app
  • Move to fully self-hosted infrastructure
  • Share code with someone outside your team
  • Create a backup before major changes

​
What’s Next?

App Structure

Understand how your exported code is organized

GitHub Sync

Set up bidirectional sync for ongoing development