feat: add portless integration for local HTTPS development

Switch local development from localhost ports to portless HTTPS domains
on .local.conar.app. Updates dev scripts, env examples, CORS/trusted
origins, and removes hardcoded port configuration from Vite and servers.

Co-authored-by: Valerii Strilets <letstri@users.noreply.github.com>

Author: cursoragent

README.md

@@ -73,11 +73,21 @@ Conar is an AI-powered open-source project that simplifies database interactions
 
 - **🚀 Run the Project**
 
-  This will start all development servers using Turbo.
+  This starts all development servers through [portless](https://portless.sh) (HTTPS on `.local.conar.app` domains):
+
+  | Service | URL |
+  | --- | --- |
+  | API | https://api.local.conar.app |
+  | App | https://app.local.conar.app |
+  | Main | https://main.local.conar.app |
+  | Proxy | https://proxy.local.conar.app |
+
   ```bash
   pnpm run dev
   ```
 
+  To run a single app without Turbo, `cd` into its directory and run `pnpm run dev:app` (or `dev:server`, `dev:main`, `dev:proxy`).
+
 ## Testing
 
 - **Unit Tests**

apps/api/.env.example

@@ -1,5 +1,5 @@
-API_URL=http://localhost:3000
-MAIN_URL=http://localhost:3002
+API_URL=https://api.local.conar.app
+MAIN_URL=https://main.local.conar.app
 DATABASE_URL=postgresql://postgres:postgres@localhost:5432/conar
 ALERTS_EMAIL=
 ENCRYPTION_SECRET=example

apps/api/index.ts

@@ -5,7 +5,6 @@ import { anthropic } from '@ai-sdk/anthropic'
 import { google } from '@ai-sdk/google'
 import { openai } from '@ai-sdk/openai'
 import { xai } from '@ai-sdk/xai'
-import { PORTS } from '@conar/shared/constants'
 import { ORPCError, ValidationError } from '@orpc/server'
 import { RPCHandler } from '@orpc/server/fetch'
 import { generateText } from 'ai'
@@ -65,11 +64,9 @@ const app = new Hono<{
   .use(cors({
     origin(origin) {
       const allowedOrigins = [
-        env.MAIN_URL,
-        ...(nodeEnv === 'development' ? [`http://localhost:${PORTS.DEV.DESKTOP}`, `http://localhost:${PORTS.DEV.APP}`, `http://localhost:${PORTS.DEV.PROXY}`] : []),
-        ...(nodeEnv === 'test' ? [`http://localhost:${PORTS.TEST.DESKTOP}`, `http://localhost:${PORTS.TEST.APP}`, `http://localhost:${PORTS.TEST.PROXY}`] : []),
+        'https://conar.app',
       ]
-      return origin.endsWith(`.${new URL(env.MAIN_URL).host}`) || allowedOrigins.includes(origin) ? origin : null
+      return origin.endsWith('.conar.app') || allowedOrigins.includes(origin) ? origin : null
     },
     credentials: true,
   }))
@@ -237,7 +234,12 @@ const app = new Hono<{
 
 export default {
   fetch: app.fetch,
-  port: process.env.PORT
-    ? Number(process.env.PORT)
-    : nodeEnv === 'test' ? PORTS.TEST.API : PORTS.DEV.API,
+  port: Number(process.env.PORT || 3000),
+  // Electric live shape requests (`live=true`) long-poll: Electric holds the
+  // connection open (~20 s) until new data arrives or the poll window elapses.
+  // Bun's default 30 s idle timeout can close these mid-poll, so portless sees
+  // a reset and serves its 502 page. Raise the ceiling above the poll window
+  // (255 s is Bun's max) so legitimate polls survive while truly stuck sockets
+  // still time out.
+  idleTimeout: 255,
 }

apps/api/lib/auth.ts

@@ -4,7 +4,7 @@ import { db } from '@conar/db'
 import { users } from '@conar/db/schema'
 import * as schema from '@conar/db/schema'
 import { infisical } from '@conar/infisical'
-import { API_KEY_PERMISSIONS, AUTH_COOKIE_PREFIX, PORTS } from '@conar/shared/constants'
+import { API_KEY_PERMISSIONS, AUTH_COOKIE_PREFIX } from '@conar/shared/constants'
 import { betterAuth } from 'better-auth'
 import { emailHarmony } from 'better-auth-harmony'
 import { createAuthMiddleware } from 'better-auth/api'
@@ -16,8 +16,6 @@ import { env, nodeEnv } from '~/env'
 import { resend, sendEmail } from '~/lib/resend'
 import { redisMemoize } from './redis'
 
-const mainUrl = new URL(env.MAIN_URL)
-
 export const auth = betterAuth({
   appName: 'Conar',
   secret: env.BETTER_AUTH_SECRET,
@@ -186,17 +184,15 @@ export const auth = betterAuth({
     },
   },
   trustedOrigins: [
-    env.MAIN_URL,
-    `${mainUrl.protocol}//*.${mainUrl.host}`,
+    'https://conar.app',
+    'https://*.conar.app',
     'file://',
-    ...(nodeEnv === 'development' ? [`http://localhost:${PORTS.DEV.DESKTOP}`, `http://localhost:${PORTS.DEV.APP}`] : []),
-    ...(nodeEnv === 'test' ? [`http://localhost:${PORTS.TEST.DESKTOP}`, `http://localhost:${PORTS.TEST.APP}`] : []),
   ],
   advanced: {
     cookiePrefix: AUTH_COOKIE_PREFIX,
     crossSubDomainCookies: {
-      enabled: nodeEnv === 'production',
-      domain: mainUrl.host,
+      enabled: true,
+      domain: 'conar.app',
     },
     database: {
       generateId: 'uuid',

apps/api/package.json

@@ -1,9 +1,10 @@
 {
   "name": "@conar/api",
   "type": "module",
+  "portless": "api.local.conar",
   "scripts": {
-    "dev": "cross-env NODE_ENV=development bun --watch run ./index.ts",
-    "start": "cross-env NODE_ENV=production bun run ./index.ts",
+    "dev": "portless run cross-env NODE_ENV=development BUN_CONFIG_MAX_HTTP_REQUESTS=4096 bun --watch run ./index.ts",
+    "start": "cross-env NODE_ENV=production BUN_CONFIG_MAX_HTTP_REQUESTS=4096 bun run ./index.ts",
     "check-types": "tsgo",
     "test:start": "cross-env NODE_ENV=test bun --env-file=.env.test drizzle-kit migrate && cross-env NODE_ENV=test bun --env-file=.env.test run ./index.ts",
     "better-auth:generate": "cross-env NODE_ENV=development pnpx https://pkg.pr.new/auth@9489 generate --output ../../packages/db/schema/auth.ts"

apps/app/.env.example

@@ -1,5 +1,5 @@
-VITE_PUBLIC_API_URL=http://localhost:3000
-VITE_PUBLIC_WEB_URL=http://localhost:3001
-VITE_PUBLIC_MAIN_URL=http://localhost:3002
-VITE_PUBLIC_PROXY_URL=http://localhost:3004
+VITE_PUBLIC_API_URL=https://api.local.conar.app
+VITE_PUBLIC_WEB_URL=https://app.local.conar.app
+VITE_PUBLIC_MAIN_URL=https://main.local.conar.app
+VITE_PUBLIC_PROXY_URL=https://proxy.local.conar.app
 VITE_PUBLIC_POSTHOG_TOKEN=

apps/app/package.json

@@ -1,9 +1,9 @@
 {
   "name": "@conar/app",
   "type": "module",
-  "private": true,
+  "portless": "app.local.conar",
   "scripts": {
-    "dev": "vite dev",
+    "dev": "portless run vite dev",
     "build": "vite build",
     "build:desktop": "vite build --mode desktop",
     "start": "serve -s dist -l $PORT",

apps/app/playwright.config.ts

@@ -1,12 +1,11 @@
-import { PORTS } from '@conar/shared/constants'
 import { defineConfig, devices } from '@playwright/test'
 
 export default defineConfig({
   testDir: './e2e',
   fullyParallel: true,
   reporter: [['html', { open: 'never' }]],
   use: {
-    baseURL: `http://localhost:${PORTS.TEST.DESKTOP}`,
+    baseURL: 'https://app.conar.localhost',
     trace: 'on-first-retry',
   },
   projects: [

apps/app/vite.config.ts

@@ -3,7 +3,6 @@ import tailwindcss from '@tailwindcss/vite'
 import { tanstackRouter } from '@tanstack/router-plugin/vite'
 import react, { reactCompilerPreset } from '@vitejs/plugin-react'
 import { defineConfig } from 'vite'
-import { PORTS } from '../../packages/shared/constants'
 
 export default defineConfig(({ mode }) => ({
   resolve: {
@@ -27,8 +26,4 @@ export default defineConfig(({ mode }) => ({
       presets: [reactCompilerPreset()],
     }),
   ],
-  server: {
-    strictPort: true,
-    port: mode === 'test' ? PORTS.TEST.DESKTOP : PORTS.DEV.APP,
-  },
 }))

apps/cli/.env.example

@@ -1,2 +1,2 @@
-API_URL=http://localhost:3000
-MAIN_URL=http://localhost:3002
+API_URL=https://api.local.conar.app
+MAIN_URL=https://local.conar.app