Skip to content
/ flux Public

Flux is a component library for Vue 3.x.

License

Notifications You must be signed in to change notification settings

basmilius/flux

Repository files navigation

Flux

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.

📦 Registry

  • The UI library package is available under @basmilius/flux.
  • The Dashboard library package is available under @basmilius/flux-dashboard.

⚠️ Requirements

  • 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.

🪵 Git

All commit messages and branches will be in English.

Branches

  • 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

Commit messages are bound to the following templates:

  • <type>: <message>
  • <type>(<feature>): <message>
  • <type>(<feature>): <message> [<issue-number>]

Examples

  • feat(expandable): adds header slot to expandable.
  • feat(expandable): adds header slot to expandable. [FLUX-123]
  • chore: adds vue 3 build target.