@robsun/create-keystone-app 0.1.13 → 0.1.14

package/template/scripts/build.js

@@ -0,0 +1,25 @@
+#!/usr/bin/env node
+const { spawn } = require('child_process')
+const path = require('path')
+const os = require('os')
+
+const scriptsDir = __dirname
+const isWindows = os.platform() === 'win32'
+const script = isWindows
+  ? path.join(scriptsDir, 'build.bat')
+  : path.join(scriptsDir, 'build.sh')
+
+const child = spawn(script, [], {
+  stdio: 'inherit',
+  shell: true,
+  cwd: path.join(scriptsDir, '..'),
+})
+
+child.on('error', (err) => {
+  console.error('Failed to start build:', err)
+  process.exit(1)
+})
+
+child.on('exit', (code) => {
+  process.exit(code || 0)
+})

package/template/scripts/build.sh

@@ -0,0 +1,99 @@
+#!/bin/bash
+set -e
+
+echo "========================================"
+echo "  Keystone Production Build"
+echo "  (Single Executable with Embedded Frontend)"
+echo "========================================"
+echo ""
+
+RED='\033[0;31m'
+GREEN='\033[0;32m'
+NC='\033[0m'
+
+SCRIPT_DIR="$(cd "$(dirname "$0")" && pwd)"
+PROJECT_ROOT="$(dirname "$SCRIPT_DIR")"
+FRONTEND_DIR="$PROJECT_ROOT/apps/web"
+BACKEND_DIR="$PROJECT_ROOT/apps/server"
+EMBED_DIR="$BACKEND_DIR/internal/frontend/dist"
+OUTPUT_DIR="$PROJECT_ROOT/dist"
+OUTPUT_NAME="__APP_NAME__"
+
+echo "Checking prerequisites..."
+if ! command -v node &> /dev/null; then
+  echo -e "${RED}[ERROR]${NC} Node.js is not installed"
+  exit 1
+fi
+echo -e "${GREEN}[OK]${NC} Node.js found"
+
+if ! command -v pnpm &> /dev/null; then
+  echo -e "${RED}[ERROR]${NC} pnpm is not installed"
+  exit 1
+fi
+echo -e "${GREEN}[OK]${NC} pnpm found"
+
+if ! command -v go &> /dev/null; then
+  echo -e "${RED}[ERROR]${NC} Go is not installed"
+  exit 1
+fi
+echo -e "${GREEN}[OK]${NC} Go found"
+
+echo ""
+echo "Building production artifacts..."
+echo ""
+
+mkdir -p "$OUTPUT_DIR"
+mkdir -p "$EMBED_DIR"
+
+echo "----------------------------------------"
+echo "[1/4] Cleaning embed directory"
+echo "----------------------------------------"
+find "$EMBED_DIR" -mindepth 1 ! -name '.gitkeep' -delete 2>/dev/null || true
+echo -e "${GREEN}[OK]${NC} Embed directory cleaned"
+
+echo "----------------------------------------"
+echo "[2/4] Building Frontend"
+echo "----------------------------------------"
+cd "$FRONTEND_DIR"
+pnpm build
+echo -e "${GREEN}[OK]${NC} Frontend build completed"
+cd "$PROJECT_ROOT"
+
+echo "----------------------------------------"
+echo "[3/4] Building Backend (with embedded frontend)"
+echo "----------------------------------------"
+cd "$BACKEND_DIR"
+
+echo "Building for Windows (amd64)..."
+CGO_ENABLED=0 GOOS=windows GOARCH=amd64 go build -ldflags="-s -w" -o "$OUTPUT_DIR/$OUTPUT_NAME.exe" ./cmd/server
+echo -e "${GREEN}[OK]${NC} Windows build completed"
+
+echo "Building for Linux (amd64)..."
+CGO_ENABLED=0 GOOS=linux GOARCH=amd64 go build -ldflags="-s -w" -o "$OUTPUT_DIR/$OUTPUT_NAME" ./cmd/server
+echo -e "${GREEN}[OK]${NC} Linux build completed"
+
+cd "$PROJECT_ROOT"
+
+echo "----------------------------------------"
+echo "[4/4] Copying configuration template"
+echo "----------------------------------------"
+if [ -f "$BACKEND_DIR/config.example.yaml" ]; then
+  cp "$BACKEND_DIR/config.example.yaml" "$OUTPUT_DIR/config.example.yaml"
+  echo -e "${GREEN}[OK]${NC} Config template copied"
+fi
+
+echo ""
+echo "========================================"
+echo -e "  ${GREEN}Build completed successfully!${NC}"
+echo ""
+echo "  Executables (frontend embedded):"
+echo "    - $OUTPUT_DIR/$OUTPUT_NAME.exe  (Windows)"
+echo "    - $OUTPUT_DIR/$OUTPUT_NAME      (Linux)"
+echo ""
+echo "  Configuration:"
+echo "    - $OUTPUT_DIR/config.example.yaml"
+echo ""
+echo "  Usage:"
+echo "    Windows: cd dist && $OUTPUT_NAME.exe"
+echo "    Linux:   cd dist && ./$OUTPUT_NAME"
+echo "========================================"

package/template/scripts/clean.bat

@@ -0,0 +1,35 @@
+@echo off
+setlocal enabledelayedexpansion
+
+echo ========================================
+echo   Keystone Clean
+echo ========================================
+echo.
+
+echo Cleaning build artifacts...
+
+if exist "dist" (
+    rmdir /s /q dist
+    echo [OK] Removed dist\
+)
+
+if exist "apps\web\dist" (
+    rmdir /s /q apps\web\dist
+    echo [OK] Removed apps\web\dist\
+)
+
+if exist "apps\server\tmp" (
+    rmdir /s /q apps\server\tmp
+    echo [OK] Removed apps\server\tmp\
+)
+
+if exist "apps\server\internal\frontend\dist" (
+    for /f "delims=" %%i in ('dir /b /a-d "apps\server\internal\frontend\dist\*" 2^>nul ^| findstr /v "^\.gitkeep$"') do del /q "apps\server\internal\frontend\dist\%%i" 2>nul
+    for /d %%i in ("apps\server\internal\frontend\dist\*") do rd /s /q "%%i" 2>nul
+    echo [OK] Cleaned apps\server\internal\frontend\dist\
+)
+
+echo.
+echo ========================================
+echo   Clean completed!
+echo ========================================

package/template/scripts/clean.js

@@ -0,0 +1,25 @@
+#!/usr/bin/env node
+const { spawn } = require('child_process')
+const path = require('path')
+const os = require('os')
+
+const scriptsDir = __dirname
+const isWindows = os.platform() === 'win32'
+const script = isWindows
+  ? path.join(scriptsDir, 'clean.bat')
+  : path.join(scriptsDir, 'clean.sh')
+
+const child = spawn(script, [], {
+  stdio: 'inherit',
+  shell: true,
+  cwd: path.join(scriptsDir, '..'),
+})
+
+child.on('error', (err) => {
+  console.error('Failed to start clean:', err)
+  process.exit(1)
+})
+
+child.on('exit', (code) => {
+  process.exit(code || 0)
+})

package/template/scripts/clean.sh

@@ -0,0 +1,34 @@
+#!/bin/bash
+set -e
+
+echo "========================================"
+echo "  Keystone Clean"
+echo "========================================"
+echo ""
+
+echo "Cleaning build artifacts..."
+
+if [ -d "dist" ]; then
+  rm -rf dist
+  echo "[OK] Removed dist/"
+fi
+
+if [ -d "apps/web/dist" ]; then
+  rm -rf apps/web/dist
+  echo "[OK] Removed apps/web/dist/"
+fi
+
+if [ -d "apps/server/tmp" ]; then
+  rm -rf apps/server/tmp
+  echo "[OK] Removed apps/server/tmp/"
+fi
+
+if [ -d "apps/server/internal/frontend/dist" ]; then
+  find "apps/server/internal/frontend/dist" -mindepth 1 ! -name '.gitkeep' -delete 2>/dev/null || true
+  echo "[OK] Cleaned apps/server/internal/frontend/dist/"
+fi
+
+echo ""
+echo "========================================"
+echo "  Clean completed!"
+echo "========================================"

package/template/scripts/dev.bat

@@ -0,0 +1,82 @@
+@echo off
+setlocal enabledelayedexpansion
+
+echo ========================================
+echo   Keystone Development Server
+echo ========================================
+echo.
+
+REM Check prerequisites
+echo Checking prerequisites...
+
+REM Check Node.js
+where node >nul 2>&1
+if errorlevel 1 (
+    echo [ERROR] Node.js is not installed. Please install Node.js 18+
+    exit /b 1
+)
+for /f "tokens=*" %%i in ('node --version') do set NODE_VERSION=%%i
+echo [OK] Node.js %NODE_VERSION%
+
+REM Check pnpm
+where pnpm >nul 2>&1
+if errorlevel 1 (
+    echo [ERROR] pnpm is not installed. Please install pnpm 8+
+    echo Run: npm install -g pnpm
+    exit /b 1
+)
+for /f "tokens=*" %%i in ('pnpm --version') do set PNPM_VERSION=%%i
+echo [OK] pnpm %PNPM_VERSION%
+
+REM Check Go
+where go >nul 2>&1
+if errorlevel 1 (
+    echo [ERROR] Go is not installed. Please install Go 1.24+
+    exit /b 1
+)
+for /f "tokens=3" %%i in ('go version') do set GO_VERSION=%%i
+echo [OK] Go %GO_VERSION%
+
+REM Check Air
+where air >nul 2>&1
+if errorlevel 1 (
+    echo [WARN] Air is not installed. Installing...
+    go install github.com/air-verse/air@latest
+)
+echo [OK] Air installed
+
+echo.
+echo Prerequisites check passed!
+echo.
+
+REM Create data directories for SQLite (root + apps/server)
+if not exist "apps\\server\\data" mkdir apps\\server\\data
+if not exist "apps\\server\\storage" mkdir apps\\server\\storage
+
+REM Copy config if not exists
+if not exist "apps\\server\\config.yaml" (
+    if exist "apps\\server\\config.example.yaml" (
+        copy "apps\\server\\config.example.yaml" "apps\\server\\config.yaml"
+        echo [INFO] Created apps\\server\\config.yaml from template
+    )
+)
+
+echo Starting development servers...
+echo.
+echo Frontend: http://localhost:3000
+echo Backend:  http://localhost:8080
+echo API Docs: http://localhost:8080/api/docs/index.html
+echo.
+echo Press Ctrl+C to stop
+echo ========================================
+echo.
+
+REM Start backend with Air in a new window
+start "Keystone Backend" cmd /c "cd apps\server && air"
+
+REM Wait a moment for backend to start
+timeout /t 2 /nobreak >nul
+
+REM Start frontend in current window
+cd apps\web
+pnpm dev

package/template/scripts/dev.js

@@ -0,0 +1,25 @@
+#!/usr/bin/env node
+const { spawn } = require('child_process')
+const path = require('path')
+const os = require('os')
+
+const scriptsDir = __dirname
+const isWindows = os.platform() === 'win32'
+const script = isWindows
+  ? path.join(scriptsDir, 'dev.bat')
+  : path.join(scriptsDir, 'dev.sh')
+
+const child = spawn(script, [], {
+  stdio: 'inherit',
+  shell: true,
+  cwd: path.join(scriptsDir, '..'),
+})
+
+child.on('error', (err) => {
+  console.error('Failed to start dev servers:', err)
+  process.exit(1)
+})
+
+child.on('exit', (code) => {
+  process.exit(code || 0)
+})

package/template/scripts/dev.sh

@@ -0,0 +1,88 @@
+#!/bin/bash
+set -e
+
+echo "========================================"
+echo "  Keystone Development Server"
+echo "========================================"
+echo ""
+
+RED='\033[0;31m'
+GREEN='\033[0;32m'
+YELLOW='\033[1;33m'
+NC='\033[0m'
+
+echo "Checking prerequisites..."
+
+if ! command -v node &> /dev/null; then
+  echo -e "${RED}[ERROR]${NC} Node.js is not installed. Please install Node.js 18+"
+  exit 1
+fi
+NODE_VERSION=$(node --version)
+echo -e "${GREEN}[OK]${NC} Node.js $NODE_VERSION"
+
+if ! command -v pnpm &> /dev/null; then
+  echo -e "${RED}[ERROR]${NC} pnpm is not installed. Please install pnpm 8+"
+  echo "Run: npm install -g pnpm"
+  exit 1
+fi
+PNPM_VERSION=$(pnpm --version)
+echo -e "${GREEN}[OK]${NC} pnpm $PNPM_VERSION"
+
+if ! command -v go &> /dev/null; then
+  echo -e "${RED}[ERROR]${NC} Go is not installed. Please install Go 1.24+"
+  exit 1
+fi
+GO_VERSION=$(go version | awk '{print $3}')
+echo -e "${GREEN}[OK]${NC} Go $GO_VERSION"
+
+if ! command -v air &> /dev/null; then
+  echo -e "${YELLOW}[WARN]${NC} Air is not installed. Installing..."
+  go install github.com/air-verse/air@latest
+fi
+echo -e "${GREEN}[OK]${NC} Air installed"
+
+echo ""
+echo "Prerequisites check passed!"
+echo ""
+
+mkdir -p apps/server/data
+mkdir -p apps/server/storage
+
+if [ ! -f "apps/server/config.yaml" ] && [ -f "apps/server/config.example.yaml" ]; then
+  cp apps/server/config.example.yaml apps/server/config.yaml
+  echo -e "${GREEN}[INFO]${NC} Created apps/server/config.yaml from template"
+fi
+
+echo "Starting development servers..."
+echo ""
+echo "Frontend: http://localhost:3000"
+echo "Backend:  http://localhost:8080"
+echo "API Docs: http://localhost:8080/api/docs/index.html"
+echo ""
+echo "Press Ctrl+C to stop"
+echo "========================================"
+echo ""
+
+cleanup() {
+  echo ""
+  echo "Stopping development servers..."
+  kill $BACKEND_PID 2>/dev/null || true
+  kill $FRONTEND_PID 2>/dev/null || true
+  exit 0
+}
+
+trap cleanup SIGINT SIGTERM
+
+cd apps/server
+air &
+BACKEND_PID=$!
+cd ../..
+
+sleep 2
+
+cd apps/web
+pnpm dev &
+FRONTEND_PID=$!
+cd ../..
+
+wait $BACKEND_PID $FRONTEND_PID

package/template/scripts/test.bat

@@ -0,0 +1,86 @@
+@echo off
+setlocal enabledelayedexpansion
+
+echo ========================================
+echo   Keystone Test Runner
+echo ========================================
+echo.
+
+echo Checking prerequisites...
+where node >nul 2>&1
+if errorlevel 1 (
+    echo [ERROR] Node.js is not installed
+    exit /b 1
+)
+echo [OK] Node.js found
+
+where go >nul 2>&1
+if errorlevel 1 (
+    echo [ERROR] Go is not installed
+    exit /b 1
+)
+echo [OK] Go found
+
+echo.
+echo Running tests...
+echo.
+
+set FAILED=0
+
+echo ----------------------------------------
+echo Frontend Tests
+echo ----------------------------------------
+cd apps\web
+call pnpm typecheck
+if errorlevel 1 (
+    echo [FAIL] Frontend typecheck failed
+    set FAILED=1
+) else (
+    echo [OK] Frontend typecheck passed
+)
+call pnpm lint
+if errorlevel 1 (
+    echo [FAIL] Frontend lint failed
+    set FAILED=1
+) else (
+    echo [OK] Frontend lint passed
+)
+call pnpm test
+if errorlevel 1 (
+    echo [FAIL] Frontend tests failed
+    set FAILED=1
+) else (
+    echo [OK] Frontend tests passed
+)
+cd ..\..
+
+echo.
+echo ----------------------------------------
+echo Backend Tests
+echo ----------------------------------------
+cd apps\server
+go vet ./...
+if errorlevel 1 (
+    echo [FAIL] Backend vet failed
+    set FAILED=1
+) else (
+    echo [OK] Backend vet passed
+)
+go test ./... -v
+if errorlevel 1 (
+    echo [FAIL] Backend tests failed
+    set FAILED=1
+) else (
+    echo [OK] Backend tests passed
+)
+cd ..\..
+
+echo.
+echo ========================================
+if %FAILED%==1 (
+    echo   Tests FAILED
+    exit /b 1
+) else (
+    echo   All tests PASSED
+)
+echo ========================================

package/template/scripts/test.js

@@ -0,0 +1,25 @@
+#!/usr/bin/env node
+const { spawn } = require('child_process')
+const path = require('path')
+const os = require('os')
+
+const scriptsDir = __dirname
+const isWindows = os.platform() === 'win32'
+const script = isWindows
+  ? path.join(scriptsDir, 'test.bat')
+  : path.join(scriptsDir, 'test.sh')
+
+const child = spawn(script, [], {
+  stdio: 'inherit',
+  shell: true,
+  cwd: path.join(scriptsDir, '..'),
+})
+
+child.on('error', (err) => {
+  console.error('Failed to start tests:', err)
+  process.exit(1)
+})
+
+child.on('exit', (code) => {
+  process.exit(code || 0)
+})

package/template/scripts/test.sh

@@ -0,0 +1,86 @@
+#!/bin/bash
+set -e
+
+echo "========================================"
+echo "  Keystone Test Runner"
+echo "========================================"
+echo ""
+
+RED='\033[0;31m'
+GREEN='\033[0;32m'
+NC='\033[0m'
+
+echo "Checking prerequisites..."
+if ! command -v node &> /dev/null; then
+  echo -e "${RED}[ERROR]${NC} Node.js is not installed"
+  exit 1
+fi
+echo -e "${GREEN}[OK]${NC} Node.js found"
+
+if ! command -v go &> /dev/null; then
+  echo -e "${RED}[ERROR]${NC} Go is not installed"
+  exit 1
+fi
+echo -e "${GREEN}[OK]${NC} Go found"
+
+echo ""
+echo "Running tests..."
+echo ""
+
+FAILED=0
+
+echo "----------------------------------------"
+echo "Frontend Tests"
+echo "----------------------------------------"
+cd apps/web
+if pnpm typecheck; then
+  echo -e "${GREEN}[OK]${NC} Frontend typecheck passed"
+else
+  echo -e "${RED}[FAIL]${NC} Frontend typecheck failed"
+  FAILED=1
+fi
+
+if pnpm lint; then
+  echo -e "${GREEN}[OK]${NC} Frontend lint passed"
+else
+  echo -e "${RED}[FAIL]${NC} Frontend lint failed"
+  FAILED=1
+fi
+
+if pnpm test; then
+  echo -e "${GREEN}[OK]${NC} Frontend tests passed"
+else
+  echo -e "${RED}[FAIL]${NC} Frontend tests failed"
+  FAILED=1
+fi
+cd ../..
+
+echo ""
+echo "----------------------------------------"
+echo "Backend Tests"
+echo "----------------------------------------"
+cd apps/server
+if go vet ./...; then
+  echo -e "${GREEN}[OK]${NC} Backend vet passed"
+else
+  echo -e "${RED}[FAIL]${NC} Backend vet failed"
+  FAILED=1
+fi
+
+if go test ./... -v; then
+  echo -e "${GREEN}[OK]${NC} Backend tests passed"
+else
+  echo -e "${RED}[FAIL]${NC} Backend tests failed"
+  FAILED=1
+fi
+cd ../..
+
+echo ""
+echo "========================================"
+if [ "$FAILED" -eq 1 ]; then
+  echo -e "  ${RED}Tests FAILED${NC}"
+  exit 1
+else
+  echo -e "  ${GREEN}All tests PASSED${NC}"
+fi
+echo "========================================"

package/template/apps/server/main.go

@@ -1,28 +0,0 @@
-package main
-
-import (
-	"log"
-
-	"github.com/gin-gonic/gin"
-	"gorm.io/gorm"
-
-	"github.com/robsuncn/keystone/bootstrap/config"
-	"github.com/robsuncn/keystone/server"
-
-	"__APP_NAME__/apps/server/internal/demo"
-)
-
-func registerDemoRoutes(router *gin.Engine, _ *config.Config, _ *gorm.DB) {
-	v1 := router.Group("/api/v1")
-	demo.RegisterRoutes(v1)
-}
-
-func main() {
-	app, err := server.New(server.WithRouterHook(registerDemoRoutes))
-	if err != nil {
-		log.Fatalf("failed to initialize server: %v", err)
-	}
-	if err := app.Run(); err != nil {
-		log.Fatalf("server stopped: %v", err)
-	}
-}