Created: 2014-05-19 08:43
Updated: 2014-06-07 08:04
License: mit


Plugin to create fancy landing page with a QR code for ios and android apps (Coming soon)

Getting Started

This plugin requires Grunt ~0.4.4 TODO: Currently only provides landing page for iOS applications, android support to added soon.

Alt text

If you haven't used Grunt before, be sure to check out the Getting Started guide, as it explains how to create a Gruntfile as well as install and use Grunt plugins. Once you're familiar with that process, you may install this plugin with this command:

npm install grunt-vc-apprepo --save-dev

Once the plugin has been installed, it may be enabled inside your Gruntfile with this line of JavaScript:


The "apprepo" task


In your project's Gruntfile, add a section named vc_apprepo to the data object passed into grunt.initConfig().

  apprepo: {
    options: {
        title           : 'Some page title',                                    // added page title for the landing page
        http_url        : 'http://dc.ios.localhost/',                           // URL where the file will be hosted, to be used in the template/manifest.plist file
        repo_path       : '/home/rp/repo-generator/repo-generator',             // path of the git repo
        output_path     : '/var/www/apps/',                                     // where the html files need to be generated
        branch          : 'master',                                             // which branch to look at to read the log files
        app_name        : 'Digital App',                                        // Name of the app
        bundle_id       : 'com.geo.bla',                                        // iOS bundle id
        platform        : 'ios',                                                // platform current only iOS supported
        app_description : 'Brief description of the application would go here'  // description of the app

Usage Examples

syntax: apprepo:::::

  • name of the app: assuming that the file is going to be placed in the same level the manifest.plist file
  • version-of-app: is the version in the ios app
> grunt apprepo:build1234:60a3dea9:7410837d:my-app-2.0.0+build1234.ipa:2.0.0+build1234
Running "apprepo:build1234:60a3dea9:7410837d" (apprepo) task
Found the following change logs
74108 - fixed the foreach issue with the commit log (
78ded - fixed changelogs issue if none were found (
3a830 - added the build id to the path as well (
483e6 - added a readme file (
6ed28 - fixed broken css links, updated path to load over ssl (
Wrote updated landing page at /var/www/apps/index.html
Wrote updated manifest file at /var/www/apps/manifest.plist


In lieu of a formal styleguide, take care to maintain the existing coding style. Add unit tests for any new or changed functionality. Lint and test your code using Grunt.

Release History

  • Added support for android
Cookies help us deliver our services. By using our services, you agree to our use of cookies Learn more