fix(dev): scaffold apps with the injected local dev server URL

[davidsu]

Note

Description

Newly scaffolded backend-and-client apps ignored the local dev backend because the generated Base44 client had no way to point at it. This PR wires the client template to read the VITE_BASE44_APP_BASE_URL env var that base44 dev injects (pointing at http://localhost:<port>), so scaffolded apps talk to the local dev server during development while still falling back to the SDK default in production builds.

Related Issue

None

Type of Change

• Bug fix (non-breaking change which fixes an issue)
• New feature (non-breaking change which adds functionality)
• Breaking change (fix or feature that would cause existing functionality to not work as expected)
• Documentation update
• Refactoring (no functional changes)
• Other (please describe):

Changes Made

• Set serverUrl: import.meta.env.VITE_BASE44_APP_BASE_URL || undefined on the generated createClient() call in the backend-and-client template (base44Client.js.ejs).
• Added an explanatory comment clarifying that the URL is injected by base44 dev and is unset in production builds, so the SDK falls back to its default server.

Testing

• I have tested these changes locally
• I have added/updated tests as needed
• All tests pass (`npm test`)

Checklist

• My code follows the project's style guidelines
• I have performed a self-review of my own code
• I have commented my code, particularly in hard-to-understand areas
• I have made corresponding changes to the documentation (if applicable)
• My changes generate no new warnings
• I have updated `docs/` (AGENTS.md) if I made architectural changes

Additional Notes

The env var name matches what the dev server sets in packages/cli/src/cli/dev/dev-server/main.ts (VITE_BASE44_APP_BASE_URL). This is a template-only change; existing generated projects are unaffected until re-scaffolded.

---

_{🤖 Generated by Claude | 2026-07-20 12:36 UTC | 8e6eea5}

[github-actions]

🚀 Package Preview Available!

---

Install this PR's preview build with npm:

npm i @base44-preview/cli@0.1.5-pr.571.4d6a59e

Prefer not to change any import paths? Install using npm alias so your code still imports base44:

npm i "base44@npm:@base44-preview/cli@0.1.5-pr.571.4d6a59e"

Or add it to your package.json dependencies:

{
  "dependencies": {
    "base44": "npm:@base44-preview/cli@0.1.5-pr.571.4d6a59e"
  }
}

• 📦 Preview Package: @base44-preview/cli@0.1.5-pr.571.4d6a59e
• 🔗 View this commit on GitHub

---

_{Preview published to npm registry — try new features instantly!}