feat: enhance deployment in cloudflare

Author: LeadcodeDev

.env.example

@@ -0,0 +1,6 @@
+# Cross-app URLs — used by navbar links
+# In production, these default to subdomains (see packages/ui/src/lib/app-links.ts)
+# Override here for local development
+PUBLIC_WEBSITE_URL=http://localhost:4323
+PUBLIC_DOCS_URL=http://localhost:4321
+PUBLIC_BLOG_URL=http://localhost:4322

.github/workflows/deploy-blog.yml

@@ -27,6 +27,10 @@ jobs:
       - run: pnpm install --frozen-lockfile
 
       - run: pnpm --filter @explainer/blog build
+        env:
+          PUBLIC_BLOG_URL: ${{ vars.PUBLIC_BLOG_URL }}
+          PUBLIC_DOCS_URL: ${{ vars.PUBLIC_DOCS_URL }}
+          PUBLIC_WEBSITE_URL: ${{ vars.PUBLIC_WEBSITE_URL }}
 
       - uses: actions/upload-artifact@v4
         with:

.github/workflows/deploy-docs.yml

@@ -25,6 +25,10 @@ jobs:
       - run: pnpm install --frozen-lockfile
 
       - run: pnpm --filter @explainer/docs build
+        env:
+          PUBLIC_DOCS_URL: ${{ vars.PUBLIC_DOCS_URL }}
+          PUBLIC_BLOG_URL: ${{ vars.PUBLIC_BLOG_URL }}
+          PUBLIC_WEBSITE_URL: ${{ vars.PUBLIC_WEBSITE_URL }}
 
       - uses: actions/upload-artifact@v4
         with:

.github/workflows/deploy-website.yml

@@ -25,6 +25,10 @@ jobs:
       - run: pnpm install --frozen-lockfile
 
       - run: pnpm --filter @explainer/website build
+        env:
+          PUBLIC_WEBSITE_URL: ${{ vars.PUBLIC_WEBSITE_URL }}
+          PUBLIC_DOCS_URL: ${{ vars.PUBLIC_DOCS_URL }}
+          PUBLIC_BLOG_URL: ${{ vars.PUBLIC_BLOG_URL }}
 
       - uses: actions/upload-artifact@v4
         with:

apps/blog/astro.config.ts

@@ -1,3 +1,4 @@
+import { readFileSync } from 'node:fs'
 import { defineConfig } from 'astro/config'
 import react from '@astrojs/react'
 import mdx from '@astrojs/mdx'
@@ -9,8 +10,24 @@ import { remarkDirectiveHandler } from '@explainer/mdx/remark-directive-handler'
 import { remarkCodeBlocks } from '@explainer/mdx/remark-code-blocks'
 import { thumbnailIntegration } from '@explainer/thumbnail/integration'
 
+function loadRootEnv() {
+  try {
+    const content = readFileSync('../../.env', 'utf-8')
+    const env: Record<string, string> = {}
+    for (const line of content.split('\n')) {
+      const match = line.match(/^\s*([\w.]+)\s*=\s*(.*)?\s*$/)
+      if (match) env[match[1]] = match[2]?.replace(/^['"]|['"]$/g, '') ?? ''
+    }
+    return env
+  } catch {
+    return {}
+  }
+}
+
+const env = loadRootEnv()
+
 export default defineConfig({
-  site: 'https://blog.example.com',
+  site: process.env.PUBLIC_BLOG_URL || env.PUBLIC_BLOG_URL,
   i18n: {
     locales: ['en', 'fr'],
     defaultLocale: 'en',

apps/blog/package.json

@@ -9,21 +9,22 @@
     "preview": "astro preview"
   },
   "dependencies": {
-    "astro": "^5.5.0",
-    "@astrojs/react": "^4.2.0",
     "@astrojs/mdx": "^4.2.0",
+    "@astrojs/react": "^4.2.0",
     "@astrojs/rss": "^4.0.0",
-    "@tailwindcss/vite": "^4.0.0",
-    "tailwindcss": "^4.0.0",
-    "react": "^19.0.0",
-    "react-dom": "^19.0.0",
-    "@explainer/ui": "workspace:*",
     "@explainer/mdx": "workspace:*",
     "@explainer/thumbnail": "workspace:*",
+    "@explainer/ui": "workspace:*",
     "@iconify/react": "^5.2.0",
-    "remark-directive": "^4.0.0"
+    "@tailwindcss/vite": "^4.0.0",
+    "astro": "^5.5.0",
+    "react": "^19.0.0",
+    "react-dom": "^19.0.0",
+    "remark-directive": "^4.0.0",
+    "tailwindcss": "^4.0.0"
   },
   "devDependencies": {
+    "@types/node": "^25.5.0",
     "@types/react": "^19.0.0",
     "@types/react-dom": "^19.0.0",
     "typescript": "^5.8.0"

apps/docs/astro.config.ts

@@ -10,6 +10,7 @@ import { remarkCodeBlocks } from '@explainer/mdx/remark-code-blocks'
 import { thumbnailIntegration } from '@explainer/thumbnail/integration'
 
 export default defineConfig({
+  site: process.env.PUBLIC_DOCS_URL || undefined,
   devToolbar: { enabled: false },
   integrations: [
     react(),

apps/docs/package.json

@@ -23,6 +23,7 @@
     "tailwindcss": "^4.0.0"
   },
   "devDependencies": {
+    "@types/node": "^25.5.0",
     "@types/react": "^19.0.0",
     "@types/react-dom": "^19.0.0",
     "pagefind": "^1.4.0",

apps/website/astro.config.ts

@@ -4,6 +4,7 @@ import tailwindcss from '@tailwindcss/vite'
 import { thumbnailIntegration } from '@explainer/thumbnail/integration'
 
 export default defineConfig({
+  site: process.env.PUBLIC_WEBSITE_URL || undefined,
   integrations: [
     react(),
     thumbnailIntegration({

apps/website/package.json

@@ -9,17 +9,18 @@
     "preview": "astro preview"
   },
   "dependencies": {
-    "astro": "^5.5.0",
     "@astrojs/react": "^4.2.0",
+    "@explainer/thumbnail": "workspace:*",
+    "@explainer/ui": "workspace:*",
+    "@iconify/react": "^5.2.0",
     "@tailwindcss/vite": "^4.0.0",
-    "tailwindcss": "^4.0.0",
+    "astro": "^5.5.0",
     "react": "^19.0.0",
     "react-dom": "^19.0.0",
-    "@explainer/thumbnail": "workspace:*",
-    "@explainer/ui": "workspace:*",
-    "@iconify/react": "^5.2.0"
+    "tailwindcss": "^4.0.0"
   },
   "devDependencies": {
+    "@types/node": "^25.5.0",
     "@types/react": "^19.0.0",
     "@types/react-dom": "^19.0.0",
     "typescript": "^5.8.0"