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


    App Layout Build Status Published on

    A collection of elements, along with guidelines and templates that can be used to structure your app’s layout.

    <app-header reveals>
        <paper-icon-button icon="menu" onclick="drawer.toggle()"></paper-icon-button>
        <div main-title>My app</div>
        <paper-icon-button icon="delete"></paper-icon-button>
        <paper-icon-button icon="search"></paper-icon-button>
        <paper-icon-button icon="close"></paper-icon-button>
        <paper-progress value="10" indeterminate bottom-item></paper-progress>
    <app-drawer id="drawer" swipe-open></app-drawer>
    <sample-content size="10"></sample-content>


    $ bower install PolymerElements/app-layout --save


    <link rel="import" href="/bower_components/app-layout/app-layout.html">

    What is inside


    • app-box - A container element that can have scroll effects - visual effects based on scroll position.

    • app-drawer - A navigation drawer that can slide in from the left or right.

    • app-drawer-layout - A wrapper element that positions an app-drawer and other content.

    • app-grid - A helper class useful for creating responsive, fluid grid layouts using custom properties.

    • app-header - A container element for app-toolbars at the top of the screen that can have scroll effects - visual effects based on scroll position.

    • app-header-layout - A wrapper element that positions an app-header and other content.

    • app-toolbar - A horizontal toolbar containing items that can be used for label, navigation, search and actions.


    The templates are a means to define, illustrate and share best practices in App Layout. Pick a template and customize it:


    Sample code for various UI patterns:

    • Transform navigation: As more screen space is available, side navigation can transform into tabs. (Demo - Source)

    • Expand Card: Content cards may expand to take up more horizontal space. (Demo - Source)

    • Material Design Responsive Toolbar: Toolbar changes its height and padding to adapt mobile screen size. (Demo - Source)


    Here are some web apps built with App Layout:

    Tools and References

    Changes in App Layout 2.0

    • Distribution is now done with slots, so things have changed because of that,

      ##### app-drawer-layout 1.x



        <app-drawer slot="drawer">...</app-drawer>

      ##### app-header-layout 1.x



        <app-header slot="header">...</app-header>

      ##### app-box 1.x

      <app-box effects="...">
        <img background ...>


      <app-box effects="...">
        <img slot="background" ...>
    • In app-drawer-layout, the drawer-toggle element needs to be manually hidden when app-drawer-layout is not in narrow layout. To add this, add the following CSS rule where app-drawer-layout is used:

      app-drawer-layout:not([narrow]) [drawer-toggle] {
        display: none;
    • In app-drawer-layout, if you specify a value for --app-drawer-width, that value must be accessible by both app-drawer and app-drawer-layout. This can be done by defining the value on the :host that contains (or html if outside a shadow root):

      :host {
        --app-drawer-width: 300px;
    • app-scrollpos-control has been removed from App Layout in favor of using multiple scrolling regions to preserve the scroll position. In terms of UX, document.rootScroller is a new web platform API that will allow non-document scroll to hide the address bar on mobile.




    npm i @polymer/app-layout

    Downloadsweekly downloads








    last publish


    • avatar
    • avatar
    • avatar
    • avatar
    • avatar
    • avatar
    • avatar