Full Featured HTML Framework For Building iOS7 Apps
- 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 Grunt's server. Just run:
$ grunt server
- Kitchen Sink will be available on
http://localhost:3000/kitchen-sink/ - Dist - on
http://localhost:3000/dist/
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.
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 grunt to build a development (build) and dist versions.
First you need to have grunt-cli which you should install globally.
$ npm install -g grunt-cli
Then install all dependencies, in repo's root:
$ npm install
$ grunt build
The result is available in build/ folder.
After you have made build:
$ grunt dist
Distributable version will available in dist/ folder.
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:
$ grunt 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:
- accordion
- searchbar
- messages
- modals
- swipeout
- sortable
- smart-select
- pull-to-refresh
- infinite-scroll
- tabs
- fast-clicks
- forms (means Ajax forms and forms storage)
- push-state
- slider
- photo-browser
- notifications
All changes should be commited to src/ files. Framework7 uses LESS for CSS compliations, and concatenated JS files (look at Gruntfile.js for concat files order)
If you want to help in Framework7 development and make it event better visit this page: http://www.idangero.us/framework7/contribute/
If you have questions about Framework7 or want to help others you are welcome to special forum at http://www.idangero.us/framework7/forum/
Documentation available at http://idangero.us/framework7/docs/
Tutorials available at http://idangero.us/framework7/tutorials/
Appstore apps made with Framework7: http://idangero.us/framework7/showcase/