[Webpack + Babel] CRA 없이 리액트 세팅하기

1. CRA로 만든 프로젝트 eject하여 설정 살펴보기

npm run eject 를 실행하면 cra를 구성하는 숨겨진 모든 설정을 밖으로 내보내준다.

실행 이후에 변경되는 package.json을 보고 리액트 앱을 만드는데 필요한 모듈을 확인하여 직접 앱을 띄울 수 있다.

# cra로 react app 만들기
npx create-react-app eject-test

# eject
npm run eject

• eject 이전 package.json

{
  "name": "eject-test",
  "version": "0.1.0",
  "private": true,
  "dependencies": {
    "@testing-library/jest-dom": "^5.17.0",
    "@testing-library/react": "^13.4.0",
    "@testing-library/user-event": "^13.5.0",
    "react": "^18.2.0",
    "react-dom": "^18.2.0",
    "react-scripts": "5.0.1",
    "web-vitals": "^2.1.4"
  },
  "scripts": {
    "start": "react-scripts start",
    "build": "react-scripts build",
    "test": "react-scripts test",
    "eject": "react-scripts eject"
  },
  "eslintConfig": {
    "extends": [
      "react-app",
      "react-app/jest"
    ]
  },
  "browserslist": {
    "production": [
      ">0.2%",
      "not dead",
      "not op_mini all"
    ],
    "development": [
      "last 1 chrome version",
      "last 1 firefox version",
      "last 1 safari version"
    ]
  }
}

• eject 이후 package.json

{
  "name": "eject-test",
  "version": "0.1.0",
  "private": true,
  "dependencies": {
    "@babel/core": "^7.16.0",
    "@pmmmwh/react-refresh-webpack-plugin": "^0.5.3",
    "@svgr/webpack": "^5.5.0",
    "@testing-library/jest-dom": "^5.17.0",
    "@testing-library/react": "^13.4.0",
    "@testing-library/user-event": "^13.5.0",
    "babel-jest": "^27.4.2",
    "babel-loader": "^8.2.3",
    "babel-plugin-named-asset-import": "^0.3.8",
    "babel-preset-react-app": "^10.0.1",
    "bfj": "^7.0.2",
    "browserslist": "^4.18.1",
    "camelcase": "^6.2.1",
    "case-sensitive-paths-webpack-plugin": "^2.4.0",
    "css-loader": "^6.5.1",
    "css-minimizer-webpack-plugin": "^3.2.0",
    "dotenv": "^10.0.0",
    "dotenv-expand": "^5.1.0",
    "eslint": "^8.3.0",
    "eslint-config-react-app": "^7.0.1",
    "eslint-webpack-plugin": "^3.1.1",
    "file-loader": "^6.2.0",
    "fs-extra": "^10.0.0",
    "html-webpack-plugin": "^5.5.0",
    "identity-obj-proxy": "^3.0.0",
    "jest": "^27.4.3",
    "jest-resolve": "^27.4.2",
    "jest-watch-typeahead": "^1.0.0",
    "mini-css-extract-plugin": "^2.4.5",
    "postcss": "^8.4.4",
    "postcss-flexbugs-fixes": "^5.0.2",
    "postcss-loader": "^6.2.1",
    "postcss-normalize": "^10.0.1",
    "postcss-preset-env": "^7.0.1",
    "prompts": "^2.4.2",
    "react": "^18.2.0",
    "react-app-polyfill": "^3.0.0",
    "react-dev-utils": "^12.0.1",
    "react-dom": "^18.2.0",
    "react-refresh": "^0.11.0",
    "resolve": "^1.20.0",
    "resolve-url-loader": "^4.0.0",
    "sass-loader": "^12.3.0",
    "semver": "^7.3.5",
    "source-map-loader": "^3.0.0",
    "style-loader": "^3.3.1",
    "tailwindcss": "^3.0.2",
    "terser-webpack-plugin": "^5.2.5",
    "web-vitals": "^2.1.4",
    "webpack": "^5.64.4",
    "webpack-dev-server": "^4.6.0",
    "webpack-manifest-plugin": "^4.0.2",
    "workbox-webpack-plugin": "^6.4.1"
  },
  "scripts": {
    "start": "node scripts/start.js",
    "build": "node scripts/build.js",
    "test": "node scripts/test.js"
  },
  "eslintConfig": {
    "extends": [
      "react-app",
      "react-app/jest"
    ]
  },
  "browserslist": {
    "production": [
      ">0.2%",
      "not dead",
      "not op_mini all"
    ],
    "development": [
      "last 1 chrome version",
      "last 1 firefox version",
      "last 1 safari version"
    ]
  },
  "jest": {
    "roots": [
      "<rootDir>/src"
    ],
    "collectCoverageFrom": [
      "src/**/*.{js,jsx,ts,tsx}",
      "!src/**/*.d.ts"
    ],
    "setupFiles": [
      "react-app-polyfill/jsdom"
    ],
    "setupFilesAfterEnv": [
      "<rootDir>/src/setupTests.js"
    ],
    "testMatch": [
      "<rootDir>/src/**/__tests__/**/*.{js,jsx,ts,tsx}",
      "<rootDir>/src/**/*.{spec,test}.{js,jsx,ts,tsx}"
    ],
    "testEnvironment": "jsdom",
    "transform": {
      "^.+\\.(js|jsx|mjs|cjs|ts|tsx)$": "<rootDir>/config/jest/babelTransform.js",
      "^.+\\.css$": "<rootDir>/config/jest/cssTransform.js",
      "^(?!.*\\.(js|jsx|mjs|cjs|ts|tsx|css|json)$)": "<rootDir>/config/jest/fileTransform.js"
    },
    "transformIgnorePatterns": [
      "[/\\\\]node_modules[/\\\\].+\\.(js|jsx|mjs|cjs|ts|tsx)$",
      "^.+\\.module\\.(css|sass|scss)$"
    ],
    "modulePaths": [],
    "moduleNameMapper": {
      "^react-native$": "react-native-web",
      "^.+\\.module\\.(css|sass|scss)$": "identity-obj-proxy"
    },
    "moduleFileExtensions": [
      "web.js",
      "js",
      "web.ts",
      "ts",
      "web.tsx",
      "tsx",
      "json",
      "web.jsx",
      "jsx",
      "node"
    ],
    "watchPlugins": [
      "jest-watch-typeahead/filename",
      "jest-watch-typeahead/testname"
    ],
    "resetMocks": true
  },
  "babel": {
    "presets": [
      "react-app"
    ]
  }
}

2. NPM

Node Package Manager의 약자로, 자바스크립트 라이브러리를 편하게 설치하고 관리하도록 돕는 패키지 매니저

# default로 설정된 package.json 생성
npm init -y

3. Webpack

웹팩이란?

최근 프론트엔드 프레임워크에서 많이 사용되는 모듈 번들러이다.

모듈 번들러란 웹 애플리케이션을 구성하는 자원 (HTML, CSS, JS 등)을 모두 각각의 모둘로 보고 이를 조합해서 병합된 하나의 결과물을 만드는 도구를 의미한다.

# webpack dev 설치
npm i -D webpack webpack-cli

3-1. webpack dev server

💡 Use webpack with a development server that provides live reloading. This should be used for development only.

파일 변경 후 매번 웹팩 명령어를 실행하지 않아도 저장하면 Webpack으로 빌드한 결과를 브라우저에서 자동으로 재로드하여 반영해준다.

# webpack-dev-server dev 설치
npm i -D webpack-dev-server

3-2. html webpack plugin

html 파일을 템플릿으로 생성할 수 있게 도와주는 플러그인이다.

html 파일에 link, script로 css, js를 연결하지 않아도 html 코드 안에 웹팩으로 빌드한 결과물을 자동으로 주입시켜준다.

컴파일이나 번들링등 해시로 된 파일이름을 가진 번들에 유용하다.

# html webpack plugin dev 설치
npm i -D html-webpack-plugin

3-3. webpack.config.js

const HtmlWebpackPlugin = require("html-webpack-plugin");
const path = require("path");

module.exports = {
  entry: "./src/index.tsx", // webpack 최초 진입점(엔트리 포인트) 파일 경로를 설정합니다.
  module: {
    rules: [
      {
        test: /\\.(ts|js|tsx|jsx)$/,
        exclude: /node_modules/,
        use: [
          {
            loader: "babel-loader", 
            options: { 
              presets: [ // babel-loader preset 옵션 설정
                "@babel/preset-env",
                ["@babel/preset-react", { runtime: "automatic" }],
              ],
            },
          },
          {
            loader: "ts-loader",
          },
        ],
      },
    ],
  },
  output: {
    // webpack을 실행한 후의 결과물의 이름/경로 등을 설정합니다.
    filename: "index_bundle.js",
    path: path.resolve(__dirname, "dist"),
  },
  plugins: [
    new HtmlWebpackPlugin({
      template: "./index.html", // 번들링 파일을 주입하여 번들링 폴더로 복사할 대상 HTML 파일을 설정합니다.
    }),
  ],
  devServer: {
    // webpack-dev-server 옵션을 설정합니다.
    static: path.resolve(__dirname, "dist"),
    historyApiFallback: true, // 404 페이지 대신 index.html로 이동합니다.
    hot: true, // 모듈 전체를 다시 로드하지 않고 변경된 사항만 갱신합니다.
  },
  resolve: {
    // resolve: import를 할 때 확장자를 생략할 수 있습니다.
    extensions: [".tsx", ".ts", ".js"],
  },
};

• entry : 내부 의존 모듈과 라이브러리를 찾는 경로 지정
• output : 번들을 내보낼 위치와 파일 이름 지정.
• plugins : 특정 유형의 모듈을 변환하는데 사용. 또는 번들 최적화 등등 광범위한 작업 수행
• devServer
• reslove

3-4. 웹팩 실행

배포(build)시 webpack 명령어, mode=production

개발(start)시 webpack dev server 실행 mode=development

• package.json에 script추가

{
  "name": "cra-practice",
  "version": "1.0.0",
  "description": "",
  "main": "index.js",
  "scripts": {
    "build": "webpack --mode=production", // 추가
    "start": "webpack serve --mode=development" // 추가
  },
  "keywords": [],
  "author": "",
  "license": "ISC",
  "devDependencies": {
    "html-webpack-plugin": "^5.5.3",
    "webpack": "^5.88.2",
    "webpack-cli": "^5.1.4",
    "webpack-dev-server": "^4.15.1"
  }
}

4. Babel

ECMAScript 2015+ 코드를 현재 및 과거 브라우저와 같은 환경에서 호환되는 버전으로 변환하기 위해 사용하는 도구

# babel 설치
npm i -D @babel/core @babel/cli @babel/preset-env @babel/preset-react babel-loader

• @babel/core : babel 설치
• @babel/cli : babel 커맨드라인 설치
• @babel/preset-env : ECMAScript2015+ 를 변환하는 프리셋(*프리셋이란 간단히 ‘플러그인 모음’)
• @babel/preset-react : react 변환을 위한 preset
• babel-loader : babel을 웹팩으로 통합해서 사용할 수 있다.

5. ESlint

ECMAScript 코드의 문법, 문제점, 규칙등을 검사하고 정정하는 Lint 도구

# eslint 설치
npm i -D eslint

# .eslintrc 파일 자동 생성
npx eslint --init 

• eslintrc.js

module.exports = {
    "env": {
        "browser": true,
        "es2021": true
    },
    "extends": [
        "eslint:recommended",
        "plugin:@typescript-eslint/recommended",
        "plugin:react/recommended"
    ],
    "overrides": [
        {
            "env": {
                "node": true
            },
            "files": [
                ".eslintrc.{js,cjs}"
            ],
            "parserOptions": {
                "sourceType": "script"
            }
        }
    ],
    "parser": "@typescript-eslint/parser",
    "parserOptions": {
        "ecmaVersion": "latest",
        "sourceType": "module"
    },
    "plugins": [
        "@typescript-eslint",
        "react"
    ],
    "rules": {
    }
}

6. React

npm i react react-dom

7. tsconfig.json

https://webpack.kr/guides/typescript/

https://it-eldorado.tistory.com/128

ts-loader 는 Typescript 컴파일러인 tsc 를 사용하고, tsconfig.json 의 설정을 따른다.

# typescript 설치
npm i -D @types/react @types/react-dom typescript ts-loader

• tsconfig.json

// tsconfig.json
{
  "compilerOptions": {
    "outDir": "./dist/",
    "noImplicitAny": true,
    "module": "es6",
    "target": "es5",
    "jsx": "react",
    "allowJs": true,
    "moduleResolution": "node",
    "allowSyntheticDefaultImports": true
  }
}

• package.json

{
  "name": "cra-practice",
  "version": "1.0.0",
  "description": "",
  "main": "index.tsx",
  "scripts": {
    "build": "webpack --config webpack.config.js --mode=production",
    "start": "webpack serve --config webpack.config.js --mode=development"
  },
  "keywords": [],
  "author": "",
  "license": "ISC",
  "devDependencies": {
    "@babel/cli": "^7.23.0",
    "@babel/core": "^7.23.0",
    "@babel/preset-env": "^7.22.20",
    "@babel/preset-react": "^7.22.15",
    "@types/react": "^18.2.23",
    "@types/react-dom": "^18.2.7",
    "@typescript-eslint/eslint-plugin": "^6.7.3",
    "@typescript-eslint/parser": "^6.7.3",
    "babel-loader": "^9.1.3",
    "eslint": "^8.50.0",
    "eslint-plugin-react": "^7.33.2",
    "html-webpack-plugin": "^5.5.3",
    "ts-loader": "^9.4.4",
    "typescript": "^5.2.2",
    "webpack": "^5.88.2",
    "webpack-cli": "^5.1.4",
    "webpack-dev-server": "^4.15.1"
  },
  "dependencies": {
    "react": "^18.2.0",
    "react-dom": "^18.2.0"
  }
}