Setup a new project
- Follow the install steps
- Delete the .git folder and run
git init, then configure repository for your custom project
- To update run
yarn updateand compile
- Breaking changes in the dependencies? Update your custom code then update the new versions in
- Need another new project ? Start again from the first step
When we must make breaking changes to the packages, we increase the minor version. Due to how dependencies are defined, composer will not update the dependencies for you in that case, that's why you need to look at the changelog, be aware of the changes, update your code and then manually update the dependencies' minor version, so that you can continue to receive updates.
When updating Enso and introducing possibly breaking changes, we might make available various Artisan commands,
meant to make the update easier.
You can see the list of currently available commands by running
php artisan enso
and remember to always consult the changelog.
When you run
compose update and the front-end assets are published/upgraded recompiling (
prod) is all you need to do.
If packages that depend on new permissions are added in the update process, you should run
php artisan:migrate to add those permissions to the database.
Localisation is supported, with several languages already available out of the box and with the option to add others.
Once a language has been made available, an application user can choose the language he wants to use in the preferences side bar. Until that choice is made, users will be using the default application locale.
Since on the authentication pages (login, password reset) the user is not currently logged in and the system would not normally have access to his preferences, the application will attempt to use the user's preferences from the browser's local storage if they were ever set, falling back to the application language otherwise.
Once the user is logged in, both the back-end and the front-end will have access to the translated values that have been added in the application.
We want to keep the compiled size down throughout the Enso ecosystem so icons are imported selectively.
What this means for you is that the necessary icons should be imported inside your components/pages. If you want to import FA icons globally (not recommended) the place to include them is:
For menus, icons should be imported in:
For languages, flag icons should be imported in:
flags.scss as a reference)
By default, Enso comes with a few templates for the email notifications used out of the box.
If you need to create other templates or change the existing ones, a good starting point is to publish
the existing templates, using the
php artisan vendor:publish --tag=enso-mail artisan command.
The blade templates will be published in the
You'll find the template layout and partials in the
core folder and sub-folders.
By default, the Mailtrap token variable is used for the unsubscribe link. You may customize the footer partial to use the desired token.
When developing an application on top of Enso, it makes sense to keep your app state data separate from the core Enso state. In order to achieve this, you need to customize just 2 files, one for each layer.
- you need a
StateBuilderimplementation class, that should be given as a value for the
- by default, the
App\Classes\LocalStateis provided as blank template
- the additional state data is returned to the front end via the same response (
/core/api) as the core Enso state data
As you may need to initialize or otherwise process the local state data received from the back-end,
resources/assets/js/localState.js holds the entry point method you can customize and add logic to.
Here you'll have access to the Vuex
context object and your local
state data, received from the back-end.