About
----Browser Matrix
----Mobile Matrix
----Technologies Used
----Architecture
Getting Started
----Prerequisites
----Setup
Development
----Branches
----Launch Development Mode
----Releasing Code
This is a boilerplate for building ES6 based projects. Its is very barebones with no frameworks or libraries.
OS | OS Version | Browser | Browser Version | Testing Type |
---|---|---|---|---|
Windows | 10 | Edge | 13+ (Latest) | Full |
Windows | - | IE | 11 | Full |
- | - | Firefox | 44+ (Latest) | Full |
- | - | Chrome | 48+ (Latest) | Full |
Device | OS | OS Version | Browser | Browser Version | Testing Type |
---|---|---|---|---|---|
IPhone | IOS | 9.2+ | Safari | - | Full |
IPad | IOS | 9.2+ | Safari | - | Full |
Galaxy S6/ Edge | Android | 5.1.1 | Chrome | - | Full |
Samsung S5 | Android | 5.0+ | Chrome | - | Full |
Here is a list of the frameworks, libraries and tools used to build this project:
Here is an overview of the project architecture:
Folder structure:
src/ <!-- Development source code-->
|- js/ <!-- components and main files -->
|- component/ <!-- component folder -->
|- style/ <!-- component style files -->
|- lib/ <!-- third-party library files -->
|- resource/ <!-- resources for the app such as images and fonts -->
|- image/ <!-- images -->
|- font/ <!-- fonts -->
dist/ <!-- Compiled code-->
test/ <!-- Test scripts -->
util/ <!-- for CLI -->
|- task/ <!-- modules for a task runner such as grunt -->
|- server/ <!-- node local server files -->
You are going to need:
This project has been built and tested on the following machines/systems:
- Windows 10
- Mac
- clone repo
- open
cmd
cd
into project folder- Run the following:
npm install
Branch | Description |
---|---|
develop | This branch is used for stable development source code and will be used to compile code for staging. |
staging | This branch is compiled code for staging servers. This code should be the compiled code from develop branch. |
uat | This branch is compiled code QA. |
master | This branch should be the source code deployed to the live environment. Do not merge into this branch unless you wish to deploy live. |
release | This branch will have the compiled source code from the master branch and will be the code deployed to the live environment |
documentation | This branch will be to store images and files for documentation |
Always create a branch from develop.
To create a feature branch, follow the naming convention below:
sprint-1/feature/feature-name
To create a bug-fix branch, follow the naming convention below:
sprint-1/bug-fix/bug-name
Run the following command to start developing and to stage the development environment
grunt
Please ensure all code is linted via the following command otherwise you cannot merge code to develop.
vccp-dev lint
You should only use the following command when merging to the develop
branch.
vccp-dev merge-to-develop
To release your code, use the following command:
vccp-dev release --prod --keep
###Flags
Please read the documentation for vccp-dev.
Name | Description |
---|---|
--uat | releases compiled code to the uat branch |
--prod | pushes development code to the master branch and releases compile to the release branch. A tag will be created. |