feat: modernize blueprint with Node.js 24, tsup, and Volta

Major updates to the TypeScript monorepo blueprint:

- Upgrade Node.js requirement to >=24 (latest LTS with enhanced TypeScript support)
- Add Volta configuration for consistent Node.js and pnpm version management
- Replace tsc with tsup as primary build tool for all packages
- Convert all packages to ESM-first with "type": "module"
- Add tsup configurations following modern SDK patterns
- Update all dependencies to latest versions and resolve security vulnerabilities
- Update pnpm to 10.26.2 and fix packageManager field
- Enhance README with comprehensive build documentation
- Fix lint-staged command for biome compatibility

Build improvements:
- Zero-config bundling with automatic TypeScript compilation
- Tree shaking and source map generation
- ESM module output with proper exports configuration
- Faster builds and better development experience

Author: prosdev

README.md

@@ -1,7 +1,7 @@
 # TypeScript Monorepo Starter
 
-[![Node.js](https://img.shields.io/badge/node-%3E%3D22-brightgreen.svg)](https://nodejs.org/)
-[![pnpm](https://img.shields.io/badge/pnpm-8.15.4-orange.svg)](https://pnpm.io/)
+[![Node.js](https://img.shields.io/badge/node-%3E%3D24-brightgreen.svg)](https://nodejs.org/)
+[![pnpm](https://img.shields.io/badge/pnpm-10.26.2-orange.svg)](https://pnpm.io/)
 [![License: MIT](https://img.shields.io/badge/License-MIT-blue.svg)](LICENSE)
 
 A modern TypeScript monorepo starter template with best practices for scalable projects.
@@ -10,9 +10,11 @@ A modern TypeScript monorepo starter template with best practices for scalable p
 
 - 📦 [PNPM](https://pnpm.io/) for fast, disk-efficient package management
 - 🏎️ [Turborepo](https://turbo.build/repo) for high-performance build system
+- 📦 [tsup](https://tsup.egoist.dev/) for fast, zero-config bundling with TypeScript support
 - 🔍 [Biome](https://biomejs.dev/) for fast linting and formatting
 - ⚙️ [TypeScript](https://www.typescriptlang.org/) configured with modern Node LTS settings
 - 🧪 [Vitest](https://vitest.dev/) for unit testing
+- ⚡ [Volta](https://volta.sh/) for Node.js and package manager version management
 - 📝 [Commitlint](https://commitlint.js.org/) with Conventional Commits
 - 🔄 [Changesets](https://github.com/changesets/changesets) for versioning and changelogs
 - 🚀 GitHub Actions for CI/CD with npm publishing
@@ -34,6 +36,7 @@ ts-monorepo/
 ├── package.json         # Root package.json
 ├── pnpm-workspace.yaml  # PNPM workspace config
 ├── tsconfig.json        # Base TypeScript config
+├── tsup.config.ts       # tsup build configuration
 ├── turbo.json           # Turborepo config
 └── vitest.config.ts     # Vitest config
 ```
@@ -42,8 +45,8 @@ ts-monorepo/
 
 ### Prerequisites
 
-- [Node.js](https://nodejs.org/) (v22 LTS or higher)
-- [PNPM](https://pnpm.io/) (v8 or higher)
+- [Volta](https://volta.sh/) for Node.js and pnpm version management (recommended)
+  - Or [Node.js](https://nodejs.org/) (v24 LTS or higher) and [PNPM](https://pnpm.io/) (v10 or higher)
 
 ### Installation
 
@@ -53,12 +56,22 @@ ts-monorepo/
    cd ts-monorepo
    ```
 
-2. Install dependencies
+2. Install Node.js and pnpm (if using Volta, this happens automatically)
+   ```bash
+   # With Volta (recommended)
+   volta install [email protected] [email protected]
+
+   # Or install manually
+   # Install Node.js 24+ from https://nodejs.org
+   # Install pnpm: npm install -g pnpm
+   ```
+
+3. Install dependencies
    ```bash
    pnpm install
    ```
 
-3. Build all packages
+4. Build all packages
    ```bash
    pnpm build
    ```
@@ -87,14 +100,25 @@ pnpm format
 
 #### Building
 
+This template uses [tsup](https://tsup.egoist.dev/) for fast, zero-config bundling with TypeScript support. All packages are built as ESM modules.
+
 ```bash
 # Build all packages
 pnpm build
 
 # Build a specific package
 pnpm -F "@monorepo/core" build
+
+# Watch mode for development
+pnpm -F "@monorepo/core" dev
 ```
 
+**Build Configuration:**
+- **Output**: ESM modules (`dist/index.js`)
+- **Types**: Generated automatically (`dist/index.d.ts`)
+- **Source maps**: Included for debugging
+- **Tree shaking**: Enabled for optimal bundle size
+
 ### Making Changes
 
 1. Create a new branch

package.json

@@ -15,25 +15,30 @@
     "format": "turbo format",
     "typecheck": "turbo typecheck",
     "prepare": "husky",
-    "lint-staged": "biome check --write --no-errors-on-unmatched --files",
+    "lint-staged": "biome check --write --no-errors-on-unmatched",
     "changeset": "changeset",
     "version": "changeset version",
     "release": "pnpm build && changeset publish"
   },
   "devDependencies": {
-    "@biomejs/biome": "2.3.8",
+    "@biomejs/biome": "2.3.10",
     "@changesets/cli": "^2.29.8",
     "@commitlint/cli": "^20.2.0",
     "@commitlint/config-conventional": "^20.2.0",
     "@tsconfig/node-lts": "^24.0.0",
+    "@vitest/coverage-v8": "^4.0.16",
     "husky": "^9.1.7",
-    "turbo": "^2.6.3",
+    "tsup": "^8.5.1",
+    "turbo": "^2.7.2",
     "typescript": "^5.9.3",
-    "vitest": "^4.0.15",
-    "@vitest/coverage-v8": "^4.0.15"
+    "vitest": "^4.0.16"
   },
-  "packageManager": "pnpm@9.15.4",
+  "packageManager": "pnpm@10.26.2",
   "engines": {
-    "node": ">=22"
+    "node": ">=24"
+  },
+  "volta": {
+    "node": "24.12.0",
+    "pnpm": "10.26.2"
   }
 }

packages/core/package.json

@@ -2,18 +2,18 @@
   "name": "@monorepo/core",
   "version": "0.1.0",
   "private": true,
+  "type": "module",
   "main": "./dist/index.js",
   "types": "./dist/index.d.ts",
   "exports": {
     ".": {
       "types": "./dist/index.d.ts",
-      "import": "./dist/index.js",
-      "require": "./dist/index.js"
+      "import": "./dist/index.js"
     }
   },
   "scripts": {
-    "build": "tsc",
-    "dev": "tsc --watch",
+    "build": "tsup",
+    "dev": "tsup --watch",
     "clean": "rm -rf dist",
     "typecheck": "tsc --noEmit",
     "lint": "biome lint ./src",
@@ -22,6 +22,7 @@
     "test:watch": "vitest"
   },
   "devDependencies": {
+    "tsup": "^8.5.1",
     "typescript": "^5.9.3"
   }
 }

packages/core/tsup.config.ts

@@ -0,0 +1,14 @@
+import { defineConfig } from 'tsup';
+
+export default defineConfig({
+  entry: ['src/index.ts'],
+  format: ['esm'],
+  dts: true,
+  splitting: false,
+  sourcemap: true,
+  clean: true,
+  treeshake: true,
+  minify: false,
+  outDir: 'dist',
+  skipNodeModulesBundle: true,
+});

packages/feature-a/package.json

@@ -2,18 +2,18 @@
   "name": "@monorepo/feature-a",
   "version": "0.1.0",
   "private": true,
+  "type": "module",
   "main": "./dist/index.js",
   "types": "./dist/index.d.ts",
   "exports": {
     ".": {
       "types": "./dist/index.d.ts",
-      "import": "./dist/index.js",
-      "require": "./dist/index.js"
+      "import": "./dist/index.js"
     }
   },
   "scripts": {
-    "build": "tsc",
-    "dev": "tsc --watch",
+    "build": "tsup",
+    "dev": "tsup --watch",
     "clean": "rm -rf dist",
     "typecheck": "tsc --noEmit",
     "lint": "biome lint ./src",
@@ -26,6 +26,7 @@
     "@monorepo/utils": "workspace:*"
   },
   "devDependencies": {
+    "tsup": "^8.5.1",
     "typescript": "^5.9.3"
   }
 }

packages/feature-a/tsup.config.ts

@@ -0,0 +1,14 @@
+import { defineConfig } from 'tsup';
+
+export default defineConfig({
+  entry: ['src/index.ts'],
+  format: ['esm'],
+  dts: true,
+  splitting: false,
+  sourcemap: true,
+  clean: true,
+  treeshake: true,
+  minify: false,
+  outDir: 'dist',
+  skipNodeModulesBundle: true,
+});

packages/utils/package.json

@@ -2,18 +2,18 @@
   "name": "@monorepo/utils",
   "version": "0.1.0",
   "private": true,
+  "type": "module",
   "main": "./dist/index.js",
   "types": "./dist/index.d.ts",
   "exports": {
     ".": {
       "types": "./dist/index.d.ts",
-      "import": "./dist/index.js",
-      "require": "./dist/index.js"
+      "import": "./dist/index.js"
     }
   },
   "scripts": {
-    "build": "tsc",
-    "dev": "tsc --watch",
+    "build": "tsup",
+    "dev": "tsup --watch",
     "clean": "rm -rf dist",
     "typecheck": "tsc --noEmit",
     "lint": "biome lint ./src",
@@ -25,6 +25,7 @@
     "@monorepo/core": "workspace:*"
   },
   "devDependencies": {
+    "tsup": "^8.5.1",
     "typescript": "^5.9.3"
   }
 }

packages/utils/tsup.config.ts

@@ -0,0 +1,14 @@
+import { defineConfig } from 'tsup';
+
+export default defineConfig({
+  entry: ['src/index.ts'],
+  format: ['esm'],
+  dts: true,
+  splitting: false,
+  sourcemap: true,
+  clean: true,
+  treeshake: true,
+  minify: false,
+  outDir: 'dist',
+  skipNodeModulesBundle: true,
+});