mirror of
https://github.com/IT4Change/boilerplate-frontend.git
synced 2025-12-13 07:35:53 +00:00
5.6 KiB
5.6 KiB
boilerplate-frontend
The IT4C Boilerplate for frontends
Requirements & Technology
To be able to build this project you need nodejs, npm and optional docker.
The project uses vite as builder, vike to do the SSR. The design framework is vuetify which requires the frontend framework vue3. For localization vue-i18n is used; Session storage is handled with pinia.
Testing is done with eslint and vitest.
This projects utilizes storybook to develop frontend components.
Commands
The following commands are available:
| Command | Description |
|---|---|
npm install |
Project setup |
npm run build |
Compiles and minifies for production |
npm run server:prod |
Runs productions server |
| Develop | |
npm run dev |
Compiles and hot-reloads for development |
npm run server:dev |
Run development server |
| Test | |
npm run test:lint |
Run all linters |
npm run test:unit |
Run all unit tests in watch mode |
npm run test:unit:coverage |
Run all unit tests and generate coverage report |
npm test |
Run all tests & linters |
| Storybook | |
npm run storybook |
Run Storybook |
npm run storybook:build |
Build static storybook |
Docker
Docker can be run in development mode utilizing docker-compose.overwrite.yml:
docker compose up
Docker can be run in production mode:
docker compose -f docker-compose.yml up
Endpoints
The following endpoints are provided given the right command is executed:
| Endpoint | Description |
|---|---|
| http://localhost:3000 | The webfrontend |
| http://localhost:6006 | Storybook |
TODO
- vite
- vike
- vue3
- vuetify
- pinia store
- storybook
- eslint
- vitest
- vue-i18n
- docker
- figma
- chromatic
- documentation?
- github actions
Known Problems
Currently none