xhlv / onsenui

Web Component inspired HTML5 UI framework for building modern mobile application

Onsen UI

Onsen UI is an HTML5 UI framework for building modern mobile applications.

Onsen UI makes building applications simple basing on the concept of Web Components. Applications can be build using HTML tags web developers already know. It is built on top of heroic AngularJS and performance craving Topcoat.

Monaca IDE fully supports Onsen UI plugin.

Demo

Click Here to see Onsen UI in action!

Getting Started Using Monaca

See the Onsen UI Getting Started Page.

How to build

• Clone with submodule

    git clone https://github.com/monaca/OnsenUI.git --recursive
  

• Open the terminal from OnsenUI directory

    cd OnsenUI
  

• Install dependencies using npm

    npm install
  

• Install grunt-cli (globally)

    [sudo] npm install -g grunt-cli
  

• Type grunt to start building

    grunt
  

The files will be built and copied into build, demo/lib/onsen/, and app/lib/onsen/ folder.

Running Demo

• Run script

    scripts/web-server.js
  

• Then navigate your browser to http://localhost:8000/demo/index.html

Developing your app

Monaca IDE makes it super easy to create Onsen UI project, but if you want to use other IDEs, we provide a template in app folder for you to get started.

• Running the app by running the script

    scripts/web-server.js
  

• Then navigate your browser to http://localhost:8000/app/index.html

Documentation

See the current Onsen UI docs.

Contributing

• Fill out the CLA here
• Fork the repo
• Commit your changes
• Make a pull request

Getting support

Ask a question using the "Onsen-UI" tag in Monaca Forum.