This repository contains the source code for the basic components that are used throughout our front-end projects. It targets Vue 3+. Please read the following instructions and checks in order to proceed.
- The UI library package is available under
@basmilius/flux
. - The Dashboard library package is available under
@basmilius/flux-dashboard
.
- Install Node.js ^22
- Install pnpm using
npm i -g pnpm
. - Configure a new environment variable
FONTAWESOME_NPM_AUTH_TOKEN
. This should be a valid Font Awesome private npm auth token. - Use
pnpm install
to install the required packages. - Use
pnpm dev
to start a build watcher for both targets. - Use
pnpm build
to build a production bundle. - Use
pnpm link
to link the dist folder of flux to your global node_modules.
All commit messages and branches will be in English.
- Main — Contains the latest stable release and is the exact source that is running in production.
- Develop — Contains the latest staging release that is marked for deployment and is the exact source that is running on staging.
- Feature branches — Any feature should have its own feature branch. Once complete, the branch should be merged into the develop branch and the feature branch should be deleted.
- Bugfix branches — When a bug is found, it should be fixed within a bugfix branch. Once complete the branch should be merged into the develop branch and the feature branch should be deleted.
Commit messages are bound to the following templates:
<type>: <message>
<type>(<feature>): <message>
<type>(<feature>): <message> [<issue-number>]
feat(expandable): adds header slot to expandable.
feat(expandable): adds header slot to expandable. [FLUX-123]
chore: adds vue 3 build target.