Welcome to gah!

gah provides tooling for working with decentralized, modular angular applications.

Features

✅ Intuitive CLI for configuring modules, hosts, dependencies, plugins and more ✅ Works with angular-CLI but is not strictly dependent on it ✅ Generates a generic host for you ✅ CI Support ✅ Reload on save features fully supported for all dependencies ✅ Pluggable: Write your own plugins to add project-specific functionality ✅ Use from code: Run all the commands from nodeJS scripts or from build tools like grunt

Upcoming

???? Multi-Repository Support

Getting started

gah can be used both as a CLI tool and integrated into your node scripts or JS build systems [WIP].

Navigate to your angular library containing the entry module. The entry module it the module that provides the basic structure of your application. Usually containing some sort of toolbar or menu and a <router-outlet> for the other modules. Initialize the entry module with the interactive CLI:

$ gah init --entry

If the entry module has dependencies on other modules, you have to initialize those modules now. THerfor navigate to the project folder containing the dependency. Beware that the entry module should only have dependencies to shared library modules that do not provide any routing or pages themselves, but rather have some common controls and services. You can initialize any module with the interactive init command.

$ gah init

Then in your entry module you can go ahead and add the dependency with the following interactive CLI command:

$ gah dependency add

If your setup is complete you can go back to the folder for the host and install the previously configured dependencies:

$ gah install

If everything is configured correctly, you will now be able to run the angular-cli commands for building or serving your application from the host folder.

Please note that all commands are executed for the current working directory of NodeJS. So for adding dependencies you first have to navigate to that folder and execute the script there. (Not within the script but within your terminal!)