Skip to content

Deploy to Cloudflare

  • Get your app live on the internet with Cloudflare Pages

Manual step

No Claude prompt needed. Deploy via the Cloudflare dashboard by connecting your GitHub repo directly.

1. Create a Pages Project

  1. Open the Cloudflare dashboard

  2. Click Compute in the sidebar

  3. Click Workers & Pages

  4. Click Create Application

  5. You'll see a link that says "Looking to deploy Pages? Get started" — click Get started

  6. Click Import from existing Git repository

  7. Select the correct GitHub account and then select your repository

2. Configure Build Settings and Environment Variables

Set the build configuration and add your environment variables on the same screen:

  • Framework preset: Nuxt.js
  • Build command: npm run build
  • Build output directory: dist

Add these under Environment Variables:

  • SUPABASE_URL — from your .env
  • SUPABASE_KEY — from your .env
  • SUPABASE_SECRET_KEY — from your .env

3. Deploy

Click Save and Deploy. Cloudflare will build and deploy automatically. Every future push to master triggers a redeploy.

4. Secure Your Environment Variables

After the first deploy completes, change your variables to secrets so they are not visible in the dashboard:

  1. Open your Pages project in the Cloudflare dashboard

  2. Go to Settings → Variables and Secrets

  3. For each variable, click Edit, change the type from Text to Secret, and click Save

5. Update Supabase Auth URLs

Once the first deploy succeeds:

  1. Copy your production URL from the Cloudflare Pages dashboard (e.g. https://your-project.pages.dev)
  2. In the Supabase dashboard → Authentication → URL Configuration:
    • Update the Site URL from http://localhost:3000 to your production URL
    • Add https://your-project.pages.dev/auth/callback to the Redirect URLs

6. Verify Production

  1. Visit your production URL
  2. Sign up with a new account (or use the one you created locally)
  3. Complete the onboarding flow
  4. Confirm the dashboard loads and the sidebar works
  5. Push a small change to your repo and confirm Cloudflare auto-redeploys

Custom Domain (Optional)

To use your own domain instead of *.pages.dev:

  1. Go to your Cloudflare Pages project → Custom domains
  2. Add your domain and follow the DNS setup instructions
  3. Update the Site URL and Redirect URLs in Supabase to match your custom domain

What's Next

Your app is live. From here, pick what to build:

  • Plugins — add API keys, an external API, AI chat, or cron jobs to your app
  • Examples — follow a domain-specific tutorial like job management to see the full pattern in action