Intro to the Web App Template

You can find Part 2 of this tutorial, here. I’ve also compiled a list of great apps published with the WAT.


On Venture Capitalist Chris Dixon’s blog, he recently highlighted the decline of the mobile web.

People are spending more time on mobile vs desktop, and more of their mobile time using apps, not the web This is a worrisome trend for the web. Mobile is the future. What wins mobile, wins the Internet. Right now, apps are winning and the web is losing.

Moreover, there are signs that it will only get worse. Ask any web company and they will tell you that they value app users more than web users. This is why you see so many popups and banners on mobile websites that try to get you to download apps. It is also why so many mobile websites are broken. Resources are going to app development over web development. As the mobile web UX further deteriorates, the momentum toward apps will only increase.”

WAT Stats2

WAT Stats1


UPDATE: 7/18/14 – I’ve recently learned that this also works for Windows Phone 8 as well, with a new version of WAT supporting universal apps coming soon too.

I’ve been an advocate for HTML5 applications for some time now. In the past, I’ve given talks on cross platform HTML5 development, because I realize how valuable it can be to have your applications working on every platform, and built quickly. With that in mind, I’ve recently started working with Microsoft’s Web Application Template which is a “quick easy way to bring web content to native Windows 8 apps.”

I started tinkering with it the other night, and immediately saw how valuable it is. By changing one string, I was able to have my entire site, which you are reading now, wrapped inside of a Windows 8 application, with full support for native functionality. I could easily share all of my pages via the charms bar, to social networks like Facebook, Twitter, and Mail.

The beauty behind the Web App Template is that a majority of the appearance for your site can be done by tinkering with a simple configuration file.

Getting Started

The template docs include an excellent getting started page, which I recommend as your first stop when building this application.

Once I finished those instructions, I created a new projected called WAT-Sample. In the config folder I opened the config.json file, and immediately saw “homeURL:” at the top of the page. By switching that URL to my own,, I was able to have my website wrapped as a Windows 8 app. Press the debug button (F5, or the green triangle that says “Local Machine”) and you can see exactly what it looks like.


Editing the Config.JSON file, to change which site the app points at

With that done, I had my app up and running, and the ability to share natively with the charms bar.


I can easily share pages within my app, all with Win8’s charms bar

Adding More Features

The app doesn’t do much now, but if I right-click, I’m able to see a pull down menu with the links that I want to the user to be able to navigate to.


The header links aren’t what I want them to be yet

This is where I’d like to change the links that I want the user to see. Right now, they are the default links for the WAT docs, but I want each link to point toward a different topic for the student. This can be done in the config.json file again, under the section marked “navBar:”

Changing “label:” adjusts the text for what thee users sees. (ie – home, JSON Reference, About WAT). The “icon:” obviously changes the icon,  and a list of available icons is at Leave this blank to omit the icon. Finally, change the “action:” so that it points toward the URL you want the user to navigate to when the button is clicked.

I plan on adjusting these so that they read: “Unity” “Talks” “HTML5” and “Resources” in the near future.


Practical Uses

If you are just going to wrap your website using the template, and not add any new functionality or way or organizing your content, then this tool is probably not very useful for your customer. I took a step back, considered who I work with the most, figured how this could be useful for them. In my case, it is students. I’m always fielding requests for how to find tutorials on Unity, or Unreal, or HTML5 development, so I thought “why not put together a simple app that organizes all of my web content, in one easy to find location?”

Sure, my whole site is wrapped, but the links in my header are removed, and instead are replaced with content which is only relevant to the students. DreamSpark, Unity tutorials, and entry level programming tips. Simplicity is key, when putting together content that a large number of people will ingest. The more options I give them to navigate, the less likely that they are to ever find what they are looking for.

Now, when I give a talk at a school, I can point them towards my Windows 8 app, which aggregates all of the content on my site, relevant to exactly what they are looking for, while removing any of the fluff that they would not find useful.

 Additional Resources



9 thoughts on “Intro to the Web App Template

  1. Pingback: Intro to the Web App Template | 42 base 13

  2. Pingback: DreamSpark is FREE for students right now, and you can win Xbox One | Dave Voyles | Tech Evangelist at Microsoft

  3. Pingback: Finishing the Web App template | Dave Voyles | Tech Evangelist at Microsoft

  4. Will this work with Windows Phone 8.1? How?
    If not, other tools / methods (Microsoft or even non-Microsoft)? Thank you very much.

    • At the moment, this seems to only create a Win8 app, and not Windows Phone. I can contact the team today though, and find out if there are plans in the future to integrate phone functionality, and post back here with my findings.

    • I’ve updated the story.

      There is already a WAT template for WP8 that can be downloaded from:

      There is a new version of WAT supporting universal apps coming soon too. Let me know if there is anything more that I can do to help. I also have some examples that I will post, shortly.

  5. Pingback: Examples of apps published with the Web App Template

  6. Pingback: Examples of apps published with the Web App Template - Dave Voyles for gaming, HTML5, and Xbox - Site Home - MSDN Blogs

  7. Pingback: Finishing the Web App template - Dave Voyles for gaming, HTML5, and Xbox - Site Home - MSDN Blogs

Leave a Reply

This site uses Akismet to reduce spam. Learn how your comment data is processed.