@bagelink/workspace 1.8.37 → 1.8.41

package/README.md

@@ -57,10 +57,15 @@ Create `bgl.config.ts`:
 import { defineWorkspace } from '@bagelink/workspace'
 import type { WorkspaceConfig, WorkspaceEnvironment } from '@bagelink/workspace'
 
+/**
+ * Define your workspace environments
+ * You can add as many custom environments as needed (e.g., 'staging', 'preview')
+ * Use --mode flag to switch: bgl dev --mode <env_name>
+ */
 const configs: Record<WorkspaceEnvironment, WorkspaceConfig> = {
   localhost: {
     host: 'http://localhost:8000',
-    proxy: '/api',
+    proxy: '/api', // Optional: remove to skip proxy setup
     openapi_url: 'http://localhost:8000/openapi.json',
   },
   development: {
@@ -72,6 +77,11 @@ const configs: Record<WorkspaceEnvironment, WorkspaceConfig> = {
     host: 'https://project.bagel.to',
     proxy: '/api',
   },
+  // Add your own custom environments
+  staging: {
+    host: 'https://staging.project.bagel.to',
+    proxy: '/api',
+  },
 }
 
 export default defineWorkspace(configs)
@@ -165,8 +175,8 @@ export default defineConfig(({ mode }) => {
 import { useWorkspace, getApiUrl } from '@bagelink/workspace'
 
 // In your app setup
-const { proxy, host, mode } = useWorkspace()
-const auth = createAuth({ baseURL: proxy })
+const { baseURL, proxy, host, mode } = useWorkspace()
+const auth = createAuth({ baseURL }) // Uses proxy if available, otherwise host
 
 // Or get full API URL
 const apiUrl = getApiUrl() // 'https://project.bagel.to/api'
@@ -179,8 +189,8 @@ const apiUrl = getApiUrl() // 'https://project.bagel.to/api'
 import { useWorkspace } from '@bagelink/workspace'
 import { createAuth } from '@bagelink/auth'
 
-const { proxy, host, mode } = useWorkspace()
-const auth = createAuth({ baseURL: proxy })
+const { baseURL, proxy, host, mode } = useWorkspace()
+const auth = createAuth({ baseURL }) // Uses proxy if available, otherwise host
 
 console.log('API Host:', host)
 console.log('Environment:', mode)
@@ -203,12 +213,58 @@ const openapi = import.meta.env.VITE_BGL_OPENAPI_URL // optional
   "scripts": {
     "dev": "vite",
     "dev:local": "vite --mode localhost",
-    "build": "vite build"
+    "dev:staging": "vite --mode staging",
+    "build": "vite build",
+    "build:staging": "vite build --mode staging"
   }
 }
 ```
 
-### 5. Generate Netlify Config
+### 5. Custom Environments
+
+You can define as many custom environments as you need. The environment name is completely flexible:
+
+```typescript
+const configs: Record<WorkspaceEnvironment, WorkspaceConfig> = {
+  localhost: {
+    host: 'http://localhost:8000',
+    proxy: '/api',
+  },
+  development: {
+    host: 'https://dev.project.bagel.to',
+    proxy: '/api',
+  },
+  staging: {
+    host: 'https://staging.project.bagel.to',
+    proxy: '/api',
+  },
+  preview: {
+    host: 'https://preview.project.bagel.to',
+    // No proxy - will use host directly
+  },
+  production: {
+    host: 'https://project.bagel.to',
+    proxy: '/api',
+  },
+}
+```
+
+Use the `--mode` flag to switch environments:
+
+```bash
+# Development
+bgl dev --mode development
+
+# Staging
+bgl dev --mode staging
+
+# Production build
+bgl build --mode production
+```
+
+**Note:** The `proxy` field is optional. If omitted, no proxy will be configured for that environment, and `baseURL` from `useWorkspace()` will return the `host` value instead.
+
+### 6. Generate Netlify Config
 
 ```typescript
 import { writeNetlifyConfig } from '@bagelink/workspace'
@@ -516,16 +572,17 @@ Get workspace configuration at runtime. Config is injected as environment variab
 ```typescript
 import { useWorkspace } from '@bagelink/workspace'
 
-const { proxy, host, openapiUrl, mode } = useWorkspace()
+const { baseURL, proxy, host, openapiUrl, mode } = useWorkspace()
 ```
 
 **Returns:**
 ```typescript
 interface RuntimeWorkspaceConfig {
-  proxy: string           // '/api'
+  baseURL: string        // proxy if available, otherwise host
+  proxy?: string         // '/api' (optional)
   host: string           // 'https://project.bagel.to'
   openapiUrl?: string    // optional
-  mode: 'localhost' | 'development' | 'production'
+  mode: string           // current environment (e.g., 'localhost', 'development', 'staging')
 }
 ```
 

package/bin/bgl.ts

@@ -137,14 +137,19 @@ Usage:
   bgl add <name>            Add a new project to workspace
   bgl list                  List all projects in workspace
   bgl dev [filter] [...args] Run dev servers with clean output (default: './!shared*')
-                            Additional args are passed to vite (e.g., --mode localhost)
+                            Examples:
+                              bgl dev --mode localhost
+                              bgl dev --mode staging
+                              bgl dev admin --mode production
   bgl build [project] [...args] Build project by directory (default: all projects)
+                            Example: bgl build --mode production
   bgl lint init             Set up linting (auto-detects workspace)
   bgl sdk generate          Generate SDK (auto-detects workspace)
 
 Options:
   --workspace, -w           Force workspace mode
   --project, -p             Force single project mode
+  --mode <env>              Set environment (matches bgl.config.ts keys)
   --help, -h                Show this help message
 
 Note: Commands auto-detect workspace mode based on directory structure

package/dist/bin/bgl.cjs

@@ -4,7 +4,7 @@
 const node_path = require('node:path');
 const process = require('node:process');
 const node_child_process = require('node:child_process');
-const netlify = require('../shared/workspace.CuE882NE.cjs');
+const netlify = require('../shared/workspace.Didrexg0.cjs');
 const node_fs = require('node:fs');
 const prompts = require('prompts');
 
@@ -216,10 +216,15 @@ async function generateWorkspaceConfig(root = process__default.cwd(), configFile
   const configContent = `import { defineWorkspace } from '@bagelink/workspace'
 import type { WorkspaceConfig, WorkspaceEnvironment } from '@bagelink/workspace'
 
+/**
+ * Define your workspace environments
+ * You can add as many custom environments as needed (e.g., 'staging', 'preview')
+ * Use --mode flag to switch: bgl dev --mode <env_name>
+ */
 const configs: Record<WorkspaceEnvironment, WorkspaceConfig> = {
 	localhost: {
 		host: 'http://localhost:8000',
-		proxy: '/api',
+		proxy: '/api', // Optional: remove to skip proxy setup
 		openapi_url: 'http://localhost:8000/openapi.json',
 	},
 	development: {
@@ -890,14 +895,19 @@ Usage:
   bgl add <name>            Add a new project to workspace
   bgl list                  List all projects in workspace
   bgl dev [filter] [...args] Run dev servers with clean output (default: './!shared*')
-                            Additional args are passed to vite (e.g., --mode localhost)
+                            Examples:
+                              bgl dev --mode localhost
+                              bgl dev --mode staging
+                              bgl dev admin --mode production
   bgl build [project] [...args] Build project by directory (default: all projects)
+                            Example: bgl build --mode production
   bgl lint init             Set up linting (auto-detects workspace)
   bgl sdk generate          Generate SDK (auto-detects workspace)
 
 Options:
   --workspace, -w           Force workspace mode
   --project, -p             Force single project mode
+  --mode <env>              Set environment (matches bgl.config.ts keys)
   --help, -h                Show this help message
 
 Note: Commands auto-detect workspace mode based on directory structure

package/dist/bin/bgl.mjs

@@ -2,7 +2,7 @@
 import { resolve } from 'node:path';
 import process from 'node:process';
 import { spawn } from 'node:child_process';
-import { l as listProjects, w as writeNetlifyConfig, i as initWorkspace, a as addProject } from '../shared/workspace.ThBu2HJO.mjs';
+import { l as listProjects, w as writeNetlifyConfig, i as initWorkspace, a as addProject } from '../shared/workspace.CzoC6XYF.mjs';
 import { existsSync, readFileSync, readdirSync, writeFileSync, unlinkSync, mkdirSync } from 'node:fs';
 import prompts from 'prompts';
 
@@ -209,10 +209,15 @@ async function generateWorkspaceConfig(root = process.cwd(), configFile = "bgl.c
   const configContent = `import { defineWorkspace } from '@bagelink/workspace'
 import type { WorkspaceConfig, WorkspaceEnvironment } from '@bagelink/workspace'
 
+/**
+ * Define your workspace environments
+ * You can add as many custom environments as needed (e.g., 'staging', 'preview')
+ * Use --mode flag to switch: bgl dev --mode <env_name>
+ */
 const configs: Record<WorkspaceEnvironment, WorkspaceConfig> = {
 	localhost: {
 		host: 'http://localhost:8000',
-		proxy: '/api',
+		proxy: '/api', // Optional: remove to skip proxy setup
 		openapi_url: 'http://localhost:8000/openapi.json',
 	},
 	development: {
@@ -883,14 +888,19 @@ Usage:
   bgl add <name>            Add a new project to workspace
   bgl list                  List all projects in workspace
   bgl dev [filter] [...args] Run dev servers with clean output (default: './!shared*')
-                            Additional args are passed to vite (e.g., --mode localhost)
+                            Examples:
+                              bgl dev --mode localhost
+                              bgl dev --mode staging
+                              bgl dev admin --mode production
   bgl build [project] [...args] Build project by directory (default: all projects)
+                            Example: bgl build --mode production
   bgl lint init             Set up linting (auto-detects workspace)
   bgl sdk generate          Generate SDK (auto-detects workspace)
 
 Options:
   --workspace, -w           Force workspace mode
   --project, -p             Force single project mode
+  --mode <env>              Set environment (matches bgl.config.ts keys)
   --help, -h                Show this help message
 
 Note: Commands auto-detect workspace mode based on directory structure

package/dist/composable.cjs

@@ -1,13 +1,14 @@
 'use strict';
 
 function useWorkspace() {
-  const proxy = undefined.VITE_BGL_PROXY || "/api";
+  const proxy = undefined.VITE_BGL_PROXY || void 0;
   const host = undefined.VITE_BGL_HOST || "";
   const openapiUrl = undefined.VITE_BGL_OPENAPI_URL;
   const mode = undefined.MODE || "development";
   return {
     proxy,
     host,
+    baseURL: proxy ?? host,
     openapiUrl,
     mode
   };

package/dist/composable.d.cts

@@ -4,13 +4,15 @@
  */
 interface RuntimeWorkspaceConfig {
     /** API proxy path (e.g., '/api') */
-    proxy: string;
+    proxy?: string;
     /** API host URL (e.g., 'https://project.bagel.to') */
     host: string;
+    /** Base URL for API requests (proxy if available, otherwise host) */
+    baseURL: string;
     /** OpenAPI specification URL (if configured) */
     openapiUrl?: string;
     /** Current environment mode */
-    mode: 'localhost' | 'development' | 'production';
+    mode: string;
 }
 /**
  * Get workspace configuration at runtime

package/dist/composable.d.mts

@@ -4,13 +4,15 @@
  */
 interface RuntimeWorkspaceConfig {
     /** API proxy path (e.g., '/api') */
-    proxy: string;
+    proxy?: string;
     /** API host URL (e.g., 'https://project.bagel.to') */
     host: string;
+    /** Base URL for API requests (proxy if available, otherwise host) */
+    baseURL: string;
     /** OpenAPI specification URL (if configured) */
     openapiUrl?: string;
     /** Current environment mode */
-    mode: 'localhost' | 'development' | 'production';
+    mode: string;
 }
 /**
  * Get workspace configuration at runtime

package/dist/composable.d.ts

@@ -4,13 +4,15 @@
  */
 interface RuntimeWorkspaceConfig {
     /** API proxy path (e.g., '/api') */
-    proxy: string;
+    proxy?: string;
     /** API host URL (e.g., 'https://project.bagel.to') */
     host: string;
+    /** Base URL for API requests (proxy if available, otherwise host) */
+    baseURL: string;
     /** OpenAPI specification URL (if configured) */
     openapiUrl?: string;
     /** Current environment mode */
-    mode: 'localhost' | 'development' | 'production';
+    mode: string;
 }
 /**
  * Get workspace configuration at runtime

package/dist/composable.mjs

@@ -1,11 +1,12 @@
 function useWorkspace() {
-  const proxy = import.meta.env.VITE_BGL_PROXY || "/api";
+  const proxy = import.meta.env.VITE_BGL_PROXY || void 0;
   const host = import.meta.env.VITE_BGL_HOST || "";
   const openapiUrl = import.meta.env.VITE_BGL_OPENAPI_URL;
   const mode = import.meta.env.MODE || "development";
   return {
     proxy,
     host,
+    baseURL: proxy ?? host,
     openapiUrl,
     mode
   };

package/dist/index.d.cts

@@ -1,5 +1,5 @@
-import { W as WorkspaceEnvironment, a as WorkspaceConfig } from './shared/workspace.CefUteAh.cjs';
-export { P as ProxyConfig, b as WorkspaceOptions } from './shared/workspace.CefUteAh.cjs';
+import { W as WorkspaceEnvironment, a as WorkspaceConfig } from './shared/workspace.BzlV5kcN.cjs';
+export { P as ProxyConfig, b as WorkspaceOptions } from './shared/workspace.BzlV5kcN.cjs';
 export { RuntimeWorkspaceConfig, getApiUrl, useWorkspace } from './composable.cjs';
 
 /**

package/dist/index.d.mts

@@ -1,5 +1,5 @@
-import { W as WorkspaceEnvironment, a as WorkspaceConfig } from './shared/workspace.CefUteAh.mjs';
-export { P as ProxyConfig, b as WorkspaceOptions } from './shared/workspace.CefUteAh.mjs';
+import { W as WorkspaceEnvironment, a as WorkspaceConfig } from './shared/workspace.BzlV5kcN.mjs';
+export { P as ProxyConfig, b as WorkspaceOptions } from './shared/workspace.BzlV5kcN.mjs';
 export { RuntimeWorkspaceConfig, getApiUrl, useWorkspace } from './composable.mjs';
 
 /**

package/dist/index.d.ts

@@ -1,5 +1,5 @@
-import { W as WorkspaceEnvironment, a as WorkspaceConfig } from './shared/workspace.CefUteAh.js';
-export { P as ProxyConfig, b as WorkspaceOptions } from './shared/workspace.CefUteAh.js';
+import { W as WorkspaceEnvironment, a as WorkspaceConfig } from './shared/workspace.BzlV5kcN.js';
+export { P as ProxyConfig, b as WorkspaceOptions } from './shared/workspace.BzlV5kcN.js';
 export { RuntimeWorkspaceConfig, getApiUrl, useWorkspace } from './composable.js';
 
 /**

package/dist/shared/{workspace.CefUteAh.d.cts → workspace.BzlV5kcN.d.cts}

@@ -1,4 +1,4 @@
-type WorkspaceEnvironment = 'localhost' | 'development' | 'production';
+type WorkspaceEnvironment = string;
 interface WorkspaceConfig {
     /**
      * The host URL of the backend API server
@@ -6,10 +6,11 @@ interface WorkspaceConfig {
      */
     host: string;
     /**
-     * The proxy path to use for API requests
-     * @default '/api'
+     * Optional proxy path to use for API requests
+     * If not set, no proxy will be configured for this environment
+     * @example '/api'
      */
-    proxy: string;
+    proxy?: string;
     /**
      * Optional OpenAPI specification URL for SDK generation
      */

package/dist/shared/{workspace.CefUteAh.d.mts → workspace.BzlV5kcN.d.mts}

@@ -1,4 +1,4 @@
-type WorkspaceEnvironment = 'localhost' | 'development' | 'production';
+type WorkspaceEnvironment = string;
 interface WorkspaceConfig {
     /**
      * The host URL of the backend API server
@@ -6,10 +6,11 @@ interface WorkspaceConfig {
      */
     host: string;
     /**
-     * The proxy path to use for API requests
-     * @default '/api'
+     * Optional proxy path to use for API requests
+     * If not set, no proxy will be configured for this environment
+     * @example '/api'
      */
-    proxy: string;
+    proxy?: string;
     /**
      * Optional OpenAPI specification URL for SDK generation
      */

package/dist/shared/{workspace.CefUteAh.d.ts → workspace.BzlV5kcN.d.ts}

@@ -1,4 +1,4 @@
-type WorkspaceEnvironment = 'localhost' | 'development' | 'production';
+type WorkspaceEnvironment = string;
 interface WorkspaceConfig {
     /**
      * The host URL of the backend API server
@@ -6,10 +6,11 @@ interface WorkspaceConfig {
      */
     host: string;
     /**
-     * The proxy path to use for API requests
-     * @default '/api'
+     * Optional proxy path to use for API requests
+     * If not set, no proxy will be configured for this environment
+     * @example '/api'
      */
-    proxy: string;
+    proxy?: string;
     /**
      * Optional OpenAPI specification URL for SDK generation
      */

package/dist/shared/{workspace.ThBu2HJO.mjs → workspace.CzoC6XYF.mjs}

@@ -97,10 +97,15 @@ function createWorkspaceRoot(root, name, projectId) {
   );
   const bglConfig = `import { defineWorkspace } from '@bagelink/workspace'
 
+/**
+ * Define your workspace environments
+ * You can add as many custom environments as needed (e.g., 'staging', 'preview')
+ * Use --mode flag to switch: bgl dev --mode <env_name>
+ */
 export default defineWorkspace({
 	localhost: {
 		host: 'http://localhost:8000',
-		proxy: '/api',
+		proxy: '/api', // Optional: remove to skip proxy setup
 		openapi_url: 'http://localhost:8000/openapi.json',
 	},
 	development: {

package/dist/shared/{workspace.CuE882NE.cjs → workspace.Didrexg0.cjs}

@@ -104,10 +104,15 @@ function createWorkspaceRoot(root, name, projectId) {
   );
   const bglConfig = `import { defineWorkspace } from '@bagelink/workspace'
 
+/**
+ * Define your workspace environments
+ * You can add as many custom environments as needed (e.g., 'staging', 'preview')
+ * Use --mode flag to switch: bgl dev --mode <env_name>
+ */
 export default defineWorkspace({
 	localhost: {
 		host: 'http://localhost:8000',
-		proxy: '/api',
+		proxy: '/api', // Optional: remove to skip proxy setup
 		openapi_url: 'http://localhost:8000/openapi.json',
 	},
 	development: {

package/dist/vite.cjs

@@ -3,7 +3,7 @@
 const node_path = require('node:path');
 const process = require('node:process');
 const node_url = require('node:url');
-const netlify = require('./shared/workspace.CuE882NE.cjs');
+const netlify = require('./shared/workspace.Didrexg0.cjs');
 require('node:fs');
 require('prompts');
 
@@ -104,7 +104,9 @@ function bagelink(options) {
         }
       };
       const define = {
-        "import.meta.env.VITE_BGL_PROXY": JSON.stringify(workspaceConfig.proxy),
+        ...workspaceConfig.proxy && {
+          "import.meta.env.VITE_BGL_PROXY": JSON.stringify(workspaceConfig.proxy)
+        },
         "import.meta.env.VITE_BGL_HOST": JSON.stringify(workspaceConfig.host),
         ...workspaceConfig.openapi_url && {
           "import.meta.env.VITE_BGL_OPENAPI_URL": JSON.stringify(workspaceConfig.openapi_url)

package/dist/vite.d.cts

@@ -1,5 +1,5 @@
 import { Plugin } from 'vite';
-import { a as WorkspaceConfig, P as ProxyConfig, W as WorkspaceEnvironment } from './shared/workspace.CefUteAh.cjs';
+import { a as WorkspaceConfig, P as ProxyConfig, W as WorkspaceEnvironment } from './shared/workspace.BzlV5kcN.cjs';
 
 /**
  * Generate complete netlify.toml file

package/dist/vite.d.mts

@@ -1,5 +1,5 @@
 import { Plugin } from 'vite';
-import { a as WorkspaceConfig, P as ProxyConfig, W as WorkspaceEnvironment } from './shared/workspace.CefUteAh.mjs';
+import { a as WorkspaceConfig, P as ProxyConfig, W as WorkspaceEnvironment } from './shared/workspace.BzlV5kcN.mjs';
 
 /**
  * Generate complete netlify.toml file

package/dist/vite.d.ts

@@ -1,5 +1,5 @@
 import { Plugin } from 'vite';
-import { a as WorkspaceConfig, P as ProxyConfig, W as WorkspaceEnvironment } from './shared/workspace.CefUteAh.js';
+import { a as WorkspaceConfig, P as ProxyConfig, W as WorkspaceEnvironment } from './shared/workspace.BzlV5kcN.js';
 
 /**
  * Generate complete netlify.toml file

package/dist/vite.mjs

@@ -1,8 +1,8 @@
 import { basename } from 'node:path';
 import process from 'node:process';
 import { fileURLToPath } from 'node:url';
-import { l as listProjects } from './shared/workspace.ThBu2HJO.mjs';
-export { g as generateNetlifyConfig, s as setBuildEnvVars, w as writeNetlifyConfig } from './shared/workspace.ThBu2HJO.mjs';
+import { l as listProjects } from './shared/workspace.CzoC6XYF.mjs';
+export { g as generateNetlifyConfig, s as setBuildEnvVars, w as writeNetlifyConfig } from './shared/workspace.CzoC6XYF.mjs';
 import 'node:fs';
 import 'prompts';
 
@@ -99,7 +99,9 @@ function bagelink(options) {
         }
       };
       const define = {
-        "import.meta.env.VITE_BGL_PROXY": JSON.stringify(workspaceConfig.proxy),
+        ...workspaceConfig.proxy && {
+          "import.meta.env.VITE_BGL_PROXY": JSON.stringify(workspaceConfig.proxy)
+        },
         "import.meta.env.VITE_BGL_HOST": JSON.stringify(workspaceConfig.host),
         ...workspaceConfig.openapi_url && {
           "import.meta.env.VITE_BGL_OPENAPI_URL": JSON.stringify(workspaceConfig.openapi_url)

package/env.d.ts

@@ -7,9 +7,10 @@
 interface ImportMetaEnv {
 	/**
 	 * API proxy path (e.g., '/api')
-	 * Injected from bgl.config.ts
+	 * Injected from bgl.config.ts if configured
+	 * Optional - if not set, use VITE_BGL_HOST directly
 	 */
-	readonly VITE_BGL_PROXY: string
+	readonly VITE_BGL_PROXY?: string
 
 	/**
 	 * API host URL (e.g., 'https://project.bagel.to')

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@bagelink/workspace",
   "type": "module",
-  "version": "1.8.37",
+  "version": "1.8.41",
   "description": "Monorepo workspace tooling for Bagel projects with proxy and config management",
   "author": {
     "name": "Bagel Studio",

package/src/composable.ts

@@ -1,16 +1,20 @@
+/// <reference types="vite/client" />
+
 /**
  * Runtime workspace configuration
  * Provides access to workspace config injected at build time
  */
 export interface RuntimeWorkspaceConfig {
 	/** API proxy path (e.g., '/api') */
-	proxy: string
+	proxy?: string
 	/** API host URL (e.g., 'https://project.bagel.to') */
 	host: string
+	/** Base URL for API requests (proxy if available, otherwise host) */
+	baseURL: string
 	/** OpenAPI specification URL (if configured) */
 	openapiUrl?: string
 	/** Current environment mode */
-	mode: 'localhost' | 'development' | 'production'
+	mode: string
 }
 
 /**
@@ -36,14 +40,15 @@ export interface RuntimeWorkspaceConfig {
  */
 export function useWorkspace(): RuntimeWorkspaceConfig {
 	// Access env variables injected by the Vite plugin
-	const proxy = import.meta.env.VITE_BGL_PROXY || '/api'
+	const proxy = import.meta.env.VITE_BGL_PROXY || undefined
 	const host = import.meta.env.VITE_BGL_HOST || ''
 	const openapiUrl = import.meta.env.VITE_BGL_OPENAPI_URL
-	const mode = (import.meta.env.MODE as RuntimeWorkspaceConfig['mode']) || 'development'
+	const mode = (import.meta.env.MODE as string) || 'development'
 
 	return {
 		proxy,
 		host,
+		baseURL: proxy ?? host,
 		openapiUrl,
 		mode,
 	}

package/src/init.ts

@@ -49,10 +49,15 @@ export async function generateWorkspaceConfig(
 	const configContent = `import { defineWorkspace } from '@bagelink/workspace'
 import type { WorkspaceConfig, WorkspaceEnvironment } from '@bagelink/workspace'
 
+/**
+ * Define your workspace environments
+ * You can add as many custom environments as needed (e.g., 'staging', 'preview')
+ * Use --mode flag to switch: bgl dev --mode <env_name>
+ */
 const configs: Record<WorkspaceEnvironment, WorkspaceConfig> = {
 	localhost: {
 		host: 'http://localhost:8000',
-		proxy: '/api',
+		proxy: '/api', // Optional: remove to skip proxy setup
 		openapi_url: 'http://localhost:8000/openapi.json',
 	},
 	development: {
@@ -142,10 +147,15 @@ export function generateWorkspaceConfigSync(
 	const configContent = `import { defineWorkspace } from '@bagelink/workspace'
 import type { WorkspaceConfig, WorkspaceEnvironment } from '@bagelink/workspace'
 
+/**
+ * Define your workspace environments
+ * You can add as many custom environments as needed (e.g., 'staging', 'preview')
+ * Use --mode flag to switch: bgl dev --mode <env_name>
+ */
 const configs: Record<WorkspaceEnvironment, WorkspaceConfig> = {
 	localhost: {
 		host: 'http://localhost:8000',
-		proxy: '/api',
+		proxy: '/api', // Optional: remove to skip proxy setup
 		openapi_url: 'http://localhost:8000/openapi.json',
 	},
 	development: {

package/src/types.ts

@@ -1,4 +1,4 @@
-export type WorkspaceEnvironment = 'localhost' | 'development' | 'production'
+export type WorkspaceEnvironment = string
 
 export interface WorkspaceConfig {
 	/**
@@ -8,10 +8,11 @@ export interface WorkspaceConfig {
 	host: string
 
 	/**
-	 * The proxy path to use for API requests
-	 * @default '/api'
+	 * Optional proxy path to use for API requests
+	 * If not set, no proxy will be configured for this environment
+	 * @example '/api'
 	 */
-	proxy: string
+	proxy?: string
 
 	/**
 	 * Optional OpenAPI specification URL for SDK generation

package/src/vite.ts

@@ -142,7 +142,9 @@ export function bagelink(options: {
 
 			// Inject workspace config as environment variables
 			const define = {
-				'import.meta.env.VITE_BGL_PROXY': JSON.stringify(workspaceConfig.proxy),
+				...(workspaceConfig.proxy && {
+					'import.meta.env.VITE_BGL_PROXY': JSON.stringify(workspaceConfig.proxy),
+				}),
 				'import.meta.env.VITE_BGL_HOST': JSON.stringify(workspaceConfig.host),
 				...(workspaceConfig.openapi_url && {
 					'import.meta.env.VITE_BGL_OPENAPI_URL': JSON.stringify(workspaceConfig.openapi_url),

package/src/workspace.ts

@@ -121,10 +121,15 @@ function createWorkspaceRoot(root: string, name: string, projectId: string): voi
 	// bgl.config.ts (shared)
 	const bglConfig = `import { defineWorkspace } from '@bagelink/workspace'
 
+/**
+ * Define your workspace environments
+ * You can add as many custom environments as needed (e.g., 'staging', 'preview')
+ * Use --mode flag to switch: bgl dev --mode <env_name>
+ */
 export default defineWorkspace({
 	localhost: {
 		host: 'http://localhost:8000',
-		proxy: '/api',
+		proxy: '/api', // Optional: remove to skip proxy setup
 		openapi_url: 'http://localhost:8000/openapi.json',
 	},
 	development: {