core-layout

core-layout

A responsive AngularJS layout component for a simple, yet not completely trivial, Web-app layout that works well on both small (mobile) and larger screens. An important feature is its use of iScroll 5.x, through angular-iscroll, to support fixed-position headers and footers without using the CSS position: fixed formatting instruction which is not well supported on older Android (<= 4.1.2 ?) and iOS (<= 8.x) versions.

Install

Install the core-layout NPM package

# With NPM:
npm install --save core-layout
# With Yarn, which I prefer:
yarn add core-layout

Or, to check out a development version, start by cloning the repository, by

git clone [e-mail]:mtr/core-layout.git

Then, install the necessary dependencies:

cd core-layout/
yarn install    # Or: npm install

After that, you should have a dist directory with a subdirectory named lib:

dist/
├── lib
│   └── core-layout.js
└── scss
    ├── _core-drawers.scss
    ├── _core-modal.scss
    ├── _core-responsive.scss
    ├── _core.scss
    └── _core-variables.scss

Build

To rebuild the library, run

yarn build         # Or `yarn watch` (to rebuild on every file change).

To build the examples, run

yarn build-examples  # Or, `npm run-script build-examples`.

Demo

You may have a look at an Angular demo app that shows how you can use this core-layout module.

Building the Demo (examples/)

Please note that if you don't plan on changing the demo and testing new stuff, there's no need to compile it yourself; you can just visit the demo app.