The mu.semte.ch framework consists of a number of components. A number that is growing steadily and will keep growing in the future. If you’re new to the stack, it’s not always easy to find your way through it. Therefore, we introduced some naming conventions. By adhering to these naming conventions we try to facilitate the hunt for the component you’re looking for.
Roughly speaking, we distinguish between 5 types of components in the mu.semte.ch framework:
- Core components
- Ember addons
Core components – as the name reveals – are the core of the mu.semte.ch framework. Without these components, the framework cannot function correctly. Each of the core components is prefixed with ‘mu-‘. We already introduced mu-identifier and mu-delta-service. Mu-dispatcher will be explored in a future blog post.
Ember addons are the building blocks for the frontend application. Basically, it are just NPM packages you can install in your Ember app. We follow the Ember community naming convention by prefixing the package names with ’ember-‘. To indicate they are part of the mu.semte.ch stack we also add ‘mu-‘ to the name. E.g. ember-mu-login.
Utilities is the collective term of all tools that facilitate the initiation and development of a mu.semte.ch application. Since they are so diverse, they don’t follow a strict naming convention. The name just tries to cover the functionality. Nonetheless, similar utilities have a similar name. For example, all generators are postfixed with ‘-generator’.
All the components are published on GitHub where they are also added tagged so you can easily find what you’re looking for. E.g. the core components are tagged with ‘mu-project’, while the services are tagged with ‘mu-service’ etc. All the rules described above are just some simple and straightforward naming conventions, but adhering to them may drastically speed up the search process in the future.