create-carlonicora-app 1.0.0

package/dist/utils/files.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"files.js","sourceRoot":"","sources":["../../src/utils/files.ts"],"names":[],"mappings":"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"}

package/dist/utils/logger.d.ts

@@ -0,0 +1,12 @@
+export declare const logger: {
+    info: (message: string) => void;
+    success: (message: string) => void;
+    warn: (message: string) => void;
+    error: (message: string) => void;
+    title: (message: string) => void;
+    step: (step: number, total: number, message: string) => void;
+    command: (cmd: string) => void;
+    newline: () => void;
+};
+export declare function printSuccessMessage(projectName: string, targetDir: string): void;
+//# sourceMappingURL=logger.d.ts.map

package/dist/utils/logger.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"logger.d.ts","sourceRoot":"","sources":["../../src/utils/logger.ts"],"names":[],"mappings":"AAEA,eAAO,MAAM,MAAM;oBACD,MAAM;uBACH,MAAM;oBACT,MAAM;qBACL,MAAM;qBAEN,MAAM;iBAEV,MAAM,SAAS,MAAM,WAAW,MAAM;mBAGpC,MAAM;;CAGtB,CAAC;AAEF,wBAAgB,mBAAmB,CAAC,WAAW,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,GAAG,IAAI,CAsBhF"}

package/dist/utils/logger.js

@@ -0,0 +1,35 @@
+import chalk from 'chalk';
+export const logger = {
+    info: (message) => console.log(chalk.blue('info'), message),
+    success: (message) => console.log(chalk.green('success'), message),
+    warn: (message) => console.log(chalk.yellow('warn'), message),
+    error: (message) => console.log(chalk.red('error'), message),
+    title: (message) => console.log(chalk.bold.cyan(`\n${message}\n`)),
+    step: (step, total, message) => console.log(chalk.gray(`[${step}/${total}]`), message),
+    command: (cmd) => console.log(chalk.cyan(`  ${cmd}`)),
+    newline: () => console.log(),
+};
+export function printSuccessMessage(projectName, targetDir) {
+    console.log();
+    console.log(chalk.green.bold('Success!'), `Created ${chalk.cyan(projectName)} at ${chalk.gray(targetDir)}`);
+    console.log();
+    console.log('Inside that directory, you can run several commands:');
+    console.log();
+    console.log(chalk.cyan('  pnpm dev'));
+    console.log('    Starts the development server');
+    console.log();
+    console.log(chalk.cyan('  pnpm build'));
+    console.log('    Builds the app for production');
+    console.log();
+    console.log(chalk.cyan('  pnpm test'));
+    console.log('    Runs the test suite');
+    console.log();
+    console.log('We suggest that you begin by typing:');
+    console.log();
+    console.log(chalk.cyan(`  cd ${projectName}`));
+    console.log(chalk.cyan('  cp .env.example .env'));
+    console.log(chalk.gray('  # Edit .env with your configuration'));
+    console.log(chalk.cyan('  pnpm dev'));
+    console.log();
+}
+//# sourceMappingURL=logger.js.map

package/dist/utils/logger.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"logger.js","sourceRoot":"","sources":["../../src/utils/logger.ts"],"names":[],"mappings":"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"}

package/dist/utils/validation.d.ts

@@ -0,0 +1,6 @@
+import type { ValidationResult } from '../types/index.js';
+export declare function validateProjectName(name: string): ValidationResult;
+export declare function toKebabCase(str: string): string;
+export declare function toPascalCase(str: string): string;
+export declare function toCamelCase(str: string): string;
+//# sourceMappingURL=validation.d.ts.map

package/dist/utils/validation.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"validation.d.ts","sourceRoot":"","sources":["../../src/utils/validation.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,mBAAmB,CAAC;AAuB1D,wBAAgB,mBAAmB,CAAC,IAAI,EAAE,MAAM,GAAG,gBAAgB,CAgClE;AAED,wBAAgB,WAAW,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CAK/C;AAED,wBAAgB,YAAY,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CAKhD;AAED,wBAAgB,WAAW,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CAG/C"}

package/dist/utils/validation.js

@@ -0,0 +1,63 @@
+const RESERVED_NAMES = [
+    'node_modules',
+    'favicon.ico',
+    'package',
+    'npm',
+    'test',
+    'tests',
+    'src',
+    'dist',
+    'build',
+    'public',
+    'static',
+    'assets',
+    'app',
+    'api',
+    'web',
+];
+// Valid npm package name pattern (kebab-case)
+const NPM_NAME_REGEX = /^(?:@[a-z0-9-*~][a-z0-9-*._~]*\/)?[a-z0-9-~][a-z0-9-._~]*$/;
+export function validateProjectName(name) {
+    // Must not be empty
+    if (!name || name.trim() === '') {
+        return { valid: false, message: 'Project name cannot be empty' };
+    }
+    const trimmedName = name.trim();
+    // Must be valid npm package name (kebab-case)
+    if (!NPM_NAME_REGEX.test(trimmedName)) {
+        return {
+            valid: false,
+            message: 'Project name must be lowercase, kebab-case (e.g., my-project)',
+        };
+    }
+    // Must not be a reserved name
+    if (RESERVED_NAMES.includes(trimmedName.toLowerCase())) {
+        return { valid: false, message: `"${trimmedName}" is a reserved name` };
+    }
+    // Must not start with a dot or underscore
+    if (trimmedName.startsWith('.') || trimmedName.startsWith('_')) {
+        return { valid: false, message: 'Project name cannot start with a dot or underscore' };
+    }
+    // Reasonable length limit
+    if (trimmedName.length > 100) {
+        return { valid: false, message: 'Project name is too long (max 100 characters)' };
+    }
+    return { valid: true };
+}
+export function toKebabCase(str) {
+    return str
+        .replace(/([a-z])([A-Z])/g, '$1-$2')
+        .replace(/[\s_]+/g, '-')
+        .toLowerCase();
+}
+export function toPascalCase(str) {
+    return str
+        .split(/[-_\s]+/)
+        .map((word) => word.charAt(0).toUpperCase() + word.slice(1).toLowerCase())
+        .join('');
+}
+export function toCamelCase(str) {
+    const pascal = toPascalCase(str);
+    return pascal.charAt(0).toLowerCase() + pascal.slice(1);
+}
+//# sourceMappingURL=validation.js.map

package/dist/utils/validation.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"validation.js","sourceRoot":"","sources":["../../src/utils/validation.ts"],"names":[],"mappings":"AAEA,MAAM,cAAc,GAAG;IACrB,cAAc;IACd,aAAa;IACb,SAAS;IACT,KAAK;IACL,MAAM;IACN,OAAO;IACP,KAAK;IACL,MAAM;IACN,OAAO;IACP,QAAQ;IACR,QAAQ;IACR,QAAQ;IACR,KAAK;IACL,KAAK;IACL,KAAK;CACN,CAAC;AAEF,8CAA8C;AAC9C,MAAM,cAAc,GAAG,4DAA4D,CAAC;AAEpF,MAAM,UAAU,mBAAmB,CAAC,IAAY;IAC9C,oBAAoB;IACpB,IAAI,CAAC,IAAI,IAAI,IAAI,CAAC,IAAI,EAAE,KAAK,EAAE,EAAE,CAAC;QAChC,OAAO,EAAE,KAAK,EAAE,KAAK,EAAE,OAAO,EAAE,8BAA8B,EAAE,CAAC;IACnE,CAAC;IAED,MAAM,WAAW,GAAG,IAAI,CAAC,IAAI,EAAE,CAAC;IAEhC,8CAA8C;IAC9C,IAAI,CAAC,cAAc,CAAC,IAAI,CAAC,WAAW,CAAC,EAAE,CAAC;QACtC,OAAO;YACL,KAAK,EAAE,KAAK;YACZ,OAAO,EAAE,+DAA+D;SACzE,CAAC;IACJ,CAAC;IAED,8BAA8B;IAC9B,IAAI,cAAc,CAAC,QAAQ,CAAC,WAAW,CAAC,WAAW,EAAE,CAAC,EAAE,CAAC;QACvD,OAAO,EAAE,KAAK,EAAE,KAAK,EAAE,OAAO,EAAE,IAAI,WAAW,sBAAsB,EAAE,CAAC;IAC1E,CAAC;IAED,0CAA0C;IAC1C,IAAI,WAAW,CAAC,UAAU,CAAC,GAAG,CAAC,IAAI,WAAW,CAAC,UAAU,CAAC,GAAG,CAAC,EAAE,CAAC;QAC/D,OAAO,EAAE,KAAK,EAAE,KAAK,EAAE,OAAO,EAAE,oDAAoD,EAAE,CAAC;IACzF,CAAC;IAED,0BAA0B;IAC1B,IAAI,WAAW,CAAC,MAAM,GAAG,GAAG,EAAE,CAAC;QAC7B,OAAO,EAAE,KAAK,EAAE,KAAK,EAAE,OAAO,EAAE,+CAA+C,EAAE,CAAC;IACpF,CAAC;IAED,OAAO,EAAE,KAAK,EAAE,IAAI,EAAE,CAAC;AACzB,CAAC;AAED,MAAM,UAAU,WAAW,CAAC,GAAW;IACrC,OAAO,GAAG;SACP,OAAO,CAAC,iBAAiB,EAAE,OAAO,CAAC;SACnC,OAAO,CAAC,SAAS,EAAE,GAAG,CAAC;SACvB,WAAW,EAAE,CAAC;AACnB,CAAC;AAED,MAAM,UAAU,YAAY,CAAC,GAAW;IACtC,OAAO,GAAG;SACP,KAAK,CAAC,SAAS,CAAC;SAChB,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,WAAW,EAAE,GAAG,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,WAAW,EAAE,CAAC;SACzE,IAAI,CAAC,EAAE,CAAC,CAAC;AACd,CAAC;AAED,MAAM,UAAU,WAAW,CAAC,GAAW;IACrC,MAAM,MAAM,GAAG,YAAY,CAAC,GAAG,CAAC,CAAC;IACjC,OAAO,MAAM,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,WAAW,EAAE,GAAG,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC;AAC1D,CAAC"}

package/package.json

@@ -0,0 +1,52 @@
+{
+  "name": "create-carlonicora-app",
+  "version": "1.0.0",
+  "description": "Create a NestJS + Next.js monorepo project with Neo4j and JSON:API",
+  "main": "dist/index.js",
+  "type": "module",
+  "bin": {
+    "create-carlonicora-app": "./bin/cli.js"
+  },
+  "files": [
+    "dist",
+    "bin",
+    "template"
+  ],
+  "scripts": {
+    "build": "tsc",
+    "dev": "tsc --watch",
+    "sync-template": "node scripts/sync-template.js",
+    "prepublishOnly": "npm run build"
+  },
+  "keywords": [
+    "cli",
+    "scaffold",
+    "nestjs",
+    "nextjs",
+    "monorepo",
+    "template",
+    "neo4j",
+    "jsonapi"
+  ],
+  "author": "Carlo Nicora",
+  "license": "GPL-3.0",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/carlonicora/create-carlonicora-app"
+  },
+  "engines": {
+    "node": ">=18.0.0"
+  },
+  "dependencies": {
+    "@inquirer/prompts": "^7.0.0",
+    "chalk": "^5.3.0",
+    "commander": "^12.0.0",
+    "fs-extra": "^11.2.0",
+    "ora": "^8.0.0"
+  },
+  "devDependencies": {
+    "@types/fs-extra": "^11.0.4",
+    "@types/node": "^22.0.0",
+    "typescript": "^5.6.0"
+  }
+}

package/template/.env.example

@@ -0,0 +1,159 @@
+# =============================================================================
+# API CONFIGURATION (API)
+# =============================================================================
+API_URL="http://api.{{name}}.test:3950/"
+API_PORT=3950
+API_NODE_OPTIONS="--max-old-space-size=6144"
+WORKER_NODE_OPTIONS="--max-old-space-size=6144"
+
+# =============================================================================
+# WEB APP CONFIGURATION (WEB)
+# =============================================================================
+APP_URL="http://{{name}}.test:3951/"
+NEXT_PUBLIC_API_URL="http://api.{{name}}.test:3950/"
+NEXT_PUBLIC_ADDRESS="http://{{name}}.test:3951"
+PORT=3951
+WEB_NODE_OPTIONS="--max-old-space-size=4096"
+
+# =============================================================================
+# LOGGING
+# =============================================================================
+CONSOLE_ENABLED=true
+
+# =============================================================================
+# DATABASE - NEO4J (API)
+# =============================================================================
+NEO4J_URI=bolt://localhost:7687
+NEO4J_USER=neo4j
+NEO4J_PASSWORD=password
+NEO4J_DATABASE={{name}}
+
+# =============================================================================
+# CACHE & QUEUE - REDIS (API)
+# =============================================================================
+REDIS_HOST=localhost
+REDIS_PASSWORD=
+REDIS_PORT=6379
+REDIS_USERNAME=
+REDIS_QUEUE={{name}}
+
+# =============================================================================
+# CACHE CONFIGURATION (API)
+# =============================================================================
+CACHE_ENABLED=false
+CACHE_DEFAULT_TTL=600
+CACHE_SKIP_PATTERNS=""
+
+# =============================================================================
+# AUTHENTICATION - JWT (API)
+# =============================================================================
+JWT_SECRET="{{name}}_SECRET"
+JWT_EXPIRES_IN="1d"
+
+# =============================================================================
+# WEB PUSH - VAPID (API & WEB)
+# =============================================================================
+VAPID_PUBLIC_KEY=""
+VAPID_PRIVATE_KEY=""
+VAPID_EMAIL=""
+
+# Web-specific VAPID public key (for client-side use)
+NEXT_PUBLIC_VAPID_PUBLIC_KEY=
+
+# =============================================================================
+# EMAIL CONFIGURATION (API)
+# =============================================================================
+EMAIL_PROVIDER=
+EMAIL_API_KEY=
+EMAIL_FROM=
+
+# =============================================================================
+# LOGGING - LOKI (API)
+# =============================================================================
+LOKI_ENABLED=true
+LOKI_HOST=http://api.{{name}}.test:3100
+# LOKI_USERNAME=your_username
+# LOKI_PASSWORD=your_password
+LOKI_APP_LABEL={{name}}-api
+
+# =============================================================================
+# TRACING - TEMPO (API)
+# =============================================================================
+TEMPO_ENABLED=true
+TEMPO_ENDPOINT=http://localhost:4318/v1/traces
+TEMPO_SERVICE_NAME={{name}}-api
+TEMPO_SERVICE_VERSION=1.0.0
+
+# =============================================================================
+# OBJECT STORAGE - S3 / MINIO (API)
+# =============================================================================
+S3_TYPE="minio"
+S3_ENDPOINT="http://minio.{{name}}.test:9000/"
+S3_BUCKET="{{name}}"
+S3_ACCESS_KEY_ID="minioadmin"
+S3_SECRET_ACCESS_KEY="minioadmin"
+S3_REGION=""
+
+# =============================================================================
+# RATE LIMITING / THROTTLER (API)
+# =============================================================================
+RATE_LIMIT_ENABLED=true
+RATE_LIMIT_TTL=60000
+RATE_LIMIT_REQUESTS=1000
+IP_RATE_LIMIT_REQUESTS=200
+
+# =============================================================================
+# CORS CONFIGURATION (API)
+# =============================================================================
+CORS_ORIGINS=http://{{name}}.test:3951
+CORS_ORIGIN_PATTERNS=
+CORS_CREDENTIALS=true
+CORS_METHODS=GET,HEAD,PUT,PATCH,POST,DELETE,OPTIONS
+CORS_ALLOWED_HEADERS=Content-Type,Authorization,X-Requested-With,x-language,x-companyid
+CORS_MAX_AGE=86400
+CORS_PREFLIGHT_CONTINUE=false
+CORS_OPTIONS_SUCCESS_STATUS=204
+CORS_LOG_VIOLATIONS=false
+
+# =============================================================================
+# IMAGE SOURCES (WEB)
+# =============================================================================
+IMAGE_SOURCES=http://localhost:9000,http://host.docker.internal:9000,http://minio.{{name}}.test:9000
+
+# =============================================================================
+# AI
+# =============================================================================
+AI_PROVIDER=
+AI_API_KEY=
+AI_MODEL=
+AI_URL=
+AI_REGION=
+AI_SECRET=
+AI_INSTANCE=
+AI_API_VERSION=
+AI_INPUT_COST_PER_1M_TOKENS=0.1
+AI_OUTPUT_COST_PER_1M_TOKENS=0.4
+
+# =============================================================================
+# EMBEDDER (API)
+# =============================================================================
+EMBEDDER_PROVIDER=
+EMBEDDER_API_KEY=
+EMBEDDER_MODEL=
+EMBEDDER_URL=
+EMBEDDER_INSTANCE=
+EMBEDDER_API_VERSION=
+EMBEDDER_DIMENSIONS=3072
+
+# =============================================================================
+# RATE LIMITER / THROTTLER (API)
+# =============================================================================
+RATE_LIMIT_ENABLED=true
+RATE_LIMIT_TTL=60000
+RATE_LIMIT_REQUESTS=1000
+IP_RATE_LIMIT_REQUESTS=200
+
+# =============================================================================
+# GOOGLE API KEYS (API & WEB)
+# =============================================================================
+NEXT_PUBLIC_GOOGLE_MAPS_API_KEY=""

package/template/.github/workflows/check-library-updates.yml

@@ -0,0 +1,71 @@
+name: Check Library Updates
+
+on:
+  schedule:
+    - cron: '0 8 * * *'  # Daily at 8 AM UTC
+  workflow_dispatch:  # Manual trigger
+
+permissions:
+  contents: write
+  pull-requests: write
+
+jobs:
+  check-updates:
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v4
+
+      - uses: actions/setup-node@v4
+        with:
+          node-version: 22
+
+      - name: Check for updates
+        id: check
+        run: |
+          # Read current versions
+          CURRENT=$(cat versions.production.json)
+
+          # Check latest versions from npm
+          NESTJS_LATEST=$(npm view @carlonicora/nestjs-neo4jsonapi version 2>/dev/null || echo "")
+          NEXTJS_LATEST=$(npm view @carlonicora/nextjs-jsonapi version 2>/dev/null || echo "")
+
+          NESTJS_CURRENT=$(echo "$CURRENT" | jq -r '.["@carlonicora/nestjs-neo4jsonapi"]')
+          NEXTJS_CURRENT=$(echo "$CURRENT" | jq -r '.["@carlonicora/nextjs-jsonapi"]')
+
+          UPDATES=""
+
+          if [ -n "$NESTJS_LATEST" ] && [ "$NESTJS_LATEST" != "$NESTJS_CURRENT" ]; then
+            UPDATES="$UPDATES nestjs-neo4jsonapi:$NESTJS_CURRENT→$NESTJS_LATEST"
+            jq --arg v "$NESTJS_LATEST" '.["@carlonicora/nestjs-neo4jsonapi"] = $v' versions.production.json > tmp.json && mv tmp.json versions.production.json
+          fi
+
+          if [ -n "$NEXTJS_LATEST" ] && [ "$NEXTJS_LATEST" != "$NEXTJS_CURRENT" ]; then
+            UPDATES="$UPDATES nextjs-jsonapi:$NEXTJS_CURRENT→$NEXTJS_LATEST"
+            jq --arg v "$NEXTJS_LATEST" '.["@carlonicora/nextjs-jsonapi"] = $v' versions.production.json > tmp.json && mv tmp.json versions.production.json
+          fi
+
+          if [ -n "$UPDATES" ]; then
+            echo "updates=true" >> $GITHUB_OUTPUT
+            echo "changes=$UPDATES" >> $GITHUB_OUTPUT
+          else
+            echo "updates=false" >> $GITHUB_OUTPUT
+          fi
+
+      - name: Create Pull Request
+        if: steps.check.outputs.updates == 'true'
+        uses: peter-evans/create-pull-request@v6
+        with:
+          token: ${{ secrets.GITHUB_TOKEN }}
+          commit-message: "chore(deps): update library versions"
+          title: "chore(deps): update library versions"
+          body: |
+            Updates detected: ${{ steps.check.outputs.changes }}
+
+            This PR updates the production library versions in `versions.production.json`.
+
+            **Review the changelogs before merging:**
+            - [nestjs-neo4jsonapi releases](https://github.com/carlonicora/nestjs-neo4jsonapi/releases)
+            - [nextjs-jsonapi releases](https://github.com/carlonicora/nextjs-jsonapi/releases)
+          branch: deps/library-updates
+          base: dev
+          delete-branch: true

package/template/.github/workflows/dev.yml

@@ -0,0 +1,63 @@
+name: Dev
+
+on:
+  push:
+    branches:
+      - dev
+
+permissions:
+  contents: write
+
+jobs:
+  build:
+    runs-on: ubuntu-latest
+
+    strategy:
+      matrix:
+        node-version: [22.x]
+
+    steps:
+      - uses: actions/checkout@v4
+        with:
+          fetch-depth: 0
+      
+      - name: Install pnpm
+        uses: pnpm/action-setup@v4
+      
+      - name: Use Node.js 22.x
+        uses: actions/setup-node@v4
+        with:
+          node-version: "22.x"
+          cache: "pnpm"
+      
+      - name: Install Dependencies
+        run: |
+          sed -i '/nestjs-neo4jsonapi/d; /nextjs-jsonapi/d' pnpm-workspace.yaml
+          pnpm install --no-frozen-lockfile
+
+      - name: Create .env file
+        run: |
+          cat > .env << EOF
+          NEXT_PUBLIC_API_URL=http://localhost:3000
+          NEXT_PUBLIC_ADDRESS=http://localhost:3001
+          NEXT_PUBLIC_VAPID_PUBLIC_KEY=placeholder
+          EOF
+
+      - name: Build shared package
+        run: pnpm --filter @{{name}}/shared build
+
+      - name: Build API
+        run: pnpm --filter {{name}}-api build
+        env:
+          NODE_OPTIONS: --max-old-space-size=4096
+
+      - name: Build Web
+        run: pnpm --filter {{name}}-web build
+        env:
+          NODE_OPTIONS: --max-old-space-size=4096
+
+      - name: Create Tag
+        env:
+          GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}
+          HUSKY: "0"
+        run: pnpm dlx semantic-release

package/template/.github/workflows/pull-request.yml

@@ -0,0 +1,55 @@
+name: Pull Request
+
+on:
+  pull_request:
+    types:
+      - opened
+      - synchronize
+
+jobs:
+  build:
+    runs-on: ubuntu-latest
+
+    strategy:
+      matrix:
+        node-version: [22.x]
+
+    steps:
+      - uses: actions/checkout@v4
+        with:
+          fetch-depth: 0
+      
+      - name: Install pnpm
+        uses: pnpm/action-setup@v4
+      
+      - name: Use Node.js 22.x
+        uses: actions/setup-node@v4
+        with:
+          node-version: "22.x"
+          cache: "pnpm"
+      
+      - name: Install Dependencies
+        run: |
+          sed -i '/nestjs-neo4jsonapi/d; /nextjs-jsonapi/d' pnpm-workspace.yaml
+          pnpm install --no-frozen-lockfile
+
+      - name: Create .env file
+        run: |
+          cat > .env << EOF
+          NEXT_PUBLIC_API_URL=http://localhost:3000
+          NEXT_PUBLIC_ADDRESS=http://localhost:3001
+          NEXT_PUBLIC_VAPID_PUBLIC_KEY=placeholder
+          EOF
+
+      - name: Build shared package
+        run: pnpm --filter @{{name}}/shared build
+
+      - name: Build API
+        run: pnpm --filter {{name}}-api build
+        env:
+          NODE_OPTIONS: --max-old-space-size=4096
+
+      - name: Build Web
+        run: pnpm --filter {{name}}-web build
+        env:
+          NODE_OPTIONS: --max-old-space-size=4096

package/template/.gitmodules

@@ -0,0 +1,6 @@
+[submodule "packages/nestjs-neo4jsonapi"]
+	path = packages/nestjs-neo4jsonapi
+	url = https://github.com/carlonicora/nestjs-neo4jsonapi
+[submodule "packages/nextjs-jsonapi"]
+	path = packages/nextjs-jsonapi
+	url = https://github.com/carlonicora/nextjs-jsonapi

package/template/.husky/pre-commit

@@ -0,0 +1 @@
+pnpm lint

package/template/.husky/pre-push

@@ -0,0 +1 @@
+pnpm build

package/template/.prettierignore

@@ -0,0 +1 @@
+node_modules

package/template/.prettierrc

@@ -0,0 +1,13 @@
+{
+  "printWidth": 120,
+  "tabWidth": 2,
+  "useTabs": false,
+  "semi": true,
+  "quoteProps": "as-needed",
+  "singleQuote": false,
+  "trailingComma": "all",
+  "bracketSpacing": true,
+  "bracketSameLine": false,
+  "arrowParens": "always",
+  "plugins": ["prettier-plugin-tailwindcss"]
+}