Insig UI Library

This Component Library is a collection of Vue UI components for use in the development of Insig applications. It was built with the intention of hastening development times, enabling reusability and to provide clarity for compositional decisions.

Prerequisites

This project requires NodeJS (16.3.0 or later) and NPM (7.15.1 or later).

To make sure you have these versions available on your machine, try running the following command.

$ npm -v && node -v
7.15.1
v16.3.0

Table of contents

• Insig UI Library
  • Prerequisites
  • Table of contents
  • Getting Started
  • Installation
  • Usage
    • Serving the UI Library 'kitchen sink'
    • Building a package distribution version
    • Serving the distribution version
  • Contributing
  • Built With
  • Authors
  • License

Getting Started

These instructions will get you a copy of the project up and running on your local machine for development and testing purposes. See deployment for notes on how to deploy the project on a live system.

Installation

BEFORE YOU INSTALL: please read the prerequisites

Start with cloning this repo on your local machine:

$ git clone https://InsigTechnologies@dev.azure.com/InsigTechnologies/Insig%20UI%20Library/_git/insig-ui-library
$ cd insig-ui-library

To install and set up the library, run:

$ ./workspaces.install.sh

Note If you have issues with workspaces, please ensure you are using the correct versions of NodeJS and NPM

Usage

Serving the UI Library 'kitchen sink'

$ npm run complib:dev

Building a package distribution version

$ npm run complib:build

Note If you have issues with TSC module not found, please blow away node_modules and perform a clean install

This task will create a distribution version of the project inside your local packages/complib/dist/ folder

Publishing the distribution version

Note Before publishing please be sure to increment the version number correctly in packages/complib/package.json

$ npm run complib:publish

Note If you have issues with NPM authentication please ensure your project contains a valid .npmrc file with a valid token

Note this requires Building a package distribution version first.

Contributing

Please see documentation within the Storybook instance related to contribution specifics

1. Fork it!
2. Create your feature branch: git checkout -b my-new-feature
3. Add your changes: git add .
4. Commit your changes: git commit -am 'Add some feature'
5. Push to the branch: git push origin my-new-feature
6. Submit a pull request 😎

Built With

• Vue 3
• Vite
• NPM Workspaces
• PrimeVue
• Sass
• Typescript

Authors

• Sam Barnett - Initial work
• Blake Simpson - Monorepo, packaging and components
• John Capt - Storybook documentation

License

TODO Add license