一个在面试中能够成为亮点的开源前端脚手架,重构两天 star 数倍增🚀🚀🚀

在文章的开头先上地址:

Github地址: github.com/xun082/reac...

NPM地址: www.npmjs.com/package/cre...

零:重构内容

本人目前正在和一群小伙伴开发一个前端脚手架,目前是正在重构阶段,现阶段已经完成了

  1. 使用 Turborepo + PNPM 实现 Monorepo 策略,方便更好地管理子项目。

  2. 添加了更多的开发规范,其中包括 husky 、eslint 、Prettier 、ci 、cd 等等。

  3. 添加了更规范的 issue 模板和 pr 模板,并且配备机器人 code review 。

  4. 其他原有功能可查看文档,目前新开发的功能暂未进行发版。

至于后期是要做成个什么样类型的项目,我这也一下子描述不清楚,如果你也感兴趣或者想进交流群进行学习(整个项目大而全,基本涵盖了前端工程化的一些相关知识),欢迎加我微信交流 yunmz777 ,如果该项目对你有帮助,欢迎 star ⭐️⭐️⭐️⭐️⭐️

一、背景 📖

在刚开始学习 React 的时候,使用的脚手架就是 create-react-app,虽然这个脚手架提供的零配置、开箱即用很适合新手,但是要想对其进行扩展就非常麻烦。要想对其进行扩展你必须 eject 或者 使用 carco 进行配置。

尽管 Typescript 已经流行了很久,但是要从零设计一个 Typescript 库依旧麻烦,本人也曾有过从零搭建一个 React 组件库的想法,但是对一堆陌生的配置望而生畏。

Create-Neat 就是为了解决这些问题应运而生的,解决以上所有问题,开箱即用,零配置 🚀🚀🚀

二、特性 🧰

  • 📦 零配置,开箱即用;
  • 🚀 使用 axios + npm 的方式构建你的项目基础模板,初始化速度要比 create-react-app 快;
  • 💯 代码风格统一,项目统一配置 EslintPrettierHusky;
  • 🥂 使用 Rollup 打包你的 Typescript 库,支持 UMDCJSESM 输出格式,并生成全局 .d.ts 文件;
  • 🍻 支持用户自定义 Rollup 配置扩展原有的配置,为项目添加特有的功能;
  • 🥂 使用 Webpack 打包你的 Web 应用程序,实现多环境打包部署,代码分割优化,配合官方分析工具,实时优化代码;
  • 🍻 支持用户自定义 Webpack 配置扩展原有的配置,为项目添加特有的功能;
  • 🎯 支用户自定义 Babel 配置,让你的程序更健壮;
  • 📕 友好的日志输出,让你快速定位问题所在以及增加开发体验;
  • 在使用 Husky 的情况下使用 standard-version 自动生成 CHANGELOG 文件;
  • 🔸 等等......

三、快速开始 🚩

perl 复制代码
npx create-neat my-app
cd my-app
npm start

如果你之前已经通过 npm install -g create-neat 全局安装了 create-neat,我们建议你使用 npm uninstall -g create-neatyarn global remove create-neat 来卸载这个包,以确保 npx 总是使用最新的版本。

当你在终端中输入 npx create-neat my-app 时,控制台会有以下选项功能选择:

create-neat 会根据你的创建不同的应用程序,这些应用程序都是开箱即用,无需配置,其中:

  • common-lib:一个基础的 Typescript 库,您可以使用该模板来编写一个类似于 lodash 的工具库;
  • react-ui: 为你快速创建一个 react 组件库,内置 storybook 让你快速编写你的组件库文档,并且使用 standard-version 自动为你生成 CHANGELOG 文件;
  • 剩下的四个都是为你创建不用的 web 应用程序,其中 vue 同时支持 .vue.tsx 的语法。

如果项目创建成功,会有如下效果图所示:

更多使用方式后续会在 掘金 中以文章方式呈现出来,感兴趣的小伙伴可以关注一下。

四、 创建应用程序 📕

要创建一个新的应用程序,您可以选择以下方法之一:

NPX

lua 复制代码
npx create-neat my-app

NPM

csharp 复制代码
npm init neat my-app

YARN

lua 复制代码
yarn create neat my-app

它将在当前文件夹中创建一个名为 my-app 的目录。 在该目录中,它将根据你所选择的项目类型生成不同的初始项目结构并根据你所选择的包管理工具进行安装可传递的依赖项,例如当你选择 react-ui 时会为你创建一个开箱即用的组件库模板,具体目录结构如下所示:

lua 复制代码
├───📁 .husky/
│   ├───📄 commit-msg
│   └───📄 pre-commit
├───📁 .storybook/
│   ├───📄 main.js
│   └───📄 preview.js
├───📁 .vscode/
│   └───📄 settings.json
├───📁 example/
│   ├───📄 App.tsx
│   ├───📄 index.html
│   ├───📄 index.tsx
│   ├───📄 package.json
│   └───📄 tsconfig.json
├───📁 src/
│   ├───📁 components/
│   │   └───...
│   └───📄 index.tsx
├───📁 stories/
│   └───📄 button.stories.tsx
├───📄 .eslintignore
├───📄 .eslintrc.json
├───📄 .gitignore
├───📄 .prettierignore
├───📄 .prettierrc.json
├───📄 babel.config.js
├───📄 commitlint.config.js
├───📄 package.json
├───📄 pnpm-lock.yaml
└───📄 tsconfig.json

无需配置或复杂的文件夹结构,只有构建应用程序所需的文件。

安装完成后,你可以打开你的项目文件夹:

bash 复制代码
cd my-app

在新创建的项目中,您可以运行一些内置命令:

npm startpnpm start 或者 yarn start

如果你使用的是 web 相对应的项目类型,则在开发模式下运行应用程序并自动打开 http://localhost:3000 在浏览器中进行查看,否则则使用 Rollup 中的 watch 钩子在命令行终端中监听您文件的变化。

npm buildpnpm build 或者 yarn build

如果您使用的是 web 应用程序,使用该命令则会将其应用程序优化构建以获得最佳性能并将其存放与 dist 目录下。

如果您在项目初始化的时候选择的 common-lib 或者 react-ui,那么该应用程序将会使用 Rollup 进行打包构建,并根据你所传入的参数构建成不同格式的文件,完整参数配置如下所示:

sql 复制代码
Usage
  $ rollup-script build [options]

Options
  --target              指定目标环境  默认使用 web
  --name                指定在 UMD 模式构建中全局的名称
  --format              指定模式格式(cjs,esm,umd)  默认是 esm

Examples
  $ rollup-script build --target node
  $ rollup-script build --name Foo
  $ rollup-script build --format cjs,esm,umd
  $ rollup-script build --format umd --name Foo

Babel

您可以将自己的 Babel 配置添加到项目的根目录当中, create-neat 会将其与自己原有的 Babel 转换合并并且将新的预设和插件放在列表的末尾。

Example

js 复制代码
// babel.config.js

module.exports = {
  plugins: ["babel-plugin-styled-components"],
};

webpack

⚠️ Warning 这些修改有可能覆盖 create-neat 的默认行为和配置,请谨慎使用!

如果您想扩展 webpack 配置已增加项目对不同功能的支持或者增加项目性能,您可以在 webpack.config.js 文件下对 webpack 配置进行扩展.并且您可以使用 process.env.NODE_ENV 以区分开发环境和生产环境。

Example

js 复制代码
// webpack.config.js

const MiniCssExtractPlugin = require("mini-css-extract-plugin");
const isDevelopment = process.env.NODE_ENV === "development";

module.exports = {
  plugins: [isDevelopment && MiniCssExtractPlugin()],
};

Rollup

⚠️ Warning 这些修改有可能覆盖 create-neat 的默认行为和配置,请谨慎使用!

如果你选择的项目类型是 common-lib 或者 react-ui 并且您希望更改 Rollup 配置,可以在项目的根目录下创建一个名为 rollup.config.js 的文件,示例代码如下所示:

js 复制代码
module.exports = {
  rollup(config, options) {
    return config;
  },
};

Example

js 复制代码
const postcss = require("rollup-plugin-postcss");

module.exports = {
  rollup(config, options) {
    config.plugins.push(postcss());
    return config;
  },
};

五、贡献 🍵

如果你正在使用这个项目或者对这个项目感兴趣,可以通过以下方式支持我:

  • Star、Fork、Watch 一键三连 🚀🚀

我们很乐意在 create-neat 中得到您的帮助,看到您的贡献,如果你想获取到更多信息以及如何开始,请扫描进群, 二维码链接地址

群里提供的机器人,感兴趣的可以来玩 🐒🐒🐒

六、最后 💥

正如 《道德经》 中所言 流水不争先,争的是滔滔不绝,这个项目会在后面一点一点慢慢完善,并扩展其他功能,例如 SSR 的支持。

如果该脚手架有什么问题或者有什么想法可以通过 Githubissue 给我留言。

如果觉得该项目对你有帮助,也欢迎你给个 star,让更多的朋友能看到。

Github地址: github.com/xun082/reac...

NPM地址: www.npmjs.com/package/cre...

相关推荐
sunshine6411 分钟前
【CSS】实现tag选中对钩样式
前端·css·css3
sdaxue.com11 分钟前
帝国CMS:如何去掉帝国CMS登录界面的认证码登录
数据库·github·网站·帝国cms·认证码
m0_7482475523 分钟前
github webhooks 实现网站自动更新
github
真滴book理喻24 分钟前
Vue(四)
前端·javascript·vue.js
蜜獾云26 分钟前
npm淘宝镜像
前端·npm·node.js
dz88i827 分钟前
修改npm镜像源
前端·npm·node.js
Jiaberrr31 分钟前
解锁 GitBook 的奥秘:从入门到精通之旅
前端·gitbook
程序员_三木1 小时前
Three.js入门-Raycaster鼠标拾取详解与应用
开发语言·javascript·计算机外设·webgl·three.js
顾平安2 小时前
Promise/A+ 规范 - 中文版本
前端
聚名网2 小时前
域名和服务器是什么?域名和服务器是什么关系?
服务器·前端