Framework7 0,15,19,0,13,15,0,24 travis-ci Bower Packagist gulp npm

Full featured HTML framework for building iOS & Android apps

Join the chat at Build Status devDependency Status


Full Featured Mobile HTML Framework For Building iOS & Android Apps

Getting Started

  • Getting Started Guide
  • Clone/download this repo
  • Start building your App from changing Kitchen Sink, or from a clean template from dist/ folder


Because Framework7 uses Ajax for navigation between pages you will need a server. So to make it work you should put dist folder (or Kitchen Sink) on a server. Or, as an option, you may use Gulp’s server. Just run:

$ gulp server
  • Kitchen Sink will be available on http://localhost:3000/kitchen-sink/
  • Dist - on http://localhost:3000/dist/

Kitchen Sink

Framework7’ JS and CSS files in Kitchen Sink are temporary linked to build/ to make development process easier on this stage. So to make it work you need to build Framework7 (see Build section) or to re-link JS and CSS files to dist/ folder.

Dist vs Build versions

On production use files (JS and CSS) only from dist/ folder, there will be the most stable versions, build/ folder is only for development purpose


Framework7 uses gulp to build a development (build) and dist versions.

First you need to have gulp-cli which you should install globally.

$ npm install --global gulp

Then install all dependencies, in repo’s root:

$ npm install

And build development version of Framework7:

$ gulp build

The result is available in build/ folder.


After you have made build:

$ gulp dist

Distributable version will available in dist/ folder.

Custom build

You can build custom version of Framework7 with only required components/modules. For example, if we need to include only Accordion, Modals and Tabs modules in addition to Framework 7 core:

$ gulp custom -accordion,modals,tabs

After that you will find created custom/ folder with generated JS and CSS files. Here is the list of available additional modules:

  • cards
  • accordion
  • searchbar
  • messages
  • modals
  • swipeout
  • sortable
  • smart-select
  • virtual-list
  • pull-to-refresh
  • infinite-scroll
  • scroll-toolbars
  • tabs
  • fast-clicks
  • forms (means Ajax forms and forms storage)
  • push-state
  • swiper
  • photo-browser
  • picker
  • calendar
  • notifications


All changes should be commited to src/ files. Framework7 uses LESS for CSS compliations, and concatenated JS files (look at gulpfile.js for concat files order)

The project uses .editorconfig to define the coding style of each file. We recommend that you install the Editor Config extension for your preferred IDE.

If you want to help in Framework7 development and make it event better visit this page:


If you have questions about Framework7 or want to help others you are welcome to special forum at


Documentation available at


Tutorials available at


Appstore apps made with Framework7:

Related Repositories



Full featured HTML framework for building iOS & Android apps ...



此项目已经不再维护,请不要使用。可以选择 SUI-Mobile(MSUI) ...



A plugin for Framework7 that displays a swipeable welcome screen to guide the user through a tutorial ...



Framework7 components built with Vue.js ...



A template for Framework7 based on Angular with pure HTML5, CSS3 and JS ...

Top Contributors

nolimits4web ptb gregkeys MarcGodard johnjamesjacoby twss leecrossley boynet gordol gagustavo Strate roshanca Tarekajaj pleshevskiy KLVN andykog irfanevrens fouber SniperGER Dr1ks bitdeli-chef crazyurus DGivney BelinChung caiiiycuk aries1980 jimbobbennett Edrem kozmanbalint EmilioBravo


package version
dev dom7 ^1.6.3
gulp ^3.9.1
gulp-clean-css ^2.2.2
gulp-concat ^2.6.1
gulp-connect ^5.0.0
gulp-header ^1.8.8
gulp-jade ^1.1.0
gulp-jshint ^2.0.4
gulp-less ^3.3.0
gulp-open ^2.0.0
gulp-rename ^1.2.2
gulp-sourcemaps ^2.2.1
gulp-tap ^0.1.3
gulp-uglify ^2.0.0
jshint ^2.9.4
jshint-stylish ^2.2.1
rollup-plugin-buble ^0.15.0
rollup-stream ^1.19.0
template7 ^1.2.3
vinyl-buffer ^1.0.0
vinyl-source-stream ^1.1.0


-   v1.4.2 zip tar
-   v1.4.0 zip tar
-   v1.3.5 zip tar
-   v1.3.1 zip tar
-   v1.3.0 zip tar
-   v1.2.0 zip tar
-   v1.0.7 zip tar
-   v1.0.6 zip tar
-   v1.0.5 zip tar
-   v1.0.4 zip tar
-   v1.0.3 zip tar
-   v1.0.2 zip tar
-   v1.0.1 zip tar
-   v1.0.0 zip tar
-   v0.10.0 zip tar
-   v0.9.9 zip tar
-   v0.9.8 zip tar
-   v0.9.7 zip tar
-   v0.9.6 zip tar
-   v0.9.5 zip tar
-   v0.9.4 zip tar
-   v0.9.3 zip tar
-   v0.9.2 zip tar
-   v0.9.0 zip tar
-   v0.8.8 zip tar
-   v0.8.7 zip tar
-   v0.8.6 zip tar
-   v0.8.5 zip tar
-   v0.8.4 zip tar
-   v0.8.2 zip tar