by 2gis

2gis / makeup

JavaScript tool for comfortable manual testing of markup

450 Stars 43 Forks Last release: Not found Mozilla Public License 2.0 236 Commits 1 Releases

Available items

No Items, yet!

The developer of this repository has not created any items for sale yet. Need a bug fixed? Help with integration? A different license? Create a request here:

English | Русский

Makeup logo

Build Status Gitter

What Is Makeup?

Makeup is a tool for development and comfortable quality assurance of markup on web projects. You'll certainly find it useful if your design is based on independent blocks and you prioritize stability and reliability.

Makeup is a JavaScript library. It provides visual interface for isolated development and quick manual regression testing of web pages, built from independent blocks.

Check out the interactive Makeup promotion site!

Why Should I Use Makeup?

Makeup allows you to:

  • Compare page design with the sample layout,
  • Monitor blocks for modifications and mismatching content,
  • Develop isolated blocks with ease.


Features of Makeup can be seen on the Makeup demo page.

Examples can be found in the demo/ subfolder. Just open any

file in your browser.

Keyboard Shortcuts

Makeup has convenient keyboard shortcuts – see the cheatsheet.

How Do I Use Makeup?

Makeup Express

Express version of Makeup can be launched on any website except those with HTTP header

. To use it, run the following script from the developer tools console of your browser:
var s=document.createElement('script');
s.src ="//";

Quick Start With Makeup

  1. Make a web page with all resourses of your page's layout (markup, styles and images):

    <link rel="stylesheet" href="style.css"> <!-- project styles -->
    <button class="button">My button</button> <!-- markup -->

  2. Link the Makeup script and styles files to your page:


    <link rel="stylesheet" href="style.css">
    <script src="makeup.js"></script><!-- Makeup -->
    <link rel="stylesheet" href="makeup.css"> <!-- Makeup styles -->

    <div style="display: none;">
        <button class="button">My button</button>

  1. Initialize the Makeup

    Makeup(params, templating);

    See the full reference on initialization data format.


You are welcome to take part in the development of Makeup. To start working, follow the instruction:

  1. Make sure that you have nodejs, npm and gulp installed.

  2. Fork this repository and clone your fork:

    git clone [email protected]:<your_name>/makeup.git
    cd makeup

    To commit your contribution, make a pull request (use the GitHub Flow).

    You can also clone this repository directly, but then you won't be able to push to it or make pull requests:

    git clone [email protected]:2gis/makeup.git
    cd makeup
  3. Launch Makeup with

    npm i
    npm start

    Demo page will then be available at http://localhost:3333/demo.


Makeup is published under the Mozilla Public License, version 2.0.


A project named "node-makeup" had been published in npm under the name "makeup" till 23.10.2015. You can find it at defunctzombie/node-makeup.

We use cookies. If you continue to browse the site, you agree to the use of cookies. For more information on our use of cookies please see our Privacy Policy.