# create-huijia-nuxt-starter

一个基于 Nuxt 4 的企业级项目启动模板 CLI 工具。集成了现代前端开发的最佳实践和常用工具库，帮助你快速搭建高质量的 Nuxt 项目。

## ✨ 特性

- **Nuxt 4**: 使用最新的 Nuxt 框架。
- **UI 框架**: 集成 [Element Plus](https://element-plus.org/) 和 [UnoCSS](https://unocss.dev/)，快速构建美观界面。
- **状态管理**: 内置 [Pinia](https://pinia.vuejs.org/)，提供直观的状态管理。
- **工具库**: 集成 [VueUse](https://vueuse.org/) 和 [Lodash](https://lodash.com/)，提供丰富的实用工具函数。
- **HTTP 请求**: 封装了 Axios，支持拦截器和类型提示。
- **代码规范**: 预设 ESLint、Prettier 和 Stylelint，保证代码风格统一。
- **Git 钩子**: 配置了 Husky 和 Lint-staged，在提交前自动检查代码。
- **TypeScript**: 全面支持 TypeScript，提供优秀的开发体验。

## 🚀 快速开始

无需安装，直接使用 `npm create` 或 `npx` 即可快速创建项目：

### 使用 npm

```bash
npm create huijia-nuxt-starter
```

### 使用 npx

```bash
npx create-huijia-nuxt-starter
```

## 🛠️ 安装说明

如果你希望全局安装此 CLI 工具：

```bash
npm install -g create-huijia-nuxt-starter
```

安装后，可以在任意目录下运行：

```bash
create-huijia-nuxt-starter
```

## 📦 项目结构

创建后的项目将包含以下核心目录结构：

```text
├── app/                # 应用源码
│   ├── api/            # API 接口定义
│   ├── components/     # Vue 组件
│   ├── composables/    # 组合式函数
│   ├── layouts/        # 页面布局
│   ├── pages/          # 页面路由
│   ├── stores/         # Pinia 状态管理
│   └── utils/          # 工具函数
├── public/             # 静态资源
├── nuxt.config.ts      # Nuxt 配置
└── uno.config.ts       # UnoCSS 配置
```

## 💻 本地开发

如果你想参与此 CLI 工具的开发：

1. 克隆仓库：
   ```bash
   git clone <repository-url>
   cd nuxt-starter
   ```

2. 安装依赖：
   ```bash
   pnpm install
   ```

3. 链接到全局进行测试：
   ```bash
   npm link
   ```

4. 现在你可以在本地运行 `create-huijia-nuxt-starter` 来测试你的更改。

## 📄 License

MIT