nexu-app 2.0.0

package/templates/default/scripts/lib/package-manager.mjs

@@ -0,0 +1,186 @@
+/**
+ * Package manager detection and utilities
+ * Supports: npm, yarn, pnpm
+ */
+
+import fs from 'fs';
+import path from 'path';
+import { execSync, spawnSync } from 'child_process';
+
+/**
+ * Detect which package manager is being used in a project
+ * @param {string} projectDir - The project directory to check
+ * @returns {'pnpm' | 'yarn' | 'npm'} The detected package manager
+ */
+export function detectPackageManager(projectDir = process.cwd()) {
+  // Check for lock files
+  if (fs.existsSync(path.join(projectDir, 'pnpm-lock.yaml'))) {
+    return 'pnpm';
+  }
+  if (fs.existsSync(path.join(projectDir, 'yarn.lock'))) {
+    return 'yarn';
+  }
+  if (fs.existsSync(path.join(projectDir, 'package-lock.json'))) {
+    return 'npm';
+  }
+
+  // Check packageManager field in package.json
+  const packageJsonPath = path.join(projectDir, 'package.json');
+  if (fs.existsSync(packageJsonPath)) {
+    try {
+      const pkg = JSON.parse(fs.readFileSync(packageJsonPath, 'utf-8'));
+      if (pkg.packageManager) {
+        if (pkg.packageManager.startsWith('pnpm')) return 'pnpm';
+        if (pkg.packageManager.startsWith('yarn')) return 'yarn';
+        if (pkg.packageManager.startsWith('npm')) return 'npm';
+      }
+    } catch {
+      // Ignore parse errors
+    }
+  }
+
+  // Check npm_config_user_agent environment variable (set by package managers)
+  const userAgent = process.env.npm_config_user_agent || '';
+  if (userAgent.includes('pnpm')) return 'pnpm';
+  if (userAgent.includes('yarn')) return 'yarn';
+
+  // Default to npm
+  return 'npm';
+}
+
+/**
+ * Check if a package manager is installed
+ * @param {string} pm - Package manager name
+ * @returns {boolean}
+ */
+export function isPackageManagerInstalled(pm) {
+  try {
+    const result = spawnSync(process.platform === 'win32' ? 'where' : 'which', [pm], {
+      stdio: 'pipe',
+    });
+    return result.status === 0;
+  } catch {
+    return false;
+  }
+}
+
+/**
+ * Get the run command for a package manager
+ * @param {'pnpm' | 'yarn' | 'npm'} pm
+ * @returns {string}
+ */
+export function getRunCommand(pm) {
+  switch (pm) {
+    case 'pnpm':
+      return 'pnpm';
+    case 'yarn':
+      return 'yarn';
+    case 'npm':
+    default:
+      return 'npm run';
+  }
+}
+
+/**
+ * Get the execute command (for running binaries)
+ * @param {'pnpm' | 'yarn' | 'npm'} pm
+ * @returns {string}
+ */
+export function getExecCommand(pm) {
+  switch (pm) {
+    case 'pnpm':
+      return 'pnpm exec';
+    case 'yarn':
+      return 'yarn';
+    case 'npm':
+    default:
+      return 'npx';
+  }
+}
+
+/**
+ * Get the install command
+ * @param {'pnpm' | 'yarn' | 'npm'} pm
+ * @param {object} options
+ * @param {boolean} options.frozen - Use frozen lockfile
+ * @returns {string}
+ */
+export function getInstallCommand(pm, options = {}) {
+  const { frozen = false } = options;
+
+  switch (pm) {
+    case 'pnpm':
+      return frozen ? 'pnpm install --frozen-lockfile' : 'pnpm install';
+    case 'yarn':
+      return frozen ? 'yarn install --frozen-lockfile' : 'yarn install';
+    case 'npm':
+    default:
+      return frozen ? 'npm ci' : 'npm install';
+  }
+}
+
+/**
+ * Get the add dependency command
+ * @param {'pnpm' | 'yarn' | 'npm'} pm
+ * @param {string} pkg - Package name
+ * @param {object} options
+ * @param {boolean} options.dev - Install as dev dependency
+ * @returns {string}
+ */
+export function getAddCommand(pm, pkg, options = {}) {
+  const { dev = false } = options;
+
+  switch (pm) {
+    case 'pnpm':
+      return dev ? `pnpm add -D ${pkg}` : `pnpm add ${pkg}`;
+    case 'yarn':
+      return dev ? `yarn add -D ${pkg}` : `yarn add ${pkg}`;
+    case 'npm':
+    default:
+      return dev ? `npm install -D ${pkg}` : `npm install ${pkg}`;
+  }
+}
+
+/**
+ * Get workspace filter command
+ * @param {'pnpm' | 'yarn' | 'npm'} pm
+ * @param {string} workspace - Workspace name
+ * @returns {string}
+ */
+export function getWorkspaceFilter(pm, workspace) {
+  switch (pm) {
+    case 'pnpm':
+      return `--filter=${workspace}`;
+    case 'yarn':
+      return `workspace ${workspace}`;
+    case 'npm':
+    default:
+      return `-w ${workspace}`;
+  }
+}
+
+/**
+ * Run a command with the detected package manager
+ * @param {string} script - Script to run
+ * @param {object} options
+ * @param {string} options.cwd - Working directory
+ * @param {'pnpm' | 'yarn' | 'npm'} options.pm - Package manager (auto-detected if not provided)
+ */
+export function runScript(script, options = {}) {
+  const { cwd = process.cwd(), pm = detectPackageManager(cwd) } = options;
+  const runCmd = getRunCommand(pm);
+  const cmd = `${runCmd} ${script}`;
+  console.log(`> ${cmd}`);
+  execSync(cmd, { stdio: 'inherit', cwd });
+}
+
+export default {
+  detectPackageManager,
+  isPackageManagerInstalled,
+  getRunCommand,
+  getExecCommand,
+  getInstallCommand,
+  getAddCommand,
+  getWorkspaceFilter,
+  runScript,
+};

package/templates/default/scripts/setup.mjs

@@ -0,0 +1,102 @@
+#!/usr/bin/env node
+
+import fs from 'fs';
+import path from 'path';
+import { execSync } from 'child_process';
+import { fileURLToPath } from 'url';
+import {
+  detectPackageManager,
+  isPackageManagerInstalled,
+  getInstallCommand,
+  getRunCommand,
+} from './lib/package-manager.mjs';
+
+const __filename = fileURLToPath(import.meta.url);
+const __dirname = path.dirname(__filename);
+const ROOT_DIR = path.resolve(__dirname, '..');
+
+// Detect package manager
+const pm = detectPackageManager(ROOT_DIR);
+const runCmd = getRunCommand(pm);
+
+console.log('🚀 Setting up monorepo...');
+console.log(`📦 Using package manager: ${pm}`);
+
+function run(cmd) {
+  console.log(`> ${cmd}`);
+  execSync(cmd, { stdio: 'inherit', cwd: ROOT_DIR });
+}
+
+// Check if package manager is installed
+if (!isPackageManagerInstalled(pm)) {
+  console.log(`📦 Installing ${pm}...`);
+  if (pm === 'pnpm') {
+    run('npm install -g pnpm');
+  } else if (pm === 'yarn') {
+    run('npm install -g yarn');
+  }
+}
+
+// Install dependencies
+console.log('📦 Installing dependencies...');
+run(getInstallCommand(pm));
+
+// Setup husky
+console.log('🐶 Setting up Husky...');
+run(`${runCmd} prepare`);
+
+// Create environment files
+console.log('🔐 Creating environment files...');
+
+const envPath = path.join(ROOT_DIR, '.env');
+if (!fs.existsSync(envPath)) {
+  const envContent = `# Database
+DATABASE_URL=postgresql://postgres:postgres@localhost:5432/nexu
+DB_USER=postgres
+DB_PASSWORD=postgres
+DB_NAME=nexu
+
+# API
+API_URL=http://localhost:4000
+
+# App
+NODE_ENV=development
+`;
+  fs.writeFileSync(envPath, envContent);
+  console.log('✅ Created .env file');
+}
+
+const webEnvPath = path.join(ROOT_DIR, 'apps', 'web', '.env.local');
+const webAppsDir = path.join(ROOT_DIR, 'apps', 'web');
+if (fs.existsSync(webAppsDir) && !fs.existsSync(webEnvPath)) {
+  const webEnvContent = `NEXT_PUBLIC_API_URL=http://localhost:4000
+`;
+  fs.writeFileSync(webEnvPath, webEnvContent);
+  console.log('✅ Created apps/web/.env.local');
+}
+
+const apiEnvPath = path.join(ROOT_DIR, 'apps', 'api', '.env');
+const apiAppsDir = path.join(ROOT_DIR, 'apps', 'api');
+if (fs.existsSync(apiAppsDir) && !fs.existsSync(apiEnvPath)) {
+  const apiEnvContent = `DATABASE_URL=postgresql://postgres:postgres@localhost:5432/nexu
+PORT=4000
+NODE_ENV=development
+`;
+  fs.writeFileSync(apiEnvPath, apiEnvContent);
+  console.log('✅ Created apps/api/.env');
+}
+
+// Build packages
+console.log('🔨 Building packages...');
+run(`${runCmd} build`);
+
+console.log('');
+console.log('✅ Setup complete!');
+console.log('');
+console.log('Available commands:');
+console.log(`  ${runCmd} dev          - Start development servers`);
+console.log(`  ${runCmd} build        - Build all packages`);
+console.log(`  ${runCmd} lint         - Run linting`);
+console.log(`  ${runCmd} test         - Run tests`);
+console.log(`  ${runCmd} docker:dev   - Start with Docker (dev)`);
+console.log('');

package/templates/default/services/.env.example

@@ -0,0 +1,16 @@
+# Database
+POSTGRES_USER=nexu
+POSTGRES_PASSWORD=nexu
+POSTGRES_DB=nexu
+
+# Messaging
+RABBITMQ_USER=nexu
+RABBITMQ_PASSWORD=nexu
+
+# Monitoring
+GRAFANA_USER=admin
+GRAFANA_PASSWORD=admin
+
+# Storage
+MINIO_USER=nexu
+MINIO_PASSWORD=nexu1234

package/templates/default/services/docker-compose.yml

@@ -0,0 +1,207 @@
+version: '3.8'
+
+# Base docker-compose for external services
+# Usage: docker compose -f services/docker-compose.yml --profile <profile> up -d
+#
+# Available profiles:
+#   - database: PostgreSQL, Redis
+#   - messaging: RabbitMQ, Kafka
+#   - monitoring: Prometheus, Grafana
+#   - storage: MinIO (S3-compatible)
+#   - search: Elasticsearch
+#   - all: All services
+
+networks:
+  nexu-network:
+    driver: bridge
+
+volumes:
+  postgres_data:
+  redis_data:
+  rabbitmq_data:
+  kafka_data:
+  zookeeper_data:
+  prometheus_data:
+  grafana_data:
+  minio_data:
+  elasticsearch_data:
+
+services:
+  # ============================================
+  # DATABASE SERVICES
+  # ============================================
+  postgres:
+    image: postgres:16-alpine
+    container_name: nexu-postgres
+    profiles: ['database', 'all']
+    environment:
+      POSTGRES_USER: ${POSTGRES_USER:-nexu}
+      POSTGRES_PASSWORD: ${POSTGRES_PASSWORD:-nexu}
+      POSTGRES_DB: ${POSTGRES_DB:-nexu}
+    ports:
+      - '5432:5432'
+    volumes:
+      - postgres_data:/var/lib/postgresql/data
+      - ./postgres/init:/docker-entrypoint-initdb.d
+    networks:
+      - nexu-network
+    healthcheck:
+      test: ['CMD-SHELL', 'pg_isready -U ${POSTGRES_USER:-nexu}']
+      interval: 10s
+      timeout: 5s
+      retries: 5
+
+  redis:
+    image: redis:7-alpine
+    container_name: nexu-redis
+    profiles: ['database', 'all']
+    command: redis-server --appendonly yes
+    ports:
+      - '6379:6379'
+    volumes:
+      - redis_data:/data
+    networks:
+      - nexu-network
+    healthcheck:
+      test: ['CMD', 'redis-cli', 'ping']
+      interval: 10s
+      timeout: 5s
+      retries: 5
+
+  # ============================================
+  # MESSAGING SERVICES
+  # ============================================
+  rabbitmq:
+    image: rabbitmq:3-management-alpine
+    container_name: nexu-rabbitmq
+    profiles: ['messaging', 'all']
+    environment:
+      RABBITMQ_DEFAULT_USER: ${RABBITMQ_USER:-nexu}
+      RABBITMQ_DEFAULT_PASS: ${RABBITMQ_PASSWORD:-nexu}
+    ports:
+      - '5672:5672'
+      - '15672:15672'
+    volumes:
+      - rabbitmq_data:/var/lib/rabbitmq
+    networks:
+      - nexu-network
+    healthcheck:
+      test: ['CMD', 'rabbitmq-diagnostics', '-q', 'ping']
+      interval: 30s
+      timeout: 10s
+      retries: 5
+
+  zookeeper:
+    image: confluentinc/cp-zookeeper:7.5.0
+    container_name: nexu-zookeeper
+    profiles: ['messaging', 'all']
+    environment:
+      ZOOKEEPER_CLIENT_PORT: 2181
+      ZOOKEEPER_TICK_TIME: 2000
+    ports:
+      - '2181:2181'
+    volumes:
+      - zookeeper_data:/var/lib/zookeeper/data
+    networks:
+      - nexu-network
+
+  kafka:
+    image: confluentinc/cp-kafka:7.5.0
+    container_name: nexu-kafka
+    profiles: ['messaging', 'all']
+    depends_on:
+      - zookeeper
+    environment:
+      KAFKA_BROKER_ID: 1
+      KAFKA_ZOOKEEPER_CONNECT: zookeeper:2181
+      KAFKA_ADVERTISED_LISTENERS: PLAINTEXT://localhost:9092
+      KAFKA_OFFSETS_TOPIC_REPLICATION_FACTOR: 1
+    ports:
+      - '9092:9092'
+    volumes:
+      - kafka_data:/var/lib/kafka/data
+    networks:
+      - nexu-network
+
+  # ============================================
+  # MONITORING SERVICES
+  # ============================================
+  prometheus:
+    image: prom/prometheus:latest
+    container_name: nexu-prometheus
+    profiles: ['monitoring', 'all']
+    command:
+      - '--config.file=/etc/prometheus/prometheus.yml'
+      - '--storage.tsdb.path=/prometheus'
+    ports:
+      - '9090:9090'
+    volumes:
+      - ./prometheus/prometheus.yml:/etc/prometheus/prometheus.yml
+      - prometheus_data:/prometheus
+    networks:
+      - nexu-network
+
+  grafana:
+    image: grafana/grafana:latest
+    container_name: nexu-grafana
+    profiles: ['monitoring', 'all']
+    environment:
+      GF_SECURITY_ADMIN_USER: ${GRAFANA_USER:-admin}
+      GF_SECURITY_ADMIN_PASSWORD: ${GRAFANA_PASSWORD:-admin}
+    ports:
+      - '3001:3000'
+    volumes:
+      - grafana_data:/var/lib/grafana
+      - ./grafana/provisioning:/etc/grafana/provisioning
+    networks:
+      - nexu-network
+    depends_on:
+      - prometheus
+
+  # ============================================
+  # STORAGE SERVICES
+  # ============================================
+  minio:
+    image: minio/minio:latest
+    container_name: nexu-minio
+    profiles: ['storage', 'all']
+    command: server /data --console-address ":9001"
+    environment:
+      MINIO_ROOT_USER: ${MINIO_USER:-nexu}
+      MINIO_ROOT_PASSWORD: ${MINIO_PASSWORD:-nexu1234}
+    ports:
+      - '9000:9000'
+      - '9001:9001'
+    volumes:
+      - minio_data:/data
+    networks:
+      - nexu-network
+    healthcheck:
+      test: ['CMD', 'curl', '-f', 'http://localhost:9000/minio/health/live']
+      interval: 30s
+      timeout: 20s
+      retries: 3
+
+  # ============================================
+  # SEARCH SERVICES
+  # ============================================
+  elasticsearch:
+    image: elasticsearch:8.11.0
+    container_name: nexu-elasticsearch
+    profiles: ['search', 'all']
+    environment:
+      - discovery.type=single-node
+      - xpack.security.enabled=false
+      - 'ES_JAVA_OPTS=-Xms512m -Xmx512m'
+    ports:
+      - '9200:9200'
+      - '9300:9300'
+    volumes:
+      - elasticsearch_data:/usr/share/elasticsearch/data
+    networks:
+      - nexu-network
+    healthcheck:
+      test: ['CMD-SHELL', 'curl -s http://localhost:9200 | grep -q "cluster_name"']
+      interval: 30s
+      timeout: 10s
+      retries: 5

package/templates/default/services/grafana/provisioning/dashboards/dashboards.yml

@@ -0,0 +1,11 @@
+apiVersion: 1
+
+providers:
+  - name: 'default'
+    orgId: 1
+    folder: ''
+    type: file
+    disableDeletion: false
+    editable: true
+    options:
+      path: /etc/grafana/provisioning/dashboards

package/templates/default/services/grafana/provisioning/datasources/datasources.yml

@@ -0,0 +1,9 @@
+apiVersion: 1
+
+datasources:
+  - name: Prometheus
+    type: prometheus
+    access: proxy
+    url: http://prometheus:9090
+    isDefault: true
+    editable: false

package/templates/default/services/postgres/init/gitkeep

@@ -0,0 +1,2 @@
+# Place your SQL initialization scripts here
+# They will be executed in alphabetical order when the container starts

package/templates/default/services/prometheus/prometheus.yml

@@ -0,0 +1,13 @@
+global:
+  scrape_interval: 15s
+  evaluation_interval: 15s
+
+scrape_configs:
+  - job_name: 'prometheus'
+    static_configs:
+      - targets: ['localhost:9090']
+
+  # Add your app targets here
+  # - job_name: 'nexu-api'
+  #   static_configs:
+  #     - targets: ['host.docker.internal:3000']

package/templates/default/tsconfig.json

@@ -0,0 +1,27 @@
+{
+  "compilerOptions": {
+    "target": "ES2022",
+    "lib": ["ES2022", "DOM", "DOM.Iterable"],
+    "jsx": "react-jsx",
+    "module": "ESNext",
+    "moduleResolution": "bundler",
+    "resolveJsonModule": true,
+    "allowJs": false,
+    "declaration": true,
+    "declarationMap": true,
+    "sourceMap": true,
+    "noEmit": true,
+    "strict": true,
+    "noImplicitAny": true,
+    "strictNullChecks": true,
+    "noUnusedLocals": true,
+    "noUnusedParameters": true,
+    "noFallthroughCasesInSwitch": true,
+    "esModuleInterop": true,
+    "allowSyntheticDefaultImports": true,
+    "forceConsistentCasingInFileNames": true,
+    "skipLibCheck": true,
+    "isolatedModules": true
+  },
+  "exclude": ["node_modules", "dist", ".next", "coverage", "packages/config", "scripts"]
+}

package/templates/default/turbo.json

@@ -0,0 +1,40 @@
+{
+  "$schema": "https://turbo.build/schema.json",
+  "globalDependencies": ["**/.env.*local"],
+  "globalEnv": ["NODE_ENV"],
+  "remoteCache": {
+    "signature": true
+  },
+  "tasks": {
+    "build": {
+      "dependsOn": ["^build"],
+      "outputs": ["dist/**", ".next/**", "!.next/cache/**"]
+    },
+    "dev": {
+      "cache": false,
+      "persistent": true
+    },
+    "lint": {
+      "dependsOn": ["^build"],
+      "outputs": []
+    },
+    "lint:fix": {
+      "outputs": []
+    },
+    "test": {
+      "dependsOn": ["build"],
+      "outputs": ["coverage/**"]
+    },
+    "test:coverage": {
+      "dependsOn": ["build"],
+      "outputs": ["coverage/**"]
+    },
+    "typecheck": {
+      "dependsOn": ["^build"],
+      "outputs": []
+    },
+    "clean": {
+      "cache": false
+    }
+  }
+}

package/templates/default/vitest.config.ts

@@ -0,0 +1,15 @@
+import { defineConfig } from 'vitest/config';
+
+export default defineConfig({
+  test: {
+    globals: true,
+    environment: 'node',
+    include: ['**/*.{test,spec}.{ts,tsx}'],
+    exclude: ['**/node_modules/**', '**/dist/**'],
+    coverage: {
+      provider: 'v8',
+      reporter: ['text', 'json', 'html'],
+      exclude: ['node_modules/', 'dist/', '**/*.config.*', '**/*.d.ts', '**/types/'],
+    },
+  },
+});