UPGRADING.md

Upgrading Projects from v2.x to v3.0

The following guide will describe the steps needed to take a project generated using v2 of the generator and enable it for use with v3.0.

The new v3.0 generator has moved some files, made small changes how script tags and @import statements are injected, and offers users the ability to create a completely custom directory structure. To convert a v2 project to v3.0, do the following:

1. Rename and move js/setup.js to app.js. Modify the related script tag in index.html.
2. Move css/app.less to app.less. Modify the related link tag in index.html.
3. In app.less, modify the existing @import statements and remove the ../ from the beginning of the @import statements for all partial and directive less files.
4. In app.less, combine the two comment-separated sections for partial and directive less into one section. Modify the bottom comment marker of this section to be /* Add Component LESS Above */.
5. In index.html, combine the 4 comment-separated sections for component script tags (for partials, directives, services, filters) into one section. Modify the bottom comment marker of this section to be <!-- Add New Component JS Above -->.
6. Overwrite your existing Gruntfile.js with the content from Gruntfile.js. Do a find and replace and search for <%%= and replace with <%=.
7. Upgrade the grunt-dom-munger task by doing npm install grunt-dom-munger@3.4 --save-dev.
8. Create a .yo-rc.json file in the project root with the following content:

{
    "generator-cg-angular": {
        "uirouter": false,
        "partialDirectory": "partial/",
        "directiveDirectory": "directive/",
        "serviceDirectory": "service/",
        "filterDirectory": "filter/",
        "inject": {
            "js": {
                "file": "index.html",
                "marker": "<!-- Add New Component JS Above -->",
                "template": "<script src=\"<%= filename %>\"></script>"
            },
            "less": {
                "file": "app.less",
                "marker": "/* Add Component LESS Above */",
                "template": "@import \"<%= filename %>\";"
            }
        }
    }
}

Upgrading from v3.0 to v3.1

1. Modify your .yo-rc.json file to look like the following. The only changes are in the less section. They are the new relativeToModule property and the updated file value.

{
    "generator-cg-angular": {
        "uirouter": false,
        "partialDirectory": "partial/",
        "directiveDirectory": "directive/",
        "serviceDirectory": "service/",
        "filterDirectory": "filter/",
        "inject": {
            "js": {
                "file": "index.html",
                "marker": "<!-- Add New Component JS Above -->",
                "template": "<script src=\"<%= filename %>\"></script>"
            },
            "less": {
                "relativeToModule": true,
                "file": "<%= module %>.less",
                "marker": "/* Add Component LESS Above */",
                "template": "@import \"<%= filename %>\";"
            }
        }
    }
}

2. Modify your app.js file. The v3.1 generator does not generate the chained calls to $routeProvider. Please update the app.js so that the contents of the config method call look something like:

    /* Add New Routes Above */
    $routeProvider.otherwise({redirectTo:'/home'});

Notice that there is now no beginning "$routeProvider." above the comment marker. The new generator will inject full statements w/o chaining. For example:

    $routeProvider.when('route',{templateUrl:'partial.html'});
    $routeProvider.when('route2',{templateUrl:'partial2.html'});
    $routeProvider.when('route3',{templateUrl:'partial3.html'});
    /* Add New Routes Above */
    $routeProvider.otherwise({redirectTo:'/home'});