bjarn / jale

Jale is a blazing fast local development environment for MacOS written in Typescript.

Jale

A blazing fast local development environment for MacOS* written in Typescript.
^{_{*soon to be cross-platform!}}

What is Jale?

Jale (Just Another Local Environment) allows you to setup a complete local development environment in just a couple of seconds. Literally the only thing you have to do is run jale install and you're done.

Walk through the installation steps, which allow you to select which PHP versions (multiple!) you'd like to run or which kind of database server (i.e. MySQL 5.6 or 8.0, but also MariaDB).

Jale is currently still under heavy development and not ready to be used as your daily driver. However, it works but lacks error messages, useful notices and yes, might contain bugs.

Services are using optimized configs (credits to Valet+) to improve the performance of your local development environment.

Why Jale?

It has a completely different approach compared to services like Laravel Valet and aims to be both flexible and performant.

Instead of using a single 'server.php' file which proxies every request, we just use Nginx configuration files per site. Don't be afraid though! We made it as easy as possible. It is also possible to select an optimized app template for i.e. Laravel, Magento or Wordpress (and more to come!).

Included services

The following services are currently installed by Jale. Services marked with a * are optional, you can uncheck them ;-).

• Nginx
• Dnsmasq
• PHP (7.1, 7.2, 7.3, 7.4 and 8.0)
• MySQL (MySQL 5.7, 8.0 and MariaDB)
• Redis*
• Elasticsearch*

Dev tools

The following development tools are included.

• Mailhog
• Expose*
• wp-cli*
• magerun*
• magerun2*
• drush*

Migrating from...?

Are you migrating from Valet or Valet+? Check out the following wiki.

jale's Issues

Add self-updater

Add a self-update command to allow the user to easily update Jale.

Maybe also show a warning if Jale is outdated?

Switching to PHP 8.0 causes it to always reinstall

Describe the bug
When executing jale use php 8.0 it always reinstalls PHP 8.0 even though it is installed. This is due to the fact Brew calls the latest PHP version 'php' and not '[email protected]'.

Add RabbitMq support

Add RabbitMq support

Project Nginx config

Currently it is possible to change the Nginx configuration in ~/.jale/sites/. However, it might be helpful to let this vhost check if there is any .jale.conf files in the project's root.

This allows Jale to have the same setup for the project for everyone who works on it. This is especially helpful when you work in themes. No additional commands required.

Add Varnish support

Consider adding Varnish support

Nginx app templates

Add Nginx templates for certain apps. For example, if you have a local Magento 2 project, you'd like to apply a Magento 2 optimized Nginx configuration to just that site. For your Laravel project however, you want a Laravel optimized Nginx config.

Add Memcached support

Add memcached support for PHP.

Add subdomain support

Add subdomain support for local sites

Add subdomain command to see all active subdomains

Add links command to see all active sites

Initial install UnhandledPromiseRejectionWarning

Describe the bug
A clear and concise description of what the bug is.
Whenever I run jale install, I get an unhandled promise rejection in the end and no configuration or logging is created.

To Reproduce
Steps to reproduce the behavior:

1. Install jale globally with "npm install -g jale"
2. Run jale install
3. Choose domain: "test", Choose php7.4, Choose mysql8.0, Choose no services, Choose no tools/apps

Expected behavior
the install should finish normally

Screenshots

Desktop (please complete the following information):

• OS: MacOS Big Sur
• Terminal: iTerm
• Shell: zsh
• Jale version: 0.2.1

Jale version-file

Feature description:

A file which can be put in a project's root, e.g. 'jale.json' which contains various settings for the project. For example; the project requires PHP 7.3 and Elasticsearch 6. We will then switch Jale to those versions with just a quick use of jale use.

Improve messages

Improve messages. Currently they are hard to read and... boring.

Add NodeJS template

Add a NodeJS Nginx template with the option to set a port.

Add support for MailHog

MailHog can be of great value in a local development environment to keep outgoing mail from accidentally reaching its destination. A destination could e.g. be the company inbox for order confirmations e-mails.

https://github.com/mailhog/MailHog

It can be easily be installed using Homebrew and configured in PHP to be used using the sendmail_path configuration.

https://formulae.brew.sh/formula/mailhog

Add Ngrok support

Add Ngrok tunneling support

Add Wordpress app template

Add a wordpress compatible Nginx template.

Add Ioncube support

Add support for the Ioncube PHP extension

Add dev tools binaries

Add support for the following dev tools:

• wp-cli
• magerun
• magerun2
• drush

Self signed SSL (secure command)

Change domain extension

Make it possible to easily change your domain (e.g. .test) after the initial installation.