feat: add make start command for local previewing (#1078)

* feat: add `make start` command for local previewing * Update Makefile Co-authored-by: Copilot <175728472+Copilot@users.noreply.github.com> * Update Makefile Co-authored-by: Copilot <175728472+Copilot@users.noreply.github.com> * Update scripts/check.sh Co-authored-by: Copilot <175728472+Copilot@users.noreply.github.com> * fix: update help text for `make dev` and `make start` commands --------- Co-authored-by: Copilot <175728472+Copilot@users.noreply.github.com>
2026-04-03 06:12:14 +08:00 · 2026-03-11 13:46:05 +08:00
parent 06c4b0c828
commit 2e7964d0aa
3 changed files with 141 additions and 81 deletions
--- a/scripts/check.sh
+++ b/scripts/check.sh
@@ -0,0 +1,83 @@
+#!/usr/bin/env bash
+set -euo pipefail
+
+echo "=========================================="
+echo "  Checking Required Dependencies"
+echo "=========================================="
+echo ""
+
+FAILED=0
+
+echo "Checking Node.js..."
+if command -v node >/dev/null 2>&1; then
+    NODE_VERSION=$(node -v | sed 's/v//')
+    NODE_MAJOR=$(echo "$NODE_VERSION" | cut -d. -f1)
+    if [ "$NODE_MAJOR" -ge 22 ]; then
+        echo "  ✓ Node.js $NODE_VERSION (>= 22 required)"
+    else
+        echo "  ✗ Node.js $NODE_VERSION found, but version 22+ is required"
+        echo "    Install from: https://nodejs.org/"
+        FAILED=1
+    fi
+else
+    echo "  ✗ Node.js not found (version 22+ required)"
+    echo "    Install from: https://nodejs.org/"
+    FAILED=1
+fi
+
+echo ""
+echo "Checking pnpm..."
+if command -v pnpm >/dev/null 2>&1; then
+    PNPM_VERSION=$(pnpm -v)
+    echo "  ✓ pnpm $PNPM_VERSION"
+else
+    echo "  ✗ pnpm not found"
+    echo "    Install: npm install -g pnpm"
+    echo "    Or visit: https://pnpm.io/installation"
+    FAILED=1
+fi
+
+echo ""
+echo "Checking uv..."
+if command -v uv >/dev/null 2>&1; then
+    UV_VERSION=$(uv --version | awk '{print $2}')
+    echo "  ✓ uv $UV_VERSION"
+else
+    echo "  ✗ uv not found"
+    echo "    Install: curl -LsSf https://astral.sh/uv/install.sh | sh"
+    echo "    Or visit: https://docs.astral.sh/uv/getting-started/installation/"
+    FAILED=1
+fi
+
+echo ""
+echo "Checking nginx..."
+if command -v nginx >/dev/null 2>&1; then
+    NGINX_VERSION=$(nginx -v 2>&1 | awk -F'/' '{print $2}')
+    echo "  ✓ nginx $NGINX_VERSION"
+else
+    echo "  ✗ nginx not found"
+    echo "    macOS:   brew install nginx"
+    echo "    Ubuntu:  sudo apt install nginx"
+    echo "    Or visit: https://nginx.org/en/download.html"
+    FAILED=1
+fi
+
+echo ""
+if [ "$FAILED" -eq 0 ]; then
+    echo "=========================================="
+    echo "  ✓ All dependencies are installed!"
+    echo "=========================================="
+    echo ""
+    echo "You can now run:"
+    echo "  make install  - Install project dependencies"
+    echo "  make config   - Generate local config files"
+    echo "  make dev      - Start development server"
+    echo "  make start    - Start production server"
+else
+    echo "=========================================="
+    echo "  ✗ Some dependencies are missing"
+    echo "=========================================="
+    echo ""
+    echo "Please install the missing tools and run 'make check' again."
+    exit 1
+fi
--- a/scripts/serve.sh
+++ b/scripts/serve.sh
@@ -9,12 +9,30 @@ set -e
 REPO_ROOT="$(cd "$(dirname "${BASH_SOURCE[0]}")/.." && pwd)"
 cd "$REPO_ROOT"

+# ── Argument parsing ─────────────────────────────────────────────────────────
+
+DEV_MODE=true
+for arg in "$@"; do
+    case "$arg" in
+        --dev)  DEV_MODE=true ;;
+        --prod) DEV_MODE=false ;;
+        *) echo "Unknown argument: $arg"; echo "Usage: $0 [--dev|--prod]"; exit 1 ;;
+    esac
+done
+
+if $DEV_MODE; then
+    FRONTEND_CMD="pnpm run dev"
+else
+    FRONTEND_CMD="env BETTER_AUTH_SECRET=$(python3 -c 'import secrets; print(secrets.token_hex(16))') pnpm run preview"
+fi
+
 # ── Stop existing services ────────────────────────────────────────────────────

 echo "Stopping existing services if any..."
 pkill -f "langgraph dev" 2>/dev/null || true
 pkill -f "uvicorn src.gateway.app:app" 2>/dev/null || true
 pkill -f "next dev" 2>/dev/null || true
+pkill -f "next-server" 2>/dev/null || true
 nginx -c "$REPO_ROOT/docker/nginx/nginx.local.conf" -p "$REPO_ROOT" -s quit 2>/dev/null || true
 sleep 1
 pkill -9 nginx 2>/dev/null || true
@@ -29,6 +47,14 @@ echo "=========================================="
 echo "  Starting DeerFlow Development Server"
 echo "=========================================="
 echo ""
+if $DEV_MODE; then
+    echo "  Mode: DEV  (hot-reload enabled)"
+    echo "  Tip:  run \`make start\` in production mode"
+else
+    echo "  Mode: PROD (hot-reload disabled)"
+    echo "  Tip:  run \`make dev\` to start in development mode"
+fi
+echo ""
 echo "Services starting up..."
 echo "  → Backend: LangGraph + Gateway"
 echo "  → Frontend: Next.js"
@@ -61,6 +87,7 @@ cleanup() {
    pkill -f "langgraph dev" 2>/dev/null || true
    pkill -f "uvicorn src.gateway.app:app" 2>/dev/null || true
    pkill -f "next dev" 2>/dev/null || true
+    pkill -f "next start" 2>/dev/null || true
    # Kill nginx using the captured PID first (most reliable),
    # then fall back to pkill/killall for any stray nginx workers.
    if [ -n "${NGINX_PID:-}" ] && kill -0 "$NGINX_PID" 2>/dev/null; then
@@ -81,8 +108,16 @@ trap cleanup INT TERM

 mkdir -p logs

+if $DEV_MODE; then
+    LANGGRAPH_EXTRA_FLAGS=""
+    GATEWAY_EXTRA_FLAGS="--reload --reload-include='*.yaml' --reload-include='.env'"
+else
+    LANGGRAPH_EXTRA_FLAGS="--no-reload"
+    GATEWAY_EXTRA_FLAGS=""
+fi
+
 echo "Starting LangGraph server..."
-(cd backend && NO_COLOR=1 uv run langgraph dev --no-browser --allow-blocking --no-reload > ../logs/langgraph.log 2>&1) &
+(cd backend && NO_COLOR=1 uv run langgraph dev --no-browser --allow-blocking $LANGGRAPH_EXTRA_FLAGS > ../logs/langgraph.log 2>&1) &
 ./scripts/wait-for-port.sh 2024 60 "LangGraph" || {
    echo "  See logs/langgraph.log for details"
    tail -20 logs/langgraph.log
@@ -91,7 +126,7 @@ echo "Starting LangGraph server..."
 echo "✓ LangGraph server started on localhost:2024"

 echo "Starting Gateway API..."
-(cd backend && uv run uvicorn src.gateway.app:app --host 0.0.0.0 --port 8001 > ../logs/gateway.log 2>&1) &
+(cd backend && uv run uvicorn src.gateway.app:app --host 0.0.0.0 --port 8001 $GATEWAY_EXTRA_FLAGS > ../logs/gateway.log 2>&1) &
 ./scripts/wait-for-port.sh 8001 30 "Gateway API" || {
    echo "✗ Gateway API failed to start. Last log output:"
    tail -60 logs/gateway.log
@@ -103,7 +138,7 @@ echo "Starting Gateway API..."
 echo "✓ Gateway API started on localhost:8001"

 echo "Starting Frontend..."
-(cd frontend && pnpm run dev > ../logs/frontend.log 2>&1) &
+(cd frontend && $FRONTEND_CMD > ../logs/frontend.log 2>&1) &
 ./scripts/wait-for-port.sh 3000 120 "Frontend" || {
    echo "  See logs/frontend.log for details"
    tail -20 logs/frontend.log
@@ -125,7 +160,11 @@ echo "✓ Nginx started on localhost:2026"

 echo ""
 echo "=========================================="
-echo "  DeerFlow is ready!"
+if $DEV_MODE; then
+    echo "  ✓ DeerFlow development server is running!"
+else
+    echo "  ✓ DeerFlow production server is running!"
+fi
 echo "=========================================="
 echo ""
 echo "  🌐 Application: http://localhost:2026"
@@ -139,6 +178,5 @@ echo "     - Frontend:  logs/frontend.log"
 echo "     - Nginx:     logs/nginx.log"
 echo ""
 echo "Press Ctrl+C to stop all services"
-echo ""

 wait