combo_new

The project generator for Combo.

Installation

Install the archive of combo_new:

$ mix archive.install hex combo_new

Usage

combo_new provides two main Mix tasks:

• combo_new. Run mix help combo_new for more information.
• combo_new.update. Run mix help combo_new.update for more information.

The template structure

The templates are structured as follows:

lib/my_app/
├── application.ex
├── core/
├── core.ex
├── web/
└── web.ex

Design philosophy

These principles only apply to the templates in combo_new, not to your own templates.

• These templates are standalone runnable projects. Although it limits the range of requirements that a single template can support, it makes development and debugging much simpler.
• These templates only demonstrate features for building web interfaces. Other backend features, like data storage, authentication, authorization, telemetry, email sending, etc, are not demonstrated.
• These templates are designed to demonstrate the essential structure of a working project, not to encompass all possible requirements.
• These templates avoid opinionated choices. For example, since some developers like TailwindCSS while others don't, it's not included.

In this way, combo_new can focus on providing minimal, base templates, avoiding the maintenance overhead of accommodating diverse requirements.

Meanwhile, combo_new supports generating projects using remote Git repos, which allows users to tailor their own templates for their own needs, enabling the community to flourish without being too restrictive.

Creating your own templates

If you need a template to provide additional features like authentication, email sending, etc, you can copy the template from combo_new that best matches your needs, then modify it accordingly.

For example, I've created my own template:

• zekedou/combo-react-starter

If you'd like to create one as well, please read the guide of creating templates for more information.

License

MIT