zhule / react-admin

基于 Ant Design React 的管理系统架构

React Admin

基于React17.x、Ant Design4.x的管理系统架构。

• 在线预览
• 查看文档
• 组件库ra-lib文档

安装依赖

• node v12.14.0
• yarn 1.22.10

yarn

注：如果由于网络等原因安装不成功，可以尝试 tyarn 或 cnpm 或 npm 或 yarn --registry https://registry.npm.taobao.org

设置环境变量，windows平台可以使用 cross-env

开发启动

如果您是第一次使用，想快速预览效果，可以是用mock方式启动：REACT_APP_MOCK=true yarn start

# 正常启动开发模式
yarn start 

# 自定义端口
PORT=3001 yarn start

# HTTPS 方式启动
HTTPS=true yarn start

# 开启本地mock
REACT_APP_MOCK=true yarn start

开发代理 & 测试代理

修改src/setupProxyConfig.json，页面右上角头部有下拉，可以快速切换代理。

[
    {
        "name": "张三",
        "disabled": false,
        "baseUrl": "/zhangsan",
        "target": "http://127.0.0.1:8080"
    },
    {
        "name": "测试环境",
        "baseUrl": "/api",
        "target": "http://127.0.0.1:8080"
    }
]

生产构建

# 正常构建
yarn build

# 构建到指定目录
BUILD_PATH=./dist yarn build

# 指定配置环境
REACT_APP_CONFIG_ENV=test yarn build

# 打包大小分析
yarn build:analyzer

# 打包时间分析
yarn build:time

样式

• 支持less及css
• src下less进行css module处理，css不进行css module处理
• css module 应用样式写法

  import styles from './style.module.less';
  
  <div className={styles.root}>
      <h1 className={styles.title}></h1>
  </div>

• 项目中添加了classnames扩展，可以直接按照classnames方式在className中编写样式；

      import styles from './style.module.less';
  
      const isActive = true;
  
      <div className={[styles.root, isActive && styles.active]}>
          <h1 className={styles.title}></h1>
      </div>

• 主题变量修改 theme.less antd 样式变量

代码规范

代码规范使用 prettier 参考知乎这片文章

团队多人开发，无论使用webstorm还是vscode，都使用prettier（配置文件：.prettierrc.js）进行代码格式化。

IDE格式化快捷键可以配置成prettier

git commit 时会根据prettier进行代码格式化，确保提交到仓库的代码都符合规范