Skip to content
This repository

My attempt to implement Metro theme for jQuery Mobile

tree: a0a25813c7


Project aim is to build Metro UI HTML5-based theme on top of jQuery Mobile to mimic Windows Phone 7 native look and feel.

Live demo

Theme web version (doesn’t fully reflect the device experience)

Web demo for the site

Windows Phone demo app (restricted access)


Licensed under the Apache License, Version 2.0 (the "License");
you may not use this file except in compliance with the License.
You may obtain a copy of the License at

Unless required by applicable law or agreed to in writing, software
distributed under the License is distributed on an "AS IS" BASIS,
See the License for the specific language governing permissions and
limitations under the License.


Metro theme

Metro theme is presented by file and related images folder.


Additional plugins

All additional theme plugins are located at /plugins folder

/plugins/app-bar/ - Windows Phone alike ApplicationBar control

/plugins/date-picker/ - Date and Time picker. Note: if runs under Cordova environment and there is Cordova DateTimePicker
plugin then it uses native UI instead of html

/plugins/progress-bar/ - implements porgress bar control

/plugins/toggle-button/ - toggle button

** Each plugin folder contains sample page with usage example.

There is also special js code exporting theme switching functionality located at



The theme provides additional level of functionality when viewing on the phone under Cordova framework. This is implemented by the following cordova plugins.

backButtonHandler.js - hardware back button handling functionality

dateTimePicker.js - js bridge for Cordova native DateTimePicker

jquery.cordova.metro.themeswitcher.js - provides functionality to apply system colors (uses phoneTheme.js below)

phoneTheme.js - js bridge for Cordova system colors detection plugin


Demo pages for the site reference (official demo for other developers).


Windows Phone application based on Cordova framework to demonstrate all theme functionality (system colors, native UI elements). Does not contain any html pages inside, it uses absolute reference to test pages (see next section) located remotly.


Test pages

jQuery Mobile gallery sample page (with some little modifications). Contains both html version and windows phone native application.


This sample page demonstrates all metro theme additional plugins/controls descibed above ('Additional plugins' section). Html only verison.


Note. Pages above are used as a reference for Windows Phone demo application.

Prerequisite (Windows Phone only)

(No actions are required to run html samples and test pages.)

Silverlight for Windows Phone Toolkit is required to build


To run jqmobile demo

  1. Deploy to server the following directory (optional, you can run the demo from file system) /samples/jqm-public-demo/
  2. Navigate to (desktop or mobile browser) jqm-public-demo/index.html

To run gallery test pages

  1. Deploy to server the following directories (optional, you can run the demo from file system) /cordova /jqmobile-core /plugins /tests /themes
  2. Navigate to (desktop or mobile browser) /tests/basic/gallery/html/forms-all.html

To build Windows Phone demo app

  1. Open the following solution in Visual Studio /samples/WindowsPhone/MetroThemeDemoApp/MetroThemeDemoApp.sln
  2. Update CordovaView.StartPageUri (MainPage.xaml) to reference to /tests/basic/gallery/html/forms-all.html located remotly.
  3. Build
Something went wrong with that request. Please try again.