CLI local dev full proxy #226

artemdemo · 2026-02-10T13:06:26Z

Note

Description

This PR adds a new base44 dev command that starts a local development server proxying to the production Base44 API. The dev server enables local frontend development with CORS support, OAuth redirect handling, and automatic port selection when the default port (4400) is already in use.

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

Added base44 dev command (src/cli/commands/dev.ts) with optional --port flag
Implemented Express-based development server (src/cli/dev/dev-server/main.ts) with:
- Full proxy to https://base44.app for API requests
- CORS configuration allowing localhost origins with credentials
- OAuth route redirection (direct redirect instead of proxy to preserve session cookies)
- Automatic port detection (defaults to 4400, finds available port if occupied)
- Error handling for port conflicts (EADDRINUSE)
Updated build configuration (infra/build.ts) to support multiple build targets
Added dependencies: express, cors, http-proxy-middleware, get-port, and their TypeScript types
Added .editorconfig for consistent code formatting across editors
Registered dev command in program as hidden feature

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 AGENTS.md if I made architectural changes

Additional Notes

The dev server is marked as hidden: true in the CLI program, indicating this is an experimental or internal-use feature. The server redirects OAuth authentication routes directly to base44.app rather than proxying them, which preserves the OAuth flow and session cookie handling required by authentication providers.

The port handling logic gracefully handles the case where port 4400 is already in use, automatically finding the next available port using the get-port package.

_{🤖 Generated by Claude | 2026-02-11 19:28 UTC}

github-actions · 2026-02-10T14:33:12Z

🚀 Package Preview Available!

Install this PR's preview build with npm:

npm i @base44-preview/cli@0.0.31-pr.226.5f9b2b0

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.0.31-pr.226.5f9b2b0"

Or add it to your package.json dependencies:

{
  "dependencies": {
    "base44": "npm:@base44-preview/cli@0.0.31-pr.226.5f9b2b0"
  }
}

📦 Preview Package: @base44-preview/cli@0.0.31-pr.226.5f9b2b0
🔗 View this commit on GitHub

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

artemdemo · 2026-02-10T13:07:14Z

infra/build.ts

-      formatOutput(result.outputs)
-    );
+    const { cli } = await runAllBuilds();
+    for (const result of [cli]) {


This is a preparation for additional entry

artemdemo · 2026-02-11T06:45:46Z

@claude review

artemdemo · 2026-02-11T08:13:12Z

.editorconfig

this will help automatically to deal with lint errors regarding "non empty last line in file"

claude · 2026-02-11T08:57:13Z

Code review

No issues found. Checked for bugs and CLAUDE.md compliance.

kfirstri · 2026-02-11T10:00:35Z

src/cli/dev/dev-server/main.ts

+  const AUTH_LOGIN_PATTERN = /^\/api\/apps\/auth(\/\w+)?\/login/;
+  app.use((req, res, next) => {
+    if (AUTH_LOGIN_PATTERN.test(req.path)) {
+      const targetUrl = `https://base44.app${req.originalUrl}`;


Consider using new URL, then we can do something like

// save the base url const BASE44_APP_URL = 'https://base44.app'; new URL(req.originalUrl, BASE44_APP_URL)

kfirstri · 2026-02-11T10:01:41Z

src/cli/dev/dev-server/main.ts

+  // (redirects + session cookies) works correctly. Proxying breaks OAuth
+  // because the session cookie ends up on localhost while Google's callback
+  // goes to base44.app.
+  const AUTH_LOGIN_PATTERN = /^\/api\/apps\/auth(\/\w+)?\/login/;


let's test/check if there's a signup url we need to handle

artemdemo · 2026-02-11T10:49:12Z

src/cli/dev/dev-server/main.ts

+  const AUTH_LOGIN_PATTERN = /^\/api\/apps\/auth(\/\w+)?\/login/;
+  app.use((req, res, next) => {
+    if (AUTH_LOGIN_PATTERN.test(req.path)) {
+      const targetUrl = `https://base44.app${req.originalUrl}`;


artemdemo · 2026-02-11T11:43:36Z

src/cli/dev/dev-server/main.ts

+  // (redirects + session cookies) works correctly. Proxying breaks OAuth
+  // because the session cookie ends up on localhost while Google's callback
+  // goes to base44.app.
+  const AUTH_LOGIN_PATTERN = /^\/api\/apps\/auth(\/\w+)?\/login/;


artemdemo · 2026-02-11T12:00:46Z

src/cli/dev/dev-server/main.ts

+  return new Promise((resolve, reject) => {
+    const server = app.listen(port, "127.0.0.1", (err) => {
+      if (err) {
+        if ("code" in err && err.code === "EADDRINUSE") {
+          reject(
+            new Error(
+              `Port ${port} is already in use. Stop the other process and try again.`,
+            ),
+          );
+        } else {
+          reject(err);
+        }
+      } else {
+        resolve({
+          port,
+          server,
+        });
+      }
+    });
+  });


In case of error it will look like this:

end process will exit

artemdemo · 2026-02-11T12:10:28Z

.vscode/extensions.json

+{
+  "recommendations": ["biomejs.biome"]
+}


plugin needed for correct work.
Without it nothing will correctly happened and it will be the same experience as before - only lints when you run bun run lint:fix

artemdemo · 2026-02-11T12:10:42Z

.vscode/settings.json

+    "editor.defaultFormatter": "biomejs.biome"
+  },
+  "[jsonc]": {
+    "editor.defaultFormatter": "biomejs.biome"


Missed it last time, should be explicit

kfirstri · 2026-02-11T12:50:37Z

src/cli/dev/dev-server/main.ts

+import express from "express";
+import { createProxyMiddleware } from "http-proxy-middleware";
+
+const DEFAULT_PORT = 3000;


let's do port 4400 :P

kfirstri · 2026-02-11T12:51:42Z

src/cli/dev/dev-server/main.ts

+  const AUTH_ROUTE_PATTERN = /^\/api\/apps\/auth(\/|$)/;
+  app.use((req, res, next) => {
+    if (AUTH_ROUTE_PATTERN.test(req.path)) {
+      const targetUrl = `${BASE44_APP_URL}${req.originalUrl}`;


consider new URL

kfirstri

U R GREAT

artemdemo commented Feb 10, 2026

View reviewed changes

artemdemo marked this pull request as ready for review February 10, 2026 14:35

artemdemo force-pushed the cli-local-dev-full-proxy branch from cdbd97e to 75699b5 Compare February 11, 2026 06:44

base44 deleted a comment from claude bot Feb 11, 2026

artemdemo commented Feb 11, 2026

View reviewed changes

.editorconfig

Copy link

Contributor Author

artemdemo Feb 11, 2026

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

this will help automatically to deal with lint errors regarding "non empty last line in file"

base44 deleted a comment from claude bot Feb 11, 2026

artemdemo requested a review from kfirstri February 11, 2026 08:58

artemdemo enabled auto-merge (squash) February 11, 2026 08:59

kfirstri added this to CLI Development Feb 11, 2026

github-project-automation bot moved this to Backlog in CLI Development Feb 11, 2026

artemdemo force-pushed the cli-local-dev-full-proxy branch from 75afbfa to 6ef1465 Compare February 11, 2026 09:34

kfirstri reviewed Feb 11, 2026

View reviewed changes

artemdemo added 9 commits February 11, 2026 12:44

Local development - full proxy

3f5e4bc

lint

b5adb6d

error handling

f146a07

simplify

da401f7

removed stuff to simplify more

2d01152

fix

a45bdf3

upd lock

a0fa231

upd

480a23b

upd

3eca575

artemdemo added 8 commits February 11, 2026 12:44

fixes

a8081af

fix

52ee7bd

fix

010c8d1

fix

2ddd8fd

hidden

f96811a

fix

8e085f7

BASE44_APP_URL

6bc6400

upd

a452cc1

artemdemo force-pushed the cli-local-dev-full-proxy branch from 4d73f20 to a452cc1 Compare February 11, 2026 11:44

artemdemo added 4 commits February 11, 2026 13:45

comment

61ee7da

handle error

1d40c86

error handler

6cf1543

upd

faa4189

artemdemo commented Feb 11, 2026

View reviewed changes

kfirstri reviewed Feb 11, 2026

View reviewed changes

artemdemo added 4 commits February 11, 2026 16:32

port

293b64a

port handling

91e5cb9

URL constructor

e302423

lint

62071ce

kfirstri approved these changes Feb 11, 2026

View reviewed changes

github-project-automation bot moved this from Backlog to In review in CLI Development Feb 11, 2026

artemdemo merged commit 2df66a8 into main Feb 11, 2026
4 of 8 checks passed

artemdemo deleted the cli-local-dev-full-proxy branch February 11, 2026 15:07

github-project-automation bot moved this from In review to Done in CLI Development Feb 11, 2026

CLI local dev full proxy #226

CLI local dev full proxy #226

Uh oh!

Conversation

artemdemo commented Feb 10, 2026 • edited by claude bot Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Description

Related Issue

Type of Change

Changes Made

Testing

Checklist

Additional Notes

Uh oh!

github-actions bot commented Feb 10, 2026 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

🚀 Package Preview Available!

Uh oh!

Choose a reason for hiding this comment

Uh oh!

artemdemo commented Feb 11, 2026

Uh oh!

Choose a reason for hiding this comment

Uh oh!

claude bot commented Feb 11, 2026

Code review

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

kfirstri left a comment

Choose a reason for hiding this comment

Uh oh!

Uh oh!

Reviewers

Assignees

Labels

Projects

Milestone

Development

Uh oh!

2 participants

artemdemo commented Feb 10, 2026 •

edited by claude bot

Loading

github-actions bot commented Feb 10, 2026 •

edited

Loading