@icebreakers/monorepo-templates 0.0.0

package/skeleton/gitignore

@@ -0,0 +1,38 @@
+# See https://help.github.com/articles/ignoring-files/ for more about ignoring files.
+
+# dependencies
+node_modules
+.pnp
+.pnp.js
+
+# testing
+coverage
+
+# next.js
+.next/
+out/
+build
+
+# misc
+.DS_Store
+*.pem
+
+# debug
+npm-debug.log*
+yarn-debug.log*
+yarn-error.log*
+.pnpm-debug.log*
+
+# local env files
+.env.local
+.env.development.local
+.env.test.local
+.env.production.local
+
+# turbo
+.turbo
+
+dist
+vite.config.ts.timestamp-*.mjs
+config.ts.timestamp-*.mjs
+.vite-inspect

package/skeleton/lint-staged.config.js

@@ -0,0 +1,11 @@
+export default {
+  '*.{js,jsx,mjs,ts,tsx,mts,vue}': [
+    'eslint --fix',
+  ],
+  '*.{json,md,mdx,css,html,yml,yaml,scss}': [
+    // 'prettier --with-node-modules --ignore-path .prettierignore --write',
+    'eslint --fix',
+  ],
+  // for rust
+  // '*.rs': ['cargo fmt --'],
+}

package/skeleton/package.json

@@ -0,0 +1,88 @@
+{
+  "name": "monorepo-template",
+  "type": "module",
+  "version": "0.0.0",
+  "private": true,
+  "packageManager": "pnpm@10.28.0",
+  "author": "ice breaker <1324318532@qq.com>",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/sonofmagic/monorepo-template.git"
+  },
+  "bugs": {
+    "url": "https://github.com/sonofmagic/monorepo-template/issues"
+  },
+  "engines": {
+    "node": ">=20.0.0"
+  },
+  "scripts": {
+    "build": "turbo run build",
+    "dev": "turbo run dev --parallel",
+    "test": "vitest run",
+    "test:dev": "vitest",
+    "lint": "turbo run lint",
+    "audit": "pnpm audit --audit-level=moderate",
+    "audit:fix": "pnpm audit --fix",
+    "typecheck": "turbo run typecheck",
+    "format": "eslint . --fix",
+    "validate": "pnpm run typecheck && pnpm run lint && pnpm run test",
+    "release": "changeset",
+    "publish-packages": "turbo run build lint test && changeset version && changeset publish",
+    "------": "--------------",
+    "preinstall": "npx only-allow pnpm",
+    "prepare": "husky",
+    "commit": "commit",
+    "commitlint": "commitlint --edit",
+    "-------": "---------------",
+    "pr:alpha": "changeset pre enter alpha",
+    "pr:beta": "changeset pre enter beta",
+    "pr:rc": "changeset pre enter rc",
+    "pr:exit": "changeset pre exit",
+    "--------": "----------------",
+    "script:init": "monorepo init",
+    "script:sync": "monorepo sync",
+    "script:clean": "monorepo clean",
+    "script:mirror": "monorepo mirror"
+  },
+  "devDependencies": {
+    "@changesets/cli": "^2.29.8",
+    "@commitlint/cli": "^20.3.1",
+    "@icebreakers/changelog-github": "^0.1.0",
+    "@icebreakers/commitlint-config": "^1.2.5",
+    "@icebreakers/eslint-config": "^1.6.13",
+    "@icebreakers/monorepo": "workspace:*",
+    "@icebreakers/stylelint-config": "^1.2.5",
+    "@types/fs-extra": "^11.0.4",
+    "@types/node": "^25.0.8",
+    "@types/semver": "^7.7.1",
+    "@vitest/coverage-v8": "~4.0.17",
+    "ci-info": "^4.3.1",
+    "cross-env": "^10.1.0",
+    "defu": "^6.1.4",
+    "es-toolkit": "^1.43.0",
+    "eslint": "^9.39.2",
+    "execa": "^9.6.1",
+    "fs-extra": "^11.3.3",
+    "husky": "^9.1.7",
+    "lint-staged": "^16.2.7",
+    "only-allow": "^1.2.2",
+    "pathe": "^2.0.3",
+    "pkg-types": "^2.3.0",
+    "rimraf": "^6.1.2",
+    "stylelint": "^16.26.1",
+    "tsdown": "0.19.0",
+    "tslib": "^2.8.1",
+    "tsup": "^8.5.1",
+    "tsx": "^4.21.0",
+    "turbo": "^2.7.4",
+    "type-fest": "^5.4.1",
+    "typescript": "^5.9.3",
+    "unbuild": "^3.6.1",
+    "vitest": "~4.0.17",
+    "yaml": "^2.8.2"
+  },
+  "publishConfig": {
+    "access": "public",
+    "registry": "https://registry.npmjs.org"
+  }
+}

package/skeleton/pnpm-workspace.yaml

@@ -0,0 +1,11 @@
+packages:
+  - apps/*
+  - packages/*
+  - templates/*
+  - '!**/test/**'
+
+onlyBuiltDependencies:
+  - '@tailwindcss/oxide'
+  - esbuild
+  - sharp
+  - workerd

package/skeleton/renovate.json

@@ -0,0 +1,28 @@
+{
+  "$schema": "https://docs.renovatebot.com/renovate-schema.json",
+  "extends": [
+    "config:recommended",
+    "group:allNonMajor",
+    ":semanticCommitTypeAll(chore)"
+  ],
+  "commitBody": "[skip netlify]",
+  "rangeStrategy": "bump",
+  "npm": {
+    "commitMessageTopic": "{{prettyDepType}} {{depName}}"
+  },
+  "ignoreDeps": [
+    "node"
+  ],
+  "automerge": true,
+  "automergeType": "pr",
+  "packageRules": [
+    {
+      "matchUpdateTypes": [
+        "minor",
+        "patch",
+        "pin",
+        "digest"
+      ]
+    }
+  ]
+}

package/skeleton/stylelint.config.js

@@ -0,0 +1,3 @@
+import { icebreaker } from '@icebreakers/stylelint-config'
+
+export default icebreaker()

package/skeleton/tsconfig.json

@@ -0,0 +1,51 @@
+{
+  "compilerOptions": {
+    // 指定 ECMAScript 目标版本，ESNext 表示支持最新的 ES 特性
+    "target": "ESNext",
+
+    // 指定模块系统，ESNext 使用原生 ES 模块 (import/export)
+    "module": "ESNext",
+
+    // 模块解析策略，Bundler 模式适用于打包工具（如 Vite、Webpack），支持更宽松的解析规则
+    "moduleResolution": "Bundler",
+
+    // 允许导入 .json 文件，并自动生成类型声明
+    "resolveJsonModule": true,
+
+    // 指定要包含的类型声明文件，node 提供 Node.js API 类型，vitest/globals 提供测试全局变量类型
+    "types": [
+      "node",
+      "vitest/globals"
+    ],
+
+    // 允许编译 JavaScript 文件，使其可以被导入和进行类型检查
+    "allowJs": true,
+
+    // 启用所有严格类型检查选项，包括 noImplicitAny、strictNullChecks 等
+    "strict": true,
+
+    // 严格检查可选属性类型，区分 undefined 和缺失的属性
+    "exactOptionalPropertyTypes": true,
+
+    // 要求子类重写父类方法时必须使用 override 关键字
+    "noImplicitOverride": true,
+
+    // 禁止通过索引签名（如 obj['key']）访问未在索引签名中定义的属性
+    "noPropertyAccessFromIndexSignature": true,
+
+    // 访问索引签名时返回 undefined | T，而不是 T（防止未定义访问错误）
+    "noUncheckedIndexedAccess": true,
+
+    // 不生成输出文件（仅用于类型检查，实际由打包工具处理编译）
+    "noEmit": true,
+
+    // 允许从没有默认导出的模块中默认导入（如 import React from 'react'）
+    "allowSyntheticDefaultImports": true,
+
+    // 启用 ES 模块互操作性，为 CommonJS 模块提供 synthetic default imports
+    "esModuleInterop": true,
+
+    // 跳过库文件的类型检查，提高编译速度（库文件通常已经有类型声明）
+    "skipLibCheck": true
+  }
+}

package/skeleton/turbo.json

@@ -0,0 +1,74 @@
+{
+  "$schema": "https://turborepo.com/schema.json",
+  "tasks": {
+    "build": {
+      "dependsOn": [
+        "^build"
+      ],
+      "inputs": [
+        "src/**",
+        "lib/**",
+        "package.json",
+        "tsconfig*.json",
+        "*.config.{js,ts,mjs,mts}"
+      ],
+      "outputs": [
+        "dist/**",
+        "bin/**"
+      ]
+    },
+    "lint": {
+      "dependsOn": [
+        "^lint"
+      ],
+      "inputs": [
+        "src/**",
+        "lib/**",
+        "test/**",
+        "*.config.{js,ts}",
+        ".eslintrc*",
+        ".stylelintrc*"
+      ],
+      "outputs": []
+    },
+    "dev": {
+      "cache": false,
+      "persistent": true
+    },
+    "test": {
+      "dependsOn": [
+        "^test"
+      ],
+      "inputs": [
+        "src/**",
+        "lib/**",
+        "test/**",
+        "package.json",
+        "vitest.config.{js,ts}",
+        "tsconfig*.json"
+      ],
+      "outputs": [
+        "coverage/**"
+      ]
+    },
+    "typecheck": {
+      "dependsOn": [
+        "^typecheck"
+      ],
+      "inputs": [
+        "src/**",
+        "lib/**",
+        "test/**",
+        "package.json",
+        "tsconfig*.json"
+      ],
+      "outputs": []
+    },
+    "release": {
+      "cache": false
+    },
+    "sync": {
+      "cache": false
+    }
+  }
+}

package/skeleton/vitest.config.ts

@@ -0,0 +1,123 @@
+import fs from 'node:fs'
+import path from 'node:path'
+import { fileURLToPath } from 'node:url'
+import { defineConfig } from 'vitest/config'
+import YAML from 'yaml'
+
+const ROOT_DIR = path.dirname(fileURLToPath(new URL(import.meta.url)))
+const WORKSPACE_FILE = path.resolve(ROOT_DIR, 'pnpm-workspace.yaml')
+const CONFIG_FILENAMES = [
+  'vitest.config.ts',
+  'vitest.config.mts',
+  'vitest.config.cts',
+  'vitest.config.js',
+  'vitest.config.cjs',
+  'vitest.config.mjs',
+] as const
+
+function extractBaseDirFromGlob(pattern: string): string | null {
+  if (!pattern) {
+    return null
+  }
+
+  const normalized = pattern
+    .replace(/\\/g, '/')
+    .replace(/^\.\//, '')
+  const globIndex = normalized.search(/[*?[{]/)
+  const base = globIndex === -1
+    ? normalized
+    : normalized.slice(0, globIndex)
+
+  const cleaned = base.replace(/\/+$/, '')
+  return cleaned || null
+}
+
+function loadProjectRootsFromWorkspace(): string[] {
+  if (!fs.existsSync(WORKSPACE_FILE)) {
+    return []
+  }
+
+  try {
+    const workspaceContent = fs.readFileSync(WORKSPACE_FILE, 'utf8')
+    const workspace = YAML.parse(workspaceContent) ?? {}
+    const packages: unknown[] = Array.isArray(workspace.packages) ? workspace.packages : []
+    const roots = packages
+      .map(entry => typeof entry === 'string' ? entry.trim() : '')
+      .filter(entry => entry && !entry.startsWith('!'))
+      .map(extractBaseDirFromGlob)
+      .filter((entry): entry is string => Boolean(entry))
+
+    return roots.length ? Array.from(new Set(roots)) : []
+  }
+  catch (error) {
+    console.warn('[vitest] Failed to parse pnpm-workspace.yaml, no project roots will be used.', error)
+    return []
+  }
+}
+
+const PROJECT_ROOTS = loadProjectRootsFromWorkspace()
+
+if (!PROJECT_ROOTS.length) {
+  console.warn('[vitest] No project roots detected. Check pnpm-workspace.yaml to define workspace packages.')
+}
+
+function findConfig(basePath: string): string | null {
+  for (const filename of CONFIG_FILENAMES) {
+    const candidate = path.join(basePath, filename)
+    if (fs.existsSync(candidate)) {
+      return candidate
+    }
+  }
+  return null
+}
+
+function resolveProjects(): string[] {
+  const projects: string[] = []
+
+  for (const folder of PROJECT_ROOTS) {
+    const rootPath = path.resolve(ROOT_DIR, folder)
+    if (!fs.existsSync(rootPath)) {
+      continue
+    }
+
+    const rootConfig = findConfig(rootPath)
+    if (rootConfig) {
+      projects.push(rootConfig)
+    }
+
+    const entries = fs.readdirSync(rootPath, { withFileTypes: true })
+    for (const entry of entries) {
+      if (!entry.isDirectory()) {
+        continue
+      }
+
+      const projectDir = path.join(rootPath, entry.name)
+      const configPath = findConfig(projectDir)
+      if (configPath) {
+        projects.push(configPath)
+      }
+    }
+  }
+
+  return projects
+}
+
+const projects = resolveProjects()
+
+export default defineConfig(() => {
+  return {
+    test: {
+      projects,
+      coverage: {
+        enabled: true,
+        skipFull: true,
+        exclude: [
+          '**/dist/**',
+        ],
+      },
+      forceRerunTriggers: [
+        '**/{vitest,vite}.config.*/**',
+      ],
+    },
+  }
+})

package/template-data.mjs

@@ -0,0 +1,10 @@
+export const templateChoices = [
+  { key: 'unbuild', label: 'unbuild 打包', source: 'unbuild', target: 'packages/unbuild' },
+  { key: 'tsup', label: 'tsup 打包', source: 'tsup', target: 'packages/tsup' },
+  { key: 'tsdown', label: 'tsdown 打包', source: 'tsdown', target: 'packages/tsdown' },
+  { key: 'vue-lib', label: 'vue 组件', source: 'vue-lib', target: 'packages/vue-lib' },
+  { key: 'vue-hono', label: 'vue hono 全栈', source: 'client', target: 'apps/client' },
+  { key: 'hono-server', label: 'hono 模板', source: 'server', target: 'apps/server' },
+  { key: 'vitepress', label: 'vitepress 文档', source: 'vitepress', target: 'apps/website' },
+  { key: 'cli', label: 'cli 模板', source: 'cli', target: 'apps/cli' },
+]

package/templates/cli/bin/index.js

@@ -0,0 +1,2 @@
+#!/usr/bin/env node
+import '../dist/cli.js'

package/templates/cli/dev/index.ts

@@ -0,0 +1,2 @@
+#!/usr/bin/env -S npx tsx
+import '../src/cli.ts'

package/templates/cli/gitignore

@@ -0,0 +1,2 @@
+bar
+t

package/templates/cli/package.json

@@ -0,0 +1,35 @@
+{
+  "name": "@icebreakers/cli",
+  "type": "module",
+  "version": "0.0.0",
+  "description": "icebreaker's cli template",
+  "author": "ice breaker <1324318532@qq.com>",
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/sonofmagic/monorepo-template.git",
+    "directory": "templates/cli"
+  },
+  "bugs": {
+    "url": "https://github.com/sonofmagic/monorepo-template/issues"
+  },
+  "keywords": [],
+  "bin": {
+    "ice": "./dev/index.ts"
+  },
+  "scripts": {
+    "start": "tsx src/index.ts",
+    "dev": "tsup --watch --sourcemap",
+    "build": "tsup",
+    "lint": "eslint .",
+    "lint:fix": "eslint . --fix"
+  },
+  "dependencies": {
+    "consola": "^3.4.2"
+  },
+  "publishConfig": {
+    "bin": {
+      "ice": "./bin/index.js"
+    }
+  }
+}

package/templates/cli/src/cli.ts

@@ -0,0 +1,4 @@
+import process from 'node:process'
+import { runCli } from './index'
+
+runCli(process.argv)

package/templates/cli/src/index.ts

@@ -0,0 +1,15 @@
+import process from 'node:process'
+import { pathToFileURL } from 'node:url'
+import { consola } from 'consola'
+
+export function runCli(argv: string[] = process.argv) {
+  consola.info('[@icebreakers/cli]:', argv)
+}
+
+const executedFile = process.argv[1]
+if (executedFile) {
+  const entryUrl = pathToFileURL(executedFile).href
+  if (entryUrl === import.meta.url) {
+    runCli()
+  }
+}

package/templates/cli/tsconfig.json

@@ -0,0 +1,7 @@
+{
+  "extends": "../../tsconfig.json",
+  "include": [
+    "src",
+    "test"
+  ]
+}

package/templates/cli/tsup.config.ts

@@ -0,0 +1,13 @@
+import { defineConfig } from 'tsup'
+
+export default defineConfig({
+  entry: ['src/index.ts', 'src/cli.ts'], // ,],
+  shims: true,
+  format: ['cjs', 'esm'],
+  clean: true,
+  dts: true,
+  // https://github.com/egoist/tsup/pull/1056
+  // https://github.com/egoist/tsup/issues?q=cjsInterop
+  // cjsInterop: true,
+  // splitting: true,
+})

package/templates/client/eslint.config.js

@@ -0,0 +1,12 @@
+import { icebreaker } from '@icebreakers/eslint-config'
+
+export default icebreaker(
+  {
+    vue: true,
+    typescript: true,
+    tailwindcss: {
+      entryPoint: './src/style.css',
+    },
+    ignores: ['**/fixtures/**'],
+  },
+)

package/templates/client/gitignore

@@ -0,0 +1,28 @@
+# Logs
+logs
+*.log
+npm-debug.log*
+yarn-debug.log*
+yarn-error.log*
+pnpm-debug.log*
+lerna-debug.log*
+
+node_modules
+dist
+dist-ssr
+*.local
+
+# Editor directories and files
+.vscode/*
+!.vscode/extensions.json
+.idea
+.DS_Store
+*.suo
+*.ntvs*
+*.njsproj
+*.sln
+*.sw?
+src/types/typed-router.d.ts
+.wrangler
+.dev.vars*
+worker-configuration.d.ts

package/templates/client/index.html

@@ -0,0 +1,13 @@
+<!doctype html>
+<html lang="en">
+  <head>
+    <meta charset="UTF-8" />
+    <link rel="icon" type="image/svg+xml" href="/vite.svg" />
+    <meta name="viewport" content="width=device-width, initial-scale=1.0" />
+    <title>Vite + Vue + TS</title>
+  </head>
+  <body>
+    <div id="app"></div>
+    <script type="module" src="/src/main.ts"></script>
+  </body>
+</html>

package/templates/client/package.json

@@ -0,0 +1,52 @@
+{
+  "name": "@icebreakers/client",
+  "type": "module",
+  "version": "0.0.0",
+  "private": true,
+  "scripts": {
+    "dev": "vite --host",
+    "build": "vue-tsc -b && vite build",
+    "lint": "eslint .",
+    "lint:fix": "eslint . --fix",
+    "preview": "vite preview",
+    "deploy": "wrangler deploy",
+    "cf-typegen": "wrangler types",
+    "postinstall": "pnpm cf-typegen"
+  },
+  "dependencies": {
+    "@faker-js/faker": "^10.2.0",
+    "@tanstack/vue-query": "^5.92.6",
+    "@tanstack/vue-query-devtools": "^6.1.3",
+    "@tanstack/vue-table": "^8.21.3",
+    "@tanstack/vue-virtual": "^3.13.18",
+    "@trpc/client": "^11.8.1",
+    "clsx": "^2.1.1",
+    "pinia": "^3.0.4",
+    "tailwind-merge": "^3.4.0",
+    "tailwind-variants": "^3.2.2",
+    "vue": "^3.5.26",
+    "vue-i18n": "^11.2.8",
+    "vue-router": "^4.6.4"
+  },
+  "devDependencies": {
+    "@cloudflare/vite-plugin": "^1.20.3",
+    "@hono/node-server": "^1.19.9",
+    "@hono/trpc-server": "^0.4.2",
+    "@tailwindcss/vite": "^4.1.18",
+    "@trpc/server": "^11.8.1",
+    "@vitejs/plugin-vue": "^6.0.3",
+    "@vitejs/plugin-vue-jsx": "^5.1.3",
+    "@vue/tsconfig": "^0.8.1",
+    "consola": "^3.4.2",
+    "hono": "^4.11.4",
+    "tailwindcss": "^4.1.18",
+    "typescript": "~5.9.3",
+    "unplugin-vue-router": "^0.19.2",
+    "vite": "^7.3.1",
+    "vite-plugin-vue-devtools": "^8.0.5",
+    "vite-tsconfig-paths": "^6.0.4",
+    "vue-tsc": "3.2.2",
+    "wrangler": "^4.59.1",
+    "zod": "^4.3.5"
+  }
+}

package/templates/client/public/vite.svg

@@ -0,0 +1 @@
+<svg xmlns="http://www.w3.org/2000/svg" xmlns:xlink="http://www.w3.org/1999/xlink" aria-hidden="true" role="img" class="iconify iconify--logos" width="31.88" height="32" preserveAspectRatio="xMidYMid meet" viewBox="0 0 256 257"><defs><linearGradient id="IconifyId1813088fe1fbc01fb466" x1="-.828%" x2="57.636%" y1="7.652%" y2="78.411%"><stop offset="0%" stop-color="#41D1FF"></stop><stop offset="100%" stop-color="#BD34FE"></stop></linearGradient><linearGradient id="IconifyId1813088fe1fbc01fb467" x1="43.376%" x2="50.316%" y1="2.242%" y2="89.03%"><stop offset="0%" stop-color="#FFEA83"></stop><stop offset="8.333%" stop-color="#FFDD35"></stop><stop offset="100%" stop-color="#FFA800"></stop></linearGradient></defs><path fill="url(#IconifyId1813088fe1fbc01fb466)" d="M255.153 37.938L134.897 252.976c-2.483 4.44-8.862 4.466-11.382.048L.875 37.958c-2.746-4.814 1.371-10.646 6.827-9.67l120.385 21.517a6.537 6.537 0 0 0 2.322-.004l117.867-21.483c5.438-.991 9.574 4.796 6.877 9.62Z"></path><path fill="url(#IconifyId1813088fe1fbc01fb467)" d="M185.432.063L96.44 17.501a3.268 3.268 0 0 0-2.634 3.014l-5.474 92.456a3.268 3.268 0 0 0 3.997 3.378l24.777-5.718c2.318-.535 4.413 1.507 3.936 3.838l-7.361 36.047c-.495 2.426 1.782 4.5 4.151 3.78l15.304-4.649c2.372-.72 4.652 1.36 4.15 3.788l-11.698 56.621c-.732 3.542 3.979 5.473 5.943 2.437l1.313-2.028l72.516-144.72c1.215-2.423-.88-5.186-3.54-4.672l-25.505 4.922c-2.396.462-4.435-1.77-3.759-4.114l16.646-57.705c.677-2.35-1.37-4.583-3.769-4.113Z"></path></svg>

package/templates/client/src/App.vue

@@ -0,0 +1,11 @@
+<script setup lang="ts">
+import { VueQueryDevtools } from '@tanstack/vue-query-devtools'
+import { RouterView } from 'vue-router'
+</script>
+
+<template>
+  <div>
+    <RouterView />
+  </div>
+  <VueQueryDevtools />
+</template>