create-miniprogram-scaffold 1.0.1 → 1.0.3

package/bin/cli.js

@@ -27,7 +27,7 @@ program.name('create-mini-scaffold').description('Create Taro + Go mini program
         ]}, { type: 'input', name: 'port', message: 'Port?', default: cfg.port } ]); Object.assign(cfg, a); }
       if (!['header-tabbar','tabbar','fullscreen','all'].includes(cfg.layout)) { console.error(chalk.red('Invalid layout')); process.exit(1); }
       console.log(chalk.blue('\nCreating...'));
-      const tDir = path.join(__dirname, '..', '..', 'templates');
+      const tDir = path.join(__dirname, '..', 'templates');
       const mDir = path.join(dir, 'miniprogram');
       await fs.ensureDir(mDir); await fs.ensureDir(path.join(dir, 'server'));
       // Copy miniprogram (skip pages)

package/package.json

@@ -1,14 +1,15 @@
 {
   "name": "create-miniprogram-scaffold",
-  "version": "1.0.1",
+  "version": "1.0.3",
   "description": "Create Taro + Go mini program projects",
   "repository": {
     "type": "git",
     "url": "https://github.com/hk029/miniprogram-scaffold.git"
   },
   "main": "index.js",
+  "files": ["bin", "templates"],
   "bin": {
-    "create-mini-scaffold": "./bin/cli.js"
+    "create-miniprogram-scaffold": "./bin/cli.js"
   },
   "scripts": {
     "test": "echo \"Error: no test specified\" && exit 1"

package/templates/miniprogram/babel.config.js

@@ -0,0 +1,10 @@
+// babel-preset-taro 更多选项和默认值：
+// https://github.com/nicholasxjy/taro-cli/blob/master/packages/babel-preset-taro/README.md
+module.exports = {
+  presets: [
+    ['taro', {
+      framework: 'react',
+      ts: true
+    }]
+  ]
+}

package/templates/miniprogram/config/dev.ts

@@ -0,0 +1,2 @@
+import type { UserConfigExport } from '@tarojs/cli'
+export default { logger: { quiet: false, stats: true }, mini: {} } satisfies UserConfigExport

package/templates/miniprogram/config/index.ts

@@ -0,0 +1,17 @@
+import { defineConfig, type UserConfigExport } from '@tarojs/cli'
+import TsconfigPathsPlugin from 'tsconfig-paths-webpack-plugin'
+import devConfig from './dev'
+import prodConfig from './prod'
+export default defineConfig(async (merge) => {
+  const base: UserConfigExport = {
+    projectName: 'mini-scaffold', designWidth() { return 750 },
+    deviceRatio: { 640: 2.34/2, 750: 1, 375: 2, 828: 1.81/2 },
+    sourceRoot: 'src', outputRoot: 'dist', plugins: [], framework: 'react', compiler: 'webpack5',
+    mini: {
+      postcss: { pxtransform: { enable: true, config: {} }, url: { enable: true, config: { limit: 1024 } }, cssModules: { enable: false, config: { namingPattern: 'module', generateScopedName: '[name]__[local]___[hash:base64:5]' } } },
+      miniCssExtractPluginOption: { ignoreOrder: true },
+      webpackChain(chain) { chain.resolve.plugin('tsconfig-paths').use(TsconfigPathsPlugin) }
+    }
+  }
+  return process.env.NODE_ENV === 'development' ? merge({}, base, devConfig) : merge({}, base, prodConfig)
+})

package/templates/miniprogram/config/prod.ts

@@ -0,0 +1,2 @@
+import type { UserConfigExport } from '@tarojs/cli'
+export default { mini: {} } satisfies UserConfigExport

package/templates/miniprogram/package.json

@@ -0,0 +1,16 @@
+{
+  "name": "mini-scaffold-miniprogram", "version": "1.0.0", "private": true, "description": "Taro + Go mini program",
+  "scripts": { "dev:weapp": "taro build --type weapp --watch", "build:weapp": "taro build --type weapp", "dev:h5": "taro build --type h5 --watch", "build:h5": "taro build --type h5" },
+  "browserslist": ["last 3 versions", "Android >= 4.1", "ios >= 8"],
+  "dependencies": {
+    "@babel/runtime": "^7.21.5", "@tarojs/components": "3.6.31", "@tarojs/helper": "3.6.31",
+    "@tarojs/plugin-framework-react": "3.6.31", "@tarojs/plugin-platform-weapp": "3.6.31",
+    "@tarojs/react": "3.6.31", "@tarojs/runtime": "3.6.31", "@tarojs/shared": "3.6.31",
+    "@tarojs/taro": "3.6.31", "@tarojs/taro-loader": "3.6.31", "react": "^18.0.0"
+  },
+  "devDependencies": {
+    "@babel/core": "^7.21.8", "@tarojs/cli": "3.6.31", "@tarojs/webpack5-runner": "3.6.31",
+    "@types/react": "^18.0.0", "babel-preset-taro": "3.6.31", "tsconfig-paths-webpack-plugin": "^4.0.1",
+    "typescript": "^5.1.0", "webpack": "5.88.2"
+  }
+}

package/templates/miniprogram/project.config.json

@@ -0,0 +1,31 @@
+{
+  "miniprogramRoot": "dist/",
+  "projectname": "mini-scaffold",
+  "description": "Taro + Go 小程序脚手架",
+  "appid": "touristappid",
+  "setting": {
+    "urlCheck": true,
+    "es6": false,
+    "enhance": false,
+    "compileHotReLoad": false,
+    "postcss": false,
+    "minified": false,
+    "newFeature": true,
+    "coverView": true,
+    "nodeModules": false,
+    "autoAudits": false,
+    "showShadowRootInWxmlPanel": true,
+    "scopeDataCheck": false,
+    "uglifyFileName": false,
+    "checkInvalidKey": true,
+    "checkSiteMap": true,
+    "uploadWithSourceMap": true,
+    "babelSetting": {
+      "ignore": [],
+      "disablePlugins": [],
+      "outputPath": ""
+    }
+  },
+  "compileType": "miniprogram",
+  "condition": {}
+}

package/templates/miniprogram/scripts/generate-tabbar-icons.js

@@ -0,0 +1,9 @@
+const fs=require('fs'),path=require('path'),zlib=require('zlib')
+const D=path.join(__dirname,'..','assets','tabbar'); fs.mkdirSync(D,{recursive:true})
+function crc(b){let c=0xFFFFFFFF;for(let i=0;i<b.length;i++){c^=b[i];for(let j=0;j<8;j++)c=(c>>>1)^(c&1?0xEDB88320:0)}return(c^0xFFFFFFFF)>>>0}
+function mk(t,d){const l=Buffer.alloc(4);l.writeUInt32BE(d.length,0);const tp=Buffer.from(t,'ascii');const cr=Buffer.alloc(4);cr.writeUInt32BE(crc(Buffer.concat([tp,d])),0);return Buffer.concat([l,tp,d,cr])}
+function png(w,h,r,g,b){const p=[];for(let y=0;y<h;y++){p.push(0);for(let x=0;x<w;x++){Math.sqrt((x-32)**2+(y-32)**2)<=28?p.push(r,g,b):p.push(255,255,255)}}
+return Buffer.concat([Buffer.from([137,80,78,71,13,10,26,10]),mk('IHDR',Buffer.from([0,0,0,w,0,0,0,h,8,2,0,0,0])),mk('IDAT',zlib.deflateSync(Buffer.from(p))),mk('IEND',Buffer.alloc(0))])}
+const I=[{n:'home',c:'999999',a:'1890ff'},{n:'discover',c:'999999',a:'1890ff'},{n:'mine',c:'999999',a:'1890ff'}]
+for(const{n,c,a}of I){const cr=h=>[parseInt(h.slice(1,3),16),parseInt(h.slice(3,5),16),parseInt(h.slice(5,7),16)];const[r1,g1,b1]=cr(c),[r2,g2,b2]=cr(a)
+fs.writeFileSync(path.join(D,`${n}.png`),png(81,81,r1,g1,b1));fs.writeFileSync(path.join(D,`${n}-active.png`),png(81,81,r2,g2,b2));console.log(`✓ ${n}`)}

package/templates/miniprogram/src/app.scss

@@ -0,0 +1,9 @@
+@import './styles/variables.scss';
+
+page {
+  font-family: -apple-system, BlinkMacSystemFont, 'Segoe UI', Roboto, 'Helvetica Neue', Arial, sans-serif;
+  font-size: 14px;
+  line-height: 1.5;
+  color: $text-color;
+  background-color: $bg-color;
+}

package/templates/miniprogram/src/app.tsx

@@ -0,0 +1,16 @@
+import { Component, PropsWithChildren } from 'react'
+import './app.scss'
+
+class App extends Component<PropsWithChildren> {
+  componentDidMount() {}
+
+  componentDidShow() {}
+
+  componentDidHide() {}
+
+  render() {
+    return this.props.children
+  }
+}
+
+export default App

package/templates/miniprogram/src/layouts/FullscreenLayout/index.scss

@@ -0,0 +1,2 @@
+.fullscreen-layout { position: relative; width: 100%; min-height: 100vh; display: flex; flex-direction: column; background-color: #fff;
+  &--safe { padding-top: env(safe-area-inset-top); } }

package/templates/miniprogram/src/layouts/FullscreenLayout/index.tsx

@@ -0,0 +1,6 @@
+import { ReactNode } from 'react'
+import { View } from '@tarojs/components'
+import './index.scss'
+export default function FullscreenLayout({ children, className = '', safeArea = true }: { children: ReactNode; className?: string; safeArea?: boolean }) {
+  return <View className={`fullscreen-layout ${safeArea ? 'fullscreen-layout--safe' : ''} ${className}`}>{children}</View>
+}

package/templates/miniprogram/src/layouts/HeaderTabBarLayout/index.scss

@@ -0,0 +1,11 @@
+@import '../../styles/variables.scss';
+.header-tabbar-layout { width: 100%; min-height: 100vh; display: flex; flex-direction: column; background-color: $bg-color;
+  &__header { position: sticky; top: 0; z-index: 100; background: linear-gradient(135deg, #667eea 0%, #764ba2 100%); border-radius: 0 0 $border-radius-lg $border-radius-lg; overflow: hidden; }
+  &__header-content { display: flex; align-items: center; justify-content: space-between; padding: $spacing-md $spacing-lg; }
+  &__title-area { flex: 1; min-width: 0; }
+  &__title { display: block; font-size: var(--fs-xxl); font-weight: 800; color: $text-color-inverse; line-height: 1.2; overflow: hidden; text-overflow: ellipsis; white-space: nowrap; }
+  &__subtitle { display: block; margin-top: $spacing-xs; font-size: var(--fs-sm); color: rgba(255,255,255,0.8); }
+  &__action { flex-shrink: 0; margin-left: $spacing-md; display: flex; align-items: center; justify-content: center; width: 40px; height: 40px; }
+  &__search { padding: 0 $spacing-lg $spacing-md; }
+  &__search-input { width: 100%; height: 64rpx; padding: 0 $spacing-lg; background: rgba(255,255,255,0.9); border-radius: 32rpx; font-size: var(--fs-sm); color: $text-color; }
+  &__body { flex: 1; min-height: 0; display: flex; flex-direction: column; padding: $spacing-lg; } }

package/templates/miniprogram/src/layouts/HeaderTabBarLayout/index.tsx

@@ -0,0 +1,20 @@
+import { ReactNode } from 'react'
+import { View, Text, Input } from '@tarojs/components'
+import Taro from '@tarojs/taro'
+import './index.scss'
+export default function HeaderTabBarLayout({ title, subtitle, showSearch = false, onSearch, rightAction, children, className = '' }: { title: string; subtitle?: string; showSearch?: boolean; onSearch?: (k: string) => void; rightAction?: ReactNode; children: ReactNode; className?: string }) {
+  const sb = Taro.getSystemInfoSync().statusBarHeight || 20
+  return <View className={`header-tabbar-layout ${className}`}>
+    <View className='header-tabbar-layout__header' style={{ paddingTop: `${sb}px` }}>
+      <View className='header-tabbar-layout__header-content'>
+        <View className='header-tabbar-layout__title-area'>
+          <Text className='header-tabbar-layout__title'>{title}</Text>
+          {subtitle && <Text className='header-tabbar-layout__subtitle'>{subtitle}</Text>}
+        </View>
+        {rightAction && <View className='header-tabbar-layout__action'>{rightAction}</View>}
+      </View>
+      {showSearch && <View className='header-tabbar-layout__search'><Input className='header-tabbar-layout__search-input' type='text' placeholder='搜索...' confirmType='search' onConfirm={(e) => onSearch?.(e.detail.value)} /></View>}
+    </View>
+    <View className='header-tabbar-layout__body'>{children}</View>
+  </View>
+}

package/templates/miniprogram/src/layouts/README.md

@@ -0,0 +1,7 @@
+# 布局系统
+
+| 布局 | Header | TabBar | 场景 |
+|------|--------|--------|------|
+| `FullscreenLayout` | ❌ | ❌ | 启动页/活动页 |
+| `TabBarLayout` | 原生 | ✅ | 标准列表页 |
+| `HeaderTabBarLayout` | ✅ 自定义 | ✅ | 品牌化首页 |

package/templates/miniprogram/src/layouts/TabBarLayout/index.scss

@@ -0,0 +1 @@
+.tabbar-layout { width: 100%; min-height: 100vh; display: flex; flex-direction: column; background-color: #f5f5f5; }

package/templates/miniprogram/src/layouts/TabBarLayout/index.tsx

@@ -0,0 +1,6 @@
+import { ReactNode } from 'react'
+import { View } from '@tarojs/components'
+import './index.scss'
+export default function TabBarLayout({ children, className = '' }: { children: ReactNode; className?: string }) {
+  return <View className={`tabbar-layout ${className}`}>{children}</View>
+}

package/templates/miniprogram/src/layouts/index.ts

@@ -0,0 +1,3 @@
+export { default as FullscreenLayout } from './FullscreenLayout'
+export { default as TabBarLayout } from './TabBarLayout'
+export { default as HeaderTabBarLayout } from './HeaderTabBarLayout'

package/templates/miniprogram/src/pages/discover/index.config.ts

@@ -0,0 +1 @@
+export default definePageConfig({ navigationBarTitleText: '发现' })

package/templates/miniprogram/src/pages/discover/index.scss

@@ -0,0 +1,4 @@
+@import '../../styles/variables.scss';
+.discover { flex: 1; display: flex; flex-direction: column; align-items: center; justify-content: center; padding: $spacing-xl;
+  &__title { display: block; font-size: var(--fs-xxl); font-weight: 700; color: $text-color; margin-bottom: $spacing-md; }
+  &__desc { display: block; font-size: var(--fs-sm); color: $text-color-secondary; } }

package/templates/miniprogram/src/pages/discover/index.tsx

@@ -0,0 +1,6 @@
+import { View, Text } from '@tarojs/components'
+import { TabBarLayout } from '@/layouts'
+import './index.scss'
+export default function DiscoverPage() {
+  return <TabBarLayout><View className='discover'><Text className='discover__title'>发现</Text><Text className='discover__desc'>标准 TabBar 布局</Text></View></TabBarLayout>
+}

package/templates/miniprogram/src/pages/home/index.config.ts

@@ -0,0 +1 @@
+export default definePageConfig({ navigationStyle: 'custom' })

package/templates/miniprogram/src/pages/home/index.scss

@@ -0,0 +1,6 @@
+@import '../../styles/variables.scss';
+.home { flex: 1;
+  &__card { background: $bg-color-white; border-radius: $border-radius-lg; padding: $spacing-xl; box-shadow: $shadow-base; }
+  &__card-title { display: block; font-size: var(--fs-lg); font-weight: 700; color: $text-color; margin-bottom: $spacing-md; padding-bottom: $spacing-md; border-bottom: 1px solid $border-color-light; }
+  &__card-body { display: block; font-size: var(--fs-base); color: $text-color-secondary; margin-bottom: $spacing-xl; text-align: center; padding: $spacing-xl 0; }
+  &__btn { width: 100%; height: 80rpx; line-height: 80rpx; background: $primary-color; color: $text-color-inverse; font-size: var(--fs-base); border-radius: $border-radius-base; border: none; } }

package/templates/miniprogram/src/pages/home/index.tsx

@@ -0,0 +1,17 @@
+import { useState, useEffect } from 'react'
+import { View, Text, Button } from '@tarojs/components'
+import Taro from '@tarojs/taro'
+import { HeaderTabBarLayout } from '@/layouts'
+import './index.scss'
+export default function HomePage() {
+  const [g, setG] = useState(''), [loading, setLoading] = useState(false)
+  const fetch = async () => { setLoading(true); try { const r = await Taro.request({ url: 'http://localhost:8080/api/hello' }); const d = r.data as any; if (d.code === 0) setG(d.data.greeting) } catch { Taro.showToast({ title: '网络错误', icon: 'none' }) } finally { setLoading(false) } }
+  useEffect(() => { fetch() }, [])
+  return <HeaderTabBarLayout title='首页' subtitle='Taro + Go 脚手架' showSearch onSearch={(k) => Taro.showToast({ title: `搜索: ${k}`, icon: 'none' })}>
+    <View className='home'><View className='home__card'>
+      <Text className='home__card-title'>Hello World</Text>
+      <Text className='home__card-body'>{loading ? '加载中...' : g || '暂无数据'}</Text>
+      <Button className='home__btn' onClick={fetch} loading={loading}>刷新</Button>
+    </View></View>
+  </HeaderTabBarLayout>
+}

package/templates/miniprogram/src/pages/mine/index.config.ts

@@ -0,0 +1 @@
+export default definePageConfig({ navigationBarTitleText: '我的' })

package/templates/miniprogram/src/pages/mine/index.scss

@@ -0,0 +1,4 @@
+@import '../../styles/variables.scss';
+.mine { flex: 1; display: flex; flex-direction: column; align-items: center; justify-content: center; padding: $spacing-xl;
+  &__title { display: block; font-size: var(--fs-xxl); font-weight: 700; color: $text-color; margin-bottom: $spacing-md; }
+  &__desc { display: block; font-size: var(--fs-sm); color: $text-color-secondary; } }

package/templates/miniprogram/src/pages/mine/index.tsx

@@ -0,0 +1,6 @@
+import { View, Text } from '@tarojs/components'
+import { TabBarLayout } from '@/layouts'
+import './index.scss'
+export default function MinePage() {
+  return <TabBarLayout><View className='mine'><Text className='mine__title'>我的</Text><Text className='mine__desc'>个人中心</Text></View></TabBarLayout>
+}

package/templates/miniprogram/src/pages/splash/index.config.ts

@@ -0,0 +1 @@
+export default definePageConfig({ navigationStyle: 'custom', backgroundColor: '#000000' })

package/templates/miniprogram/src/pages/splash/index.scss

@@ -0,0 +1,11 @@
+@import '../../styles/variables.scss';
+.splash { background: linear-gradient(135deg, #667eea 0%, #764ba2 100%); display: flex; flex-direction: column; align-items: center; justify-content: space-between;
+  &__content { flex: 1; display: flex; flex-direction: column; align-items: center; justify-content: center; padding: $spacing-xl; }
+  &__logo { width: 160rpx; height: 160rpx; border-radius: 50%; background: rgba(255,255,255,0.2); display: flex; align-items: center; justify-content: center; margin-bottom: $spacing-xl; }
+  &__logo-text { font-size: 56rpx; font-weight: 800; color: #fff; }
+  &__title { display: block; font-size: var(--fs-hero); font-weight: 800; color: #fff; margin-bottom: $spacing-md; }
+  &__subtitle { display: block; font-size: var(--fs-base); color: rgba(255,255,255,0.8); margin-bottom: 48px; }
+  &__btn { width: 400rpx; height: 96rpx; border-radius: 48rpx; background: #fff; display: flex; align-items: center; justify-content: center; }
+  &__btn-text { font-size: var(--fs-lg); font-weight: 600; color: #667eea; }
+  &__footer { padding-bottom: 80rpx; }
+  &__footer-text { font-size: var(--fs-xs); color: rgba(255,255,255,0.5); } }

package/templates/miniprogram/src/pages/splash/index.tsx

@@ -0,0 +1,15 @@
+import { View, Text } from '@tarojs/components'
+import Taro from '@tarojs/taro'
+import { FullscreenLayout } from '@/layouts'
+import './index.scss'
+export default function SplashPage() {
+  return <FullscreenLayout safeArea={false} className='splash'>
+    <View className='splash__content'>
+      <View className='splash__logo'><Text className='splash__logo-text'>MS</Text></View>
+      <Text className='splash__title'>Mini Scaffold</Text>
+      <Text className='splash__subtitle'>Taro + Go 小程序脚手架</Text>
+      <View className='splash__btn' onClick={() => Taro.switchTab({ url: '/pages/home/index' })}><Text className='splash__btn-text'>进入</Text></View>
+    </View>
+    <View className='splash__footer'><Text className='splash__footer-text'>全屏沉浸式布局</Text></View>
+  </FullscreenLayout>
+}

package/templates/miniprogram/src/styles/variables.scss

@@ -0,0 +1,41 @@
+// Colors
+$primary-color: #1890ff;
+$success-color: #52c41a;
+$warning-color: #faad14;
+$error-color: #f5222d;
+
+// Text colors
+$text-color: #333333;
+$text-color-secondary: #666666;
+$text-color-inverse: #ffffff;
+
+// Background colors
+$bg-color: #f5f5f5;
+$bg-color-white: #ffffff;
+
+// Border colors
+$border-color: #d9d9d9;
+$border-color-light: #e8e8e8;
+
+// Font sizes
+$font-size-sm: 12px;
+$font-size-base: 14px;
+$font-size-lg: 16px;
+$font-size-xl: 18px;
+
+// Spacing
+$spacing-xs: 4px;
+$spacing-sm: 8px;
+$spacing-md: 12px;
+$spacing-lg: 16px;
+$spacing-xl: 24px;
+
+// Border radius
+$border-radius-sm: 2px;
+$border-radius-base: 4px;
+$border-radius-lg: 8px;
+
+// Shadows
+$shadow-sm: 0 1px 2px 0 rgba(0, 0, 0, 0.03), 0 1px 6px -1px rgba(0, 0, 0, 0.02), 0 2px 4px 0 rgba(0, 0, 0, 0.02);
+$shadow-base: 0 3px 6px -4px rgba(0, 0, 0, 0.12), 0 6px 16px 0 rgba(0, 0, 0, 0.08), 0 9px 28px 8px rgba(0, 0, 0, 0.05);
+$shadow-lg: 0 6px 16px -8px rgba(0, 0, 0, 0.08), 0 9px 28px 0 rgba(0, 0, 0, 0.05), 0 12px 48px 16px rgba(0, 0, 0, 0.03);

package/templates/miniprogram/tsconfig.json

@@ -0,0 +1,31 @@
+{
+  "compilerOptions": {
+    "target": "es2017",
+    "module": "commonjs",
+    "removeComments": false,
+    "preserveConstEnums": true,
+    "moduleResolution": "node",
+    "experimentalDecorators": true,
+    "noImplicitAny": false,
+    "allowSyntheticDefaultImports": true,
+    "outDir": "lib",
+    "noUnusedLocals": true,
+    "noUnusedParameters": true,
+    "strictNullChecks": true,
+    "sourceMap": true,
+    "rootDir": ".",
+    "jsx": "react-jsx",
+    "allowJs": true,
+    "resolveJsonModule": true,
+    "typeRoots": [
+      "node_modules/@types",
+      "global.d.ts"
+    ],
+    "paths": {
+      "@/*": ["./src/*"]
+    },
+    "baseUrl": "."
+  },
+  "include": ["src", "types", "config"],
+  "compileOnSave": false
+}

package/templates/miniprogram/types/global.d.ts

@@ -0,0 +1,18 @@
+/// <reference types="@tarojs/taro" />
+
+declare module '*.png';
+declare module '*.gif';
+declare module '*.jpg';
+declare module '*.jpeg';
+declare module '*.svg';
+declare module '*.css';
+declare module '*.less';
+declare module '*.scss';
+declare module '*.sass';
+declare module '*.styl';
+
+declare namespace NodeJS {
+  interface ProcessEnv {
+    TARO_ENV: 'weapp' | 'swan' | 'alipay' | 'h5' | 'rn' | 'tt' | 'quickapp' | 'qq' | 'jd' | 'harmony-hybrid'
+  }
+}

package/templates/server/.env.example

@@ -0,0 +1,13 @@
+# Server configuration
+PORT=8080
+
+# Application configuration
+APP_NAME=Mini Scaffold API
+APP_ENV=development
+
+# Database configuration (example)
+# DB_HOST=localhost
+# DB_PORT=5432
+# DB_USER=postgres
+# DB_PASSWORD=password
+# DB_NAME=mini_scaffold

package/templates/server/Makefile

@@ -0,0 +1,76 @@
+.PHONY: build run clean test dev
+
+# Variables
+APP_NAME := server
+BUILD_DIR := ./bin
+GO := go
+
+# Build the application
+build:
+	@echo "Building $(APP_NAME)..."
+	@mkdir -p $(BUILD_DIR)
+	$(GO) build -o $(BUILD_DIR)/$(APP_NAME) main.go
+	@echo "Build complete: $(BUILD_DIR)/$(APP_NAME)"
+
+# Run the application
+run: build
+	@echo "Starting $(APP_NAME)..."
+	$(BUILD_DIR)/$(APP_NAME)
+
+# Run in development mode with hot reload (requires air)
+dev:
+	@echo "Starting development server..."
+	@which air > /dev/null 2>&1 || (echo "Installing air..." && go install github.com/cosmtrek/air@latest)
+	air
+
+# Clean build artifacts
+clean:
+	@echo "Cleaning build artifacts..."
+	@rm -rf $(BUILD_DIR)
+	@echo "Clean complete"
+
+# Run tests
+test:
+	@echo "Running tests..."
+	$(GO) test -v ./...
+
+# Format code
+fmt:
+	@echo "Formatting code..."
+	$(GO) fmt ./...
+
+# Vet code
+vet:
+	@echo "Vetting code..."
+	$(GO) vet ./...
+
+# Lint code (requires golangci-lint)
+lint:
+	@echo "Linting code..."
+	@which golangci-lint > /dev/null 2>&1 || (echo "Installing golangci-lint..." && go install github.com/golangci/golangci-lint/cmd/golangci-lint@latest)
+	golangci-lint run
+
+# Download dependencies
+deps:
+	@echo "Downloading dependencies..."
+	$(GO) mod download
+
+# Tidy dependencies
+tidy:
+	@echo "Tidying dependencies..."
+	$(GO) mod tidy
+
+# Show help
+help:
+	@echo "Available targets:"
+	@echo "  build    - Build the application"
+	@echo "  run      - Build and run the application"
+	@echo "  dev      - Run in development mode with hot reload"
+	@echo "  clean    - Clean build artifacts"
+	@echo "  test     - Run tests"
+	@echo "  fmt      - Format code"
+	@echo "  vet      - Vet code"
+	@echo "  lint     - Lint code"
+	@echo "  deps     - Download dependencies"
+	@echo "  tidy     - Tidy dependencies"
+	@echo "  help     - Show this help"

package/templates/server/README.md

@@ -0,0 +1,134 @@
+# Mini Scaffold Server
+
+A simple Go backend server built with Fiber framework.
+
+## Prerequisites
+
+- Go 1.21 or higher
+
+## Getting Started
+
+### Install dependencies
+
+```bash
+go mod tidy
+```
+
+### Run the server
+
+```bash
+# Using make
+make run
+
+# Or directly
+go run main.go
+```
+
+### Development mode
+
+```bash
+# Using make (requires air for hot reload)
+make dev
+```
+
+## API Endpoints
+
+### Health Check
+
+```
+GET /api/health
+```
+
+Response:
+```json
+{
+  "code": 200,
+  "message": "OK",
+  "data": {
+    "status": "healthy"
+  }
+}
+```
+
+### Hello World
+
+```
+GET /api/hello
+```
+
+Response:
+```json
+{
+  "code": 200,
+  "message": "success",
+  "data": {
+    "greeting": "Hello, World! 来自 Go 后端",
+    "timestamp": "2024-01-01T00:00:00Z",
+    "version": "1.0.0"
+  }
+}
+```
+
+### Hello with Name
+
+```
+POST /api/hello
+Content-Type: application/json
+
+{
+  "name": "YourName"
+}
+```
+
+Response:
+```json
+{
+  "code": 200,
+  "message": "success",
+  "data": {
+    "greeting": "Hello, YourName! 来自 Go 后端",
+    "timestamp": "2024-01-01T00:00:00Z"
+  }
+}
+```
+
+## Configuration
+
+The server can be configured using environment variables or a `.env` file:
+
+- `PORT` - Server port (default: 8080)
+- `APP_NAME` - Application name
+- `APP_ENV` - Application environment (development/production)
+
+## Project Structure
+
+```
+server/
+├── main.go          # Entry point
+├── go.mod           # Go module file
+├── go.sum           # Go dependencies checksum
+├── .env             # Environment variables
+├── .env.example     # Example environment variables
+├── Makefile         # Build and run commands
+└── README.md        # This file
+```
+
+## Building for Production
+
+```bash
+# Build binary
+make build
+
+# Run binary
+./bin/server
+```
+
+## Testing
+
+```bash
+make test
+```
+
+## License
+
+MIT

package/templates/server/go.mod

@@ -0,0 +1,25 @@
+module mini-scaffold-server
+
+go 1.21
+
+require (
+	github.com/gofiber/fiber/v2 v2.52.0
+	github.com/joho/godotenv v1.5.1
+)
+
+require (
+	github.com/andybalholm/brotli v1.0.5 // indirect
+	github.com/google/uuid v1.5.0 // indirect
+	github.com/klauspost/compress v1.17.4 // indirect
+	github.com/mattn/go-colorable v0.1.13 // indirect
+	github.com/mattn/go-isatty v0.0.20 // indirect
+	github.com/mattn/go-runewidth v0.0.15 // indirect
+	github.com/philhofer/fwd v1.1.2 // indirect
+	github.com/rivo/uniseg v0.4.4 // indirect
+	github.com/savsgio/gotils v0.0.0-20230208104028-c358bd845dee // indirect
+	github.com/tinylib/msgp v1.1.9 // indirect
+	github.com/valyala/bytebufferpool v1.0.0 // indirect
+	github.com/valyala/fasthttp v1.51.0 // indirect
+	github.com/valyala/tcplisten v1.0.0 // indirect
+	golang.org/x/sys v0.15.0 // indirect
+)

package/templates/server/main.go

@@ -0,0 +1,126 @@
+package main
+
+import (
+	"log"
+	"os"
+
+	"github.com/gofiber/fiber/v2"
+	"github.com/gofiber/fiber/v2/middleware/cors"
+	"github.com/gofiber/fiber/v2/middleware/logger"
+	"github.com/gofiber/fiber/v2/middleware/recover"
+	"github.com/joho/godotenv"
+)
+
+func main() {
+	// Load .env file if it exists
+	if err := godotenv.Load(); err != nil {
+		log.Println("No .env file found, using default configuration")
+	}
+
+	// Get port from environment variable or use default
+	port := os.Getenv("PORT")
+	if port == "" {
+		port = "8080"
+	}
+
+	// Create Fiber app
+	app := fiber.New(fiber.Config{
+		AppName:      "Mini Scaffold API",
+		ServerHeader: "Mini Scaffold",
+		ErrorHandler: func(c *fiber.Ctx, err error) error {
+			code := fiber.StatusInternalServerError
+			if e, ok := err.(*fiber.Error); ok {
+				code = e.Code
+			}
+			return c.Status(code).JSON(fiber.Map{
+				"code":    code,
+				"message": err.Error(),
+			})
+		},
+	})
+
+	// Middleware
+	app.Use(recover.New())
+	app.Use(logger.New(logger.Config{
+		Format: "${time} ${method} ${path} ${status} ${latency}\n",
+	}))
+	app.Use(cors.New(cors.Config{
+		AllowOrigins: "*",
+		AllowMethods: "GET,POST,PUT,DELETE,OPTIONS",
+		AllowHeaders: "Origin,Content-Type,Accept,Authorization",
+	}))
+
+	// Routes
+	setupRoutes(app)
+
+	// Start server
+	log.Printf("Server starting on port %s", port)
+	if err := app.Listen(":" + port); err != nil {
+		log.Fatalf("Failed to start server: %v", err)
+	}
+}
+
+func setupRoutes(app *fiber.App) {
+	// API group
+	api := app.Group("/api")
+
+	// Health check
+	api.Get("/health", func(c *fiber.Ctx) error {
+		return c.JSON(fiber.Map{
+			"code":    200,
+			"message": "OK",
+			"data": fiber.Map{
+				"status": "healthy",
+			},
+		})
+	})
+
+	// Hello world endpoint
+	api.Get("/hello", func(c *fiber.Ctx) error {
+		return c.JSON(fiber.Map{
+			"code":    200,
+			"message": "success",
+			"data": fiber.Map{
+				"greeting":  "Hello, World! 来自 Go 后端",
+				"timestamp": "2024-01-01T00:00:00Z",
+				"version":   "1.0.0",
+			},
+		})
+	})
+
+	// Example POST endpoint
+	api.Post("/hello", func(c *fiber.Ctx) error {
+		type Request struct {
+			Name string `json:"name"`
+		}
+
+		var req Request
+		if err := c.BodyParser(&req); err != nil {
+			return c.Status(fiber.StatusBadRequest).JSON(fiber.Map{
+				"code":    400,
+				"message": "Invalid request body",
+			})
+		}
+
+		if req.Name == "" {
+			req.Name = "World"
+		}
+
+		return c.JSON(fiber.Map{
+			"code":    200,
+			"message": "success",
+			"data": fiber.Map{
+				"greeting":  "Hello, " + req.Name + "! 来自 Go 后端",
+				"timestamp": "2024-01-01T00:00:00Z",
+			},
+		})
+	})
+
+	// Catch-all route for 404
+	app.Use(func(c *fiber.Ctx) error {
+		return c.Status(fiber.StatusNotFound).JSON(fiber.Map{
+			"code":    404,
+			"message": "Route not found",
+		})
+	})
+}