feat: add Render deployment blueprint and prepare for production

Add render.yaml with two services: a public Docker-based Next.js
frontend and a private Python LangGraph agent. Normalize the
LANGGRAPH_DEPLOYMENT_URL to handle Render's bare host:port format,
and make MCP server configuration opt-in via env var instead of
hardcoding the excalidraw default.

Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>

Author: GeneralJerel

.gitignore

@@ -60,3 +60,6 @@ bun.lockb
 
 # Demos
 .demos
+
+# References
+.references

apps/app/src/app/api/copilotkit/route.ts

@@ -6,9 +6,17 @@ import {
 import { LangGraphAgent } from "@copilotkit/runtime/langgraph";
 import { NextRequest } from "next/server";
 
+// Normalize Render's fromService hostport (bare host:port) into a full URL
+const raw = process.env.LANGGRAPH_DEPLOYMENT_URL;
+const deploymentUrl = !raw
+  ? "http://localhost:8123"
+  : raw.startsWith("http")
+    ? raw
+    : `http://${raw}`;
+
 // 1. Define the agent connection to LangGraph
 const defaultAgent = new LangGraphAgent({
-  deploymentUrl: process.env.LANGGRAPH_DEPLOYMENT_URL || "http://localhost:8123",
+  deploymentUrl,
   graphId: "sample_agent",
   langsmithApiKey: process.env.LANGSMITH_API_KEY || "",
 });
@@ -21,13 +29,15 @@ export const POST = async (req: NextRequest) => {
     runtime: new CopilotRuntime({
       agents: { default: defaultAgent, },
       a2ui: { injectA2UITool: true },
-      mcpApps: {
-        servers: [{
-          type: "http",
-          url: process.env.MCP_SERVER_URL || "https://mcp.excalidraw.com",
-          serverId: "example_mcp_app",
-        }],
-      },
+      ...(process.env.MCP_SERVER_URL && {
+        mcpApps: {
+          servers: [{
+            type: "http",
+            url: process.env.MCP_SERVER_URL,
+            serverId: "mcp_app",
+          }],
+        },
+      }),
     }),
   });
 

render.yaml

@@ -0,0 +1,40 @@
+services:
+  # ── Agent (LangGraph Python) — private, not exposed to internet ──
+  - type: pserv
+    name: open-generative-ui-agent
+    runtime: python
+    plan: starter
+    rootDir: apps/agent
+    buildCommand: "pip install uv && uv sync --frozen"
+    startCommand: "uv run langgraph dev --host 0.0.0.0 --port $PORT --no-browser --no-reload"
+    envVars:
+      - key: PYTHON_VERSION
+        value: "3.12"
+      - key: OPENAI_API_KEY
+        sync: false
+      - key: LANGSMITH_API_KEY
+        sync: false
+    buildFilter:
+      paths:
+        - apps/agent/**
+
+  # ── Frontend (Next.js) — public web service ──
+  - type: web
+    name: open-generative-ui-app
+    runtime: docker
+    plan: starter
+    dockerfilePath: docker/Dockerfile.app
+    envVars:
+      - key: LANGGRAPH_DEPLOYMENT_URL
+        fromService:
+          name: open-generative-ui-agent
+          type: pserv
+          property: hostport
+      - key: LANGSMITH_API_KEY
+        sync: false
+    buildFilter:
+      paths:
+        - apps/app/**
+        - package.json
+        - pnpm-lock.yaml
+        - docker/Dockerfile.app