본문 바로가기

Frontend Development/Vue.js

[Vue.js] vue 용 Storyboard 설치하기

Vue로 화면 개발을 할때 현재 만든 컴포넌트의 기능과 모양을 테스트 하려면 전체 서버를 띄워야 한다. 그러니 Storyboard 툴을 사용하면 툴에서 Vue 컴포넌트를 인식해서 웹 브라우저에서 컴포넌트 단위로 동작 및 모양 확인을 할 수 있다.

storybook 실행 모습

 

Storyboard를 설치하기 위해서는 vue cli를 통해 프로젝트 구조를 만들어야 한다.

 

다음과 같이 기본적인 Application틀을 만든다.

 

npm install -f @vue/cli-init@3.0.1
vue init webpack kanban-app

 

 

그리고 새로 만들어진 kanban-app으로 들어가서 아래 명령으로 storybook을 설치한다.

 

npx -p @storybook/cli sb init --type vue

 

설치가 완료후 storybook실행은 다음과 같다

 

npm run storybook

 

run을 했으나 실행에러가 나면 package 간의 디펜던시 에러일 가능성이 크다. 위와 같이 storybook 을 설치하면 최신버전의 storybook을 설치하게 됨에 따라 현재 사용하고 있는 application의 bable package들이 이전 버전이면 실행 에러가 날 수 있다.

 

package.js에서 아래와 같이 기존 라이브러리 버전을 올려 주니 실행이 되었다.

그리고 실행시 storybook/addon-docs이 없다고 명시적으로 에러가 나와서 이역시 추가를 하였다.

 

 "devDependencies": {
    "@storybook/addon-actions": "^6.4.19",
    "@storybook/addon-docs": "^6.4.19",
    "@storybook/addon-essentials": "^6.4.19",
    "@storybook/addon-links": "^6.4.19",
    "@storybook/vue": "^6.4.19",
    "@vue/test-utils": "^1.0.0-beta.24",
    "autoprefixer": "^7.1.2",
    "babel-core": "^7.0.0-beta.3",
    "babel-eslint": "^8.2.1",
    "babel-helper-vue-jsx-merge-props": "^2.0.3",
    "babel-loader": "^8.0.0",
    "babel-plugin-istanbul": "^4.1.1",
    "babel-plugin-syntax-jsx": "^6.18.0",
    "babel-plugin-transform-runtime": "^7.0.0-beta.3",
    "babel-plugin-transform-vue-jsx": "^3.7.0",
    "babel-preset-env": "^7.0.0-beta.3",
    "babel-preset-stage-2": "^7.0.0-beta.3",
    "babel-register": "^7.0.0-beta.3",
    "babel-runtime": "^7.0.0-beta.3",

 

package.js전체 내용

더보기

{
  "name": "kanban-app",
  "version": "1.0.0",
  "description": "A Vue.js project",
  "author": "MS <skkkms@naver.com>",
  "private": true,
  "scripts": {
    "dev": "webpack-dev-server --inline --progress --config build/webpack.dev.conf.js",
    "start": "npm run dev",
    "unit": "cross-env BABEL_ENV=test karma start test/unit/karma.conf.js --single-run",
    "e2e": "node test/e2e/runner.js",
    "test": "npm run unit && npm run e2e",
    "lint": "eslint --ext .js,.vue src test/unit test/e2e/specs",
    "build": "node build/build.js",
    "storybook": "start-storybook -p 6006",
    "build-storybook": "build-storybook"
  },
  "dependencies": {
    "axios": "^0.18.0",
    "es6-promise": "^4.2.5",
    "vue": "^2.5.2",
    "vue-router": "^3.0.1",
    "vuedraggable": "^2.17.0",
    "vuex": "^3.0.1"
  },
  "devDependencies": {
    "@storybook/addon-actions": "^6.4.19",
    "@storybook/addon-docs": "^6.4.19",
    "@storybook/addon-essentials": "^6.4.19",
    "@storybook/addon-links": "^6.4.19",
    "@storybook/vue": "^6.4.19",
    "@vue/test-utils": "^1.0.0-beta.24",
    "autoprefixer": "^7.1.2",
    "babel-core": "^7.0.0-beta.3",
    "babel-eslint": "^8.2.1",
    "babel-helper-vue-jsx-merge-props": "^2.0.3",
    "babel-loader": "^8.0.0",
    "babel-plugin-istanbul": "^4.1.1",
    "babel-plugin-syntax-jsx": "^6.18.0",
    "babel-plugin-transform-runtime": "^7.0.0-beta.3",
    "babel-plugin-transform-vue-jsx": "^3.7.0",
    "babel-preset-env": "^7.0.0-beta.3",
    "babel-preset-stage-2": "^7.0.0-beta.3",
    "babel-register": "^7.0.0-beta.3",
    "babel-runtime": "^7.0.0-beta.3",
    "body-parser": "^1.18.3",
    "chai": "^4.3.4",
    "chalk": "^2.0.1",
    "chromedriver": "^98.0.0",
    "copy-webpack-plugin": "^4.0.1",
    "cross-env": "^5.0.1",
    "cross-spawn": "^5.0.1",
    "css-loader": "^0.28.11",
    "eslint": "^4.15.0",
    "eslint-config-standard": "^10.2.1",
    "eslint-friendly-formatter": "^3.0.0",
    "eslint-loader": "^1.7.1",
    "eslint-plugin-import": "^2.7.0",
    "eslint-plugin-node": "^5.2.0",
    "eslint-plugin-promise": "^3.4.0",
    "eslint-plugin-standard": "^3.0.1",
    "eslint-plugin-storybook": "^0.5.6",
    "eslint-plugin-vue": "^4.7.1",
    "extract-text-webpack-plugin": "^3.0.0",
    "file-loader": "^1.1.4",
    "friendly-errors-webpack-plugin": "^1.6.1",
    "html-webpack-plugin": "^2.30.1",
    "inject-loader": "^3.0.0",
    "karma": "^6.3.16",
    "karma-chrome-launcher": "^3.1.0",
    "karma-coverage": "^1.1.1",
    "karma-mocha": "^1.3.0",
    "karma-phantomjs-launcher": "^1.0.2",
    "karma-phantomjs-shim": "^1.4.0",
    "karma-sinon-chai": "^2.0.2",
    "karma-sourcemap-loader": "^0.3.7",
    "karma-spec-reporter": "0.0.31",
    "karma-webpack": "^2.0.2",
    "mocha": "^3.2.0",
    "nightwatch": "^0.9.12",
    "node-notifier": "^5.1.2",
    "optimize-css-assets-webpack-plugin": "^3.2.0",
    "ora": "^1.2.0",
    "phantomjs-prebuilt": "^2.1.14",
    "portfinder": "^1.0.13",
    "postcss-import": "^11.0.0",
    "postcss-loader": "^2.0.8",
    "postcss-url": "^7.2.1",
    "puppeteer": "^13.3.1",
    "rimraf": "^2.6.0",
    "selenium-server": "^3.0.1",
    "semver": "^5.3.0",
    "shelljs": "^0.7.6",
    "sinon": "^4.0.0",
    "sinon-chai": "^2.8.0",
    "uglifyjs-webpack-plugin": "^1.1.1",
    "url-loader": "^0.5.8",
    "vue-loader": "^15.9.8",
    "vue-style-loader": "^3.0.1",
    "vue-template-compiler": "^2.5.2",
    "webpack": "^3.6.0",
    "webpack-bundle-analyzer": "^2.9.0",
    "webpack-dev-server": "^2.9.1",
    "webpack-merge": "^4.1.0"
  },
  "engines": {
    "node": ">= 6.0.0",
    "npm": ">= 3.0.0"
  },
  "browserslist": [
    "> 1%",
    "last 2 versions",
    "not ie <= 8"
  ]
}

 

또한 프로젝트가 이전 버전일 경우 vue 실행 시 VueLoaderPlugin가 없다고 실행이 안되는 경우가 있다. 이럴때는 아래 webpack.base.js에서 VueLoaderPlugin을 지정해주면 된다.

 

build/webpack.base.conf.js:3

 

const { VueLoaderPlugin } = require("vue-loader");

..


plugins: [
new VueLoaderPlugin()
]