(Changelog) — Full Documentation
Victoria UI Kit is a style guide and UI pattern library providing base CSS, JavaScript and HTML markup required to build websites and applications affiliated with Victoria University of Wellington.
By building new web projects on top of this library, developers can quickly reuse out of the box layouts and UI components, gaining following advantages:
- Saving a lot of development time by not 'reinventing the wheel'
- Using code that has been extensively tested and conforms to the front end best practices
- Consistent 'Victoria look' (brand colours, paddings, typography, fonts and many more)
- New features, improvements and bug fixes with simple update (can be automated)
To use the UI Kit in your project(s), read the Style Guide.
If you want to contribute to the project by adding new features, enhancing existing ones or fixing bugs, it is good to do few things first:
- Read through the documentation - focus on sections Architecture & Layout to understand how is the library built and Components to know what's already included.
- If you're not sure how to contribute to a GitHub project, familiarise yourself with how it works first.
-
Fork off from dev branch.
-
To run the project on a local machine, execute the following command in the root directory of your fork:
npm start
This command will build the code, spawn a simple web server and automatically open the Style Guide in your default browser. Javascript, styles and templates are being 'watched' so any changes will instantly rebuild the project and live reload the browser.
-
Hack your feature/enhancement/fix.
-
Test your changes in all supported browsers.
-
Before pushing your branch run
gulp build-bridge --prod
This will rebuild the dist folder which we now use directly in squiz to serve the UIKIT via a gitbridge. -
Create a pull request into the dev branch. You can test the dev branch on the live site using the query string
?mode=dev
. -
Your pull request will be reviewed and tested - if everything is OK, merge into Master.
-
Feel good!
- Internet Explorer 10+ (no longer required)
- Safari 9+ (OS X and iOS only)
- Chrome 44+
- Firefox 42+
- Opera 39+ (desktop only)
NODE v10.16.3 can check the nvm file.
- jQuery 3.1+
- (only contributing developers) Node.js 5+ and npm 3+. Is currently broken using Node > 11. Recommend installing
n
and switching to node 11:
npm install -g n
sudo n 11
- (only contributing developers) Git 2+