Skip to content

04. Deploy Frontend Pages

Path B (Dev Console) — This chapter is for the Dev Console workflow. If you prefer CLI commands, see Path A: Deploy Frontend Pages.

Deploy the core frontend apps only: apps/web and apps/admin. Pages projects are created automatically by the Dev Console when you deploy.

In Dev Console → Deploy tab → Pipeline:

  1. Ensure backend deployment (step 3) is complete.
  2. Run step 5 (Deploy Frontend). The Dev Console will build and deploy both web and admin in sequence.
  3. Or use the canvas: click the Build & Deploy button on each frontend app card (web, admin).

Dev Console Deploy tab — frontend Pages build & deploy

2. Configure frontend environment variables

Section titled “2. Configure frontend environment variables”

After the first deployment:

  1. In Dev Console → Deploy tab → Frontend Secrets or Environment section.
  2. Set apps/web to point to:
    • Correct backend service URLs
    • Expected app_key
    • Any required public environment values for login or site configuration
  3. Set apps/admin to point to auth-related URLs and service endpoints.

Use repository defaults first, verify the system works, then customize.

A warning about an invalid SESSION binding usually means the Cloudflare KV binding is not configured yet:

  • Check the Wrangler binding configuration
  • Check Cloudflare Pages or Worker environment bindings
  • Ensure the target environment matches the one you prepared earlier

4. Checklist before you leave this chapter

Section titled “4. Checklist before you leave this chapter”
  • Both Pages projects created (automatically by Dev Console)
  • apps/web deployed successfully
  • apps/admin deployed successfully
  • Critical frontend environment variables are filled
  • SESSION warning understood and resolved if it was real

Once those are done, you can move on to domains and production URLs.