Share your code. npm Orgs help your team discover, share, and reuse code. Create a free org »

    adaptivejspublic

    Adaptive.js

    Framework for creating adaptive templated websites using Javascript

    NPM

    NPM version

    Full Documentation: http://adaptivejs.mobify.com/

    Getting Started

    Getting started with Adaptive.js development involves a few steps:

    1. Clone this repository
    2. Install dependencies
    3. Generate test project
    4. Link local adaptive.js repository to project
    5. Test your changes

    Download

    To begin, clone this repository. cd into your chosen folder, and run the following:

    npm install
    

    This will prepare your local adaptive.js environment for development.

    Install dependencies

    The following dependencies will need to be installed to preview your changes:

    These dependencies and their installation are described in greater detail in our Getting Started guide.

    Generate a test project

    Once you have installed the previous dependencies, download the Adaptive.js Generator using the following command:

    npm install -g generator-adaptivejs
    

    After installation of the generator has finished, create a new directory for your test project using the generator. Run the following to generate a new project:

    yo adaptivejs
    

    Answer the questions asked by the Yeoman generator to complete the process.

    Link your adaptive.js development environment

    To link your local Adaptive.js repository for use as a Node module within the test project, run the following:

    cd <your_adaptivejs_repo>
    npm link
    cd <your_test_project>
    npm link adaptivejs
    

    Now any changes you make to your repository will be reflected in your test project.

    Test Your Changes

    1. cd into your test project directory
    2. Run grunt preview
    3. Using a browser, navigate to http://preview.mobify.com
    4. In the 'Site URL' field, enter the website you want to adapt. NOTE: The site must have a Mobify tag installed.
    5. In the 'Bundle Location' field, enter http://localhost:8080/adaptive.js
    6. Press the 'Preview' button and you should see your test project adaptation

    Running The Tests

    To run tests in the terminal, run the following:

    grunt test
    

    To run your tests in the browser, run the following:

    grunt test_browser
    

    and browse to: http://localhost:8888/tests/

    Releasing

    When releasing a new version, follow these steps:

    1. Make sure all tests pass locally using grunt test.
    2. Make sure all tests pass on Saucelabs with grunt test_saucelabs.
    3. Bump version in package.json
    4. Add to CHANGELOG
    5. Create a new git tag corresponding to that version and push to origin.
    6. npm publish
    7. Update https://cloud.mobify.com/docs/adaptivejs/changelog/
    8. Update http://adaptivejs.mobify.com/docs/install/ with the latest recommended versions of Node, NPM, etc.

    Keywords

    none

    install

    npm i adaptivejs

    Downloadslast 7 days

    102

    version

    2.3.4

    license

    proprietary

    last publish

    collaborators

    • avatar
    • avatar
    • avatar