Skip to main content

Documentation Index

Fetch the complete documentation index at: https://botflow.io/docs/llms.txt

Use this file to discover all available pages before exploring further.

Botflow deploys to Cloudflare Pages — a global edge network with data centres in 300+ cities. Your app is served from the closest location to each visitor, with no server management required.

​
Publishing for the first time

  1. Click the Publish button in the top-right corner of the workspace toolbar.
  2. The publish panel slides open.
  3. Click Deploy (or the equivalent button for your project type).
Botflow will:
  • Run your project’s build command (pnpm run build) inside the WebContainer
  • Upload the compiled output to Cloudflare Pages
  • Return a unique URL like https://your-project-name.pages.dev
The first deploy usually takes 15–45 seconds depending on build time. Subsequent deploys are faster because unchanged assets are cached.

​
Re-deploying

After the first deploy, the Publish panel shows your current deployment URL. Click Deploy again at any time to push the latest changes from your WebContainer to Cloudflare. You don’t need to commit to GitHub first — the build runs directly from your in-browser filesystem.
Re-deploying does not take your app offline. Cloudflare swaps to the new version atomically once the upload completes.

​
Deployment URL

Every published project gets a stable URL at *.pages.dev. This URL is permanent for the project — re-deploying updates the content but keeps the same address. The URL is shown in the Publish panel and can be copied directly. Share it with anyone — they don’t need a Botflow account to view your app.

​
Custom domains (Pro and Max)

Pro and Max plan users can attach a custom domain to any published project.

​
Adding a domain

  1. Open the Publish panel.
  2. In the Custom Domain section, enter your domain (e.g. myapp.com or app.mycompany.com).
  3. Click Save.
  4. Botflow will show you a CNAME record to add in your DNS provider:
TypeNameValue
CNAME@ or appyour-pages-project.pages.dev
  1. Add the record in your domain registrar or DNS provider (Cloudflare, Namecheap, Route 53, etc.).
  2. Botflow polls for the DNS change. Once it detects the CNAME, it provisions an SSL certificate automatically.
DNS propagation typically takes a few minutes but can take up to 24 hours in some configurations.

​
Domain status

The Publish panel shows the current status of your custom domain:
  • Pending — Botflow is waiting to detect the DNS record
  • Active — the domain is live and SSL is provisioned
  • Error — DNS is not configured correctly; check the CNAME record

​
Removing a domain

Click the trash icon next to the domain in the Publish panel to remove it. Your app continues to be available at the *.pages.dev URL.

​
Build requirements

Botflow runs your project’s build command and uploads the output directory. Make sure:
  • Your package.json has a build script (e.g. "build": "vite build")
  • The build output goes to a standard directory (dist/, out/, .next/ — Botflow auto-detects these)
  • All required environment variables are set in the ENV panel
Build errors will be shown in the Publish panel. If your app builds locally (in the terminal) but fails during deploy, check that all required environment variables are set.

​
Publishing mobile / native builds

For Universal (Expo) projects, the Publish panel has two sections:
  • Web deploy — same Cloudflare Pages flow as above, deploys the web build (expo export)
  • Native builds — iOS and Android builds via Expo EAS Build (coming soon)
The web deploy gives you a working browser version immediately. Native builds produce .ipa and .apk files that can be submitted to the App Store and Google Play.